989 字
5 分钟
CodePilot接入飞书指南
AIHacks
2026-03-07
0 次
0 人

CodePilot 是一款功能强大的 Claude 第三方客户端,近期上线的飞书桥接功能,实现了 Claude 能力与飞书生态的深度打通。完成接入配置后,你可以直接在飞书内使用 Claude 完成以下场景的工作:

  • 无需切换客户端,在飞书聊天窗口直接与 Claude 对话咨询问题
  • 直接读取、总结飞书文档/多维表/电子表格的内容,高效处理办公文档
  • 自动回复飞书消息、管理日程、处理待办任务,提升办公效率
  • 基于飞书生态定制专属工作流,实现复杂办公场景的自动化处理

本指南将详细介绍 CodePilot 接入飞书的完整配置步骤,全程操作约10分钟即可完成。

一、前期准备#

二、接入步骤#

1.创建企业自建应用#

  1. 登陆开发者后台:开发者后台 - 飞书开放平台,创建企业自建应用
  2. 在弹出的创建窗口中,填写以下信息:
配置项填写内容(后续都可以随意修改)说明
应用名称(内容随便写)自定义名称
应用描述(内容随便写)简单描述用途
应用图标可以暂时不传
  1. 填写完成后,点击 “创建” 按钮
  2. 应用创建成功后,会自动跳转到应用详情页

2.添加应用能力#

  1. 在能力列表中,找到 “机器人” 能力卡片,点击卡片上的 “添加” 按钮

3.批量导入应用权限(最关键步骤)#

这是最容易出错的步骤,必须严格按要求操作!

  1. 在应用详情页左侧目录树,找到 权限管理 > 批量导入 / 导出权限

  1. 在弹出的窗口中,默认是 “导入” 页签,清空输入框内的所有内容,将下方代码块内容完整复制进来,点击 “确定新增权限” 完成权限导入
{
"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"
]
}
}

4.获取应用凭证(⚠️ 请对自己的这两个信息严格保密!)#

  1. 在应用详情页左侧目录,找到 “凭证与基础信息”,点击进入
  2. 在页面中,您会看到以下两项重要信息,请务必完整复制并妥善保存:
凭证名称格式说明用途
App ID格式如 cli_xxxxxxxxxxxx飞书应用唯一标识
App Secret一串长字符串应用安全密钥,不可泄露

5.配置 CodePilot 桥接#

  1. 设置-桥接-飞书设置

将第四步获取 App ID 和 App Secret 粘贴进来保存

  1. 设置-桥接-远程桥接

6.订阅事件与发布应用#

订阅机器人长链接 接收事件和卡片****回调

这一步的作用是让 CodePilot 具有在飞书内收发消息的能力

  1. 进入飞书开放平台,找到刚刚创建的应用,配置事件与回调
  2. 进入 事件配置 > 订阅方式 > 使用 长链接 接受事件 > 保存

  1. 添加**“接收消息”**事件

  1. 进行回调配置

进入“回调配置”,搜索并添加”卡片回传交互”,点击“确认添加

  1. 发布应用

应用必须发布后,才能在飞书中使用!

  1. 点击上方**“创建版本”**

7. 与飞书完成配对#

在飞书里找到你刚创建的机器人

三、相关资源#

Happy:给Claude一双翅膀

https://github.com/xvirobotics/metabot

这篇文章是否对你有帮助?

发现错误或想要改进这篇文章?

在 GitHub 上编辑此页