Codepilot 接入飞书指南
CodePilot 是一款功能强大的 Claude 第三方客户端,近期上线的飞书桥接功能,实现了 Claude 能力与飞书生态的深度打通。完成接入配置后,你可以直接在飞书内使用 Claude 完成以下场景的工作:
-
无需切换客户端,在飞书聊天窗口直接与 Claude 对话咨询问题
-
直接读取、总结飞书文档/多维表/电子表格的内容,高效处理办公文档
-
自动回复飞书消息、管理日程、处理待办任务,提升办公效率
-
基于飞书生态定制专属工作流,实现复杂办公场景的自动化处理
本指南将详细介绍 CodePilot 接入飞书的完整配置步骤,全程操作约10分钟即可完成。
一、前期准备
二、接入步骤
-
创建企业自建应用
-
登陆开发者后台:开发者后台 - 飞书开放平台,创建企业自建应用
-
在弹出的创建窗口中,填写以下信息:
| 配置项 | 填写内容(后续都可以随意修改) | 说明 |
|---|---|---|
| 应用名称 | (内容随便写) | 自定义名称 |
| 应用描述 | (内容随便写) | 简单描述用途 |
| 应用图标 | 可以暂时不传 |
-
填写完成后,点击 “创建” 按钮
-
应用创建成功后,会自动跳转到应用详情页
-
添加应用能力
-
在能力列表中,找到 “机器人” 能力卡片,点击卡片上的 “添加” 按钮
-
批量导入应用权限(最关键步骤)
这是最容易出错的步骤,必须严格按要求操作!
- 在应用详情页左侧目录树,找到 权限管理 > 批量导入 / 导出权限
- 在弹出的窗口中,默认是 “导入” 页签,清空输入框内的所有内容,将下方代码块内容完整复制进来,点击 “确定新增权限” 完成权限导入
{
"scopes": {
"tenant": [
"contact:contact.base:readonly",
"docx:document:readonly",
"im:chat:read",
"im:chat:update",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"application:application:self_manage",
"cardkit:card:write",
"cardkit:card:read"
],
"user": [
"contact:user.employee_id:readonly",
"offline_access","base:app:copy",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:record:create",
"base:record:delete",
"base:record:retrieve",
"base:record:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"base:app:create",
"base:app:update",
"base:app:read",
"board:whiteboard:node:create",
"board:whiteboard:node:read",
"calendar:calendar:read",
"calendar:calendar.event:create",
"calendar:calendar.event:delete",
"calendar:calendar.event:read",
"calendar:calendar.event:reply",
"calendar:calendar.event:update",
"calendar:calendar.free_busy:read",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user:search",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.media:download",
"docs:document:copy",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:file:download",
"drive:file:upload",
"im:chat.members:read",
"im:chat:read",
"im:message",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user",
"im:message:readonly",
"search:docs:read",
"search:message",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"task:comment:read",
"task:comment:write",
"task:task:read",
"task:task:write",
"task:task:writeonly",
"task:tasklist:read",
"task:tasklist:write",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only"
]
}
}
-
等待几秒钟,页面会显示权限已添加
-
获取应用凭证(⚠️ 请对自己的这两个信息严格保密!)
-
在应用详情页左侧目录,找到 “凭证与基础信息”,点击进入
-
在页面中,您会看到以下两项重要信息,请务必完整复制并妥善保存:
| 凭证名称 | 格式说明 | 用途 |
|---|---|---|
| App ID | 格式如 cli_xxxxxxxxxxxx |
飞书应用唯一标识 |
| App Secret | 一串长字符串 | 应用安全密钥,不可泄露 |
5.配置 CodePilot 桥接
- 安装CodePilot
https://github.com/op7418/CodePilot
- 设置-桥接-飞书设置
将第四步获取 App ID 和 App Secret 粘贴进来保存
- 设置-桥接-远程桥接
6.订阅事件与发布应用
订阅机器人长链接 接收事件和卡片****回调
这一步的作用是让 OpenClaw 具有在飞书内收发消息的能力
-
进入飞书开放平台,找到刚刚创建的应用,配置“事件与回调”
-
进入 事件配置 > 订阅方式 > 使用 长链接 接受事件 > 保存
- 添加“接收消息”事件
- 进行“回调配置”
进入“回调配置”,搜索并添加“卡片回传交互”,点击“确认添加”
- 发布应用
应用必须发布后,才能在飞书中使用!
- 点击上方“创建版本”
-
在弹出的窗口中:
-
填写版本号(如:
1.0.0) -
填写版本描述(如:首次发布,集成 OpenClaw)
-
-
点击 “确定” 创建版本
-
创建成功后,点击版本右侧的 “发布” 按钮
-
等待管理员审批即可
-
与飞书完成配对
在飞书里找到你刚创建的机器人
“开发者小助手”会将审批通过的应用推送到你的消息界面,点击“打开应用”
聊天测试
三、常见问题
Q1:批量导入权限时提示报错怎么办?
A:首先检查复制的权限JSON是否完整,不要遗漏括号或逗号;如果确认JSON格式正确,可以尝试清空输入框后重新粘贴,或分开多次导入部分权限;如果仍然失败,可以手动在权限管理页中逐个添加需要的权限。
Q2:发布应用时需要企业管理员审批怎么办?
A:如果是个人使用,你可以创建个人专属飞书企业(免费),在个人企业中创建应用不需要额外审批;如果是在企业内部使用,需要联系企业管理员提交审批申请,说明应用用途即可。
Q3:配置完成后给机器人发消息没有回复怎么办?
A:请按以下顺序排查:
-
确认应用已经完成发布并审批通过
-
检查CodePilot中的飞书App ID和App Secret是否填写正确
-
确认事件订阅已经配置了长链接模式,且添加了“接收消息”和“卡片回传交互”事件
-
检查CodePilot的远程桥接功能是否已经开启
Q4:App Secret泄露了怎么办?
A:请立即前往飞书开放平台的「凭证与基础信息」页面,点击App Secret右侧的「重置」按钮生成新的密钥,然后更新CodePilot中的配置即可,原有密钥会立即失效。
Q5:调用飞书相关功能时提示“无权限操作”怎么办?
A:首先确认你已经在权限管理中添加了对应功能的权限;如果已经添加,需要重新发布版本并通过审批,新添加的权限才会生效。
四、相关资源
- CodePilot 官方GitHub仓库:获取最新版本、提交Issue、查看更多使用教程
- 742112.xyz:大强远程技术支持

浙公网安备 33010602011771号