当前位置: 首页 > news >正文

Codepilot 接入飞书指南

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

  • 无需切换客户端,在飞书聊天窗口直接与 Claude 对话咨询问题

  • 直接读取、总结飞书文档/多维表/电子表格的内容,高效处理办公文档

  • 自动回复飞书消息、管理日程、处理待办任务,提升办公效率

  • 基于飞书生态定制专属工作流,实现复杂办公场景的自动化处理

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

一、前期准备

  • 已经安装Claude:参考教程

  • 已安装CodePilot:最新安装包下载

  • 有飞书账号:飞书官网

二、接入步骤

  1. 创建企业自建应用

  2. 登陆开发者后台:开发者后台 - 飞书开放平台,创建企业自建应用

  3. 在弹出的创建窗口中,填写以下信息:

配置项 填写内容(后续都可以随意修改) 说明
应用名称 (内容随便写) 自定义名称
应用描述 (内容随便写) 简单描述用途
应用图标 可以暂时不传
  1. 填写完成后,点击 “创建” 按钮

  2. 应用创建成功后,会自动跳转到应用详情页

  3. 添加应用能力

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

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

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

  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"]}
}

  1. 等待几秒钟,页面会显示权限已添加

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

  3. 在应用详情页左侧目录,找到 “凭证与基础信息”,点击进入

  4. 在页面中,您会看到以下两项重要信息,请务必完整复制并妥善保存:

凭证名称 格式说明 用途
App ID 格式如 cli_xxxxxxxxxxxx 飞书应用唯一标识
App Secret 一串长字符串 应用安全密钥,不可泄露

5.配置 CodePilot 桥接

  1. 安装CodePilot

https://github.com/op7418/CodePilot

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

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

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

6.订阅事件与发布应用

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

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

  1. 进入飞书开放平台,找到刚刚创建的应用,配置“事件与回调

  2. 进入 事件配置 > 订阅方式 > 使用 长链接 接受事件 > 保存

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

  1. 进行回调配置”

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

  1. 发布应用

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

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

  1. 在弹出的窗口中:

    1. 填写版本号(如:1.0.0

    2. 填写版本描述(如:首次发布,集成 OpenClaw)

  2. 点击 “确定” 创建版本

  3. 创建成功后,点击版本右侧的 “发布” 按钮

  4. 等待管理员审批即可

  5. 与飞书完成配对

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

“开发者小助手”会将审批通过的应用推送到你的消息界面,点击“打开应用”

聊天测试

三、常见问题

Q1:批量导入权限时提示报错怎么办?

A:首先检查复制的权限JSON是否完整,不要遗漏括号或逗号;如果确认JSON格式正确,可以尝试清空输入框后重新粘贴,或分开多次导入部分权限;如果仍然失败,可以手动在权限管理页中逐个添加需要的权限。

Q2:发布应用时需要企业管理员审批怎么办?

A:如果是个人使用,你可以创建个人专属飞书企业(免费),在个人企业中创建应用不需要额外审批;如果是在企业内部使用,需要联系企业管理员提交审批申请,说明应用用途即可。

Q3:配置完成后给机器人发消息没有回复怎么办?

A:请按以下顺序排查:

  1. 确认应用已经完成发布并审批通过

  2. 检查CodePilot中的飞书App ID和App Secret是否填写正确

  3. 确认事件订阅已经配置了长链接模式,且添加了“接收消息”和“卡片回传交互”事件

  4. 检查CodePilot的远程桥接功能是否已经开启

Q4:App Secret泄露了怎么办?

A:请立即前往飞书开放平台的「凭证与基础信息」页面,点击App Secret右侧的「重置」按钮生成新的密钥,然后更新CodePilot中的配置即可,原有密钥会立即失效。

Q5:调用飞书相关功能时提示“无权限操作”怎么办?

A:首先确认你已经在权限管理中添加了对应功能的权限;如果已经添加,需要重新发布版本并通过审批,新添加的权限才会生效。

四、相关资源

  • CodePilot 官方GitHub仓库:获取最新版本、提交Issue、查看更多使用教程
http://www.jsqmd.com/news/444491/

相关文章:

  • docker突然无法启动
  • 【工具推荐】DiskGenius官网下载:硬盘分区+数据恢复神器,一键拯救误删文件 - xiema
  • 深入解析:OpenEBS — 云原生 CNS 高性能存储
  • 北京酒水回收哪家靠谱?避坑+高价变现,选对本地老牌更安心 - 宁夏壹山网络
  • C语言:2026.3.6(文件)
  • 北京万腾老酒回收丨专业老酒、名酒、礼品全品类回收 - 宁夏壹山网络
  • 2026年广州示波器探头高压放大器标杆厂家最新推荐:示波器差分探头、示波器电流探头、差分探头、电流探头、交直流示波器电流探头、交直流电流探头、广州德肯电子国产测量仪器新标杆 - 海棠依旧大
  • 20260305紫题训练总结 - Link
  • P7516 [省选联考 2021 A/B 卷] 图函数 - Link
  • LeetCode经典算法面试题 #104:二叉树的最大深度(深度优先搜索、广度优先搜索等多种实现方案详细解析) - 教程
  • 2026雅思托福线上vs线下机构深度对比:多次元成首选标杆 - 速递信息
  • 中国到东南亚SD-WAN网络服务选型指南:企业东南亚出海组网优选方案 - 速递信息
  • 11.盛最多水的容器
  • 新托福时代的选择智慧:如何精准避坑,锁定高效提分机构? - 速递信息
  • 2026年数据线工厂行业趋势报告:三大核心力量重塑未来 - 速递信息
  • 位置编码(Positional Encoding)
  • 二分算法2-二分答案
  • 分治算法——求逆序对
  • word文档生成技术实现
  • C++游戏开发之旅 25
  • 使用vLLM部署Qwen/Qwen3.5-35B-A3B-FP8并且在DIFY中调用
  • ElasticSearch常见问题和注意事项
  • 一文搞懂LockSupport原理
  • Windows 安装 OpenClaw 踩坑全记录:Node、Git、CMake、VS Build Tools 一次解决
  • Flutter 三方库 preact_signals 的鸿蒙化适配指南 - 掌控极致信号响应、Signals 架构实战、鸿蒙级精密状态指控专家
  • 别只盯着模型参数了:聊聊多模态时代最容易被忽视的一件事——训练数据准备
  • 看懂“单词规律”的算法之美:为什么简单的模式匹配,其实很深
  • RAG 入门-LangChain 读取图片数据
  • 春节单位发的永辉超市卡如何回收? - 京顺回收