跳到主要内容OpenClaw 接入飞书实战:让 AI 机器人读写文档与表格 | 极客日志编程语言Node.jsAI
OpenClaw 接入飞书实战:让 AI 机器人读写文档与表格
OpenClaw 接入飞书实战方案,通过创建企业自建应用、批量导入权限、安装服务器插件及配置事件回调,实现 AI 机器人对飞书文档、表格及日程的自动化操作。教程详解群聊使用与私聊配对流程,帮助开发者快速打通 AI 与工作台的连接,提升办公效率。
今天,我们把 OpenClaw 接入飞书。相比 Telegram 仅能聊天,飞书集成能让 AI 直接读文档、写文档、操作表格和管理日程。
配置过程分为四个阶段:创建应用、安装插件、配置长连接、加入群聊与配对。虽然步骤稍多,但跟着操作即可。
第一阶段:在飞书上创建机器人
创建应用
打开飞书开放平台,点击创建企业自建应用。填写应用名称、描述和图标后提交。

添加机器人能力
进入配置页面,找到「添加应用能力」中的机器人模块并启用。这表示该应用具备在聊天中交互的能力。

批量导入权限
权限决定了机器人的操作范围。点击左侧权限管理,选择批量导入导出权限。
删除默认内容,粘贴以下配置:
{"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.send_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 和 App Secret。这是后续配置的密钥。
⚠️ 安全提示:App Secret 相当于密码,切勿公开泄露。
第二阶段:在服务器上安装插件
SSH 登录服务器,依次执行以下命令切换源、下载并安装插件包:
npm config set registry https://registry.npmjs.org
curl -o /tmp/feishu-openclaw-plugin-onboard-cli.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/4d184b1ba733bae2423a89e196a2ef8f_QATOjKH1WN.tgz
npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g
rm /tmp/feishu-openclaw-plugin-onboard-cli.tgz
feishu-plugin-onboard install
若提示删除已安装的 MCP,输入 Y 确认。接着按提示粘贴刚才记录的 App ID 和 App Secret。
看到 Installation finished 即表示成功。最后重启网关服务:
第三阶段:配置长连接
为避免机器人掉线,需配置事件回调。回到飞书开放平台,进入事件与回调 → 事件配置。
💡 说明:此步骤确保机器人能实时收到用户消息,否则无法响应。
第四阶段:正式上岗
群聊使用
在飞书群聊中点击群机器人,选择添加机器人,选中刚才创建的应用。
添加成功后,在群里 @机器人 测试回复。无需额外配对,直接可用。
私聊配对
如需一对一私聊,双击机器人头像发起对话。机器人会返回一个配对码。
openclaw pairing approve feishu <配对码>--notify
将 <配对码> 替换为实际收到的代码。看到授权成功提示后,私聊通道即打通。
现在,你可以尝试让机器人帮你预约会议或处理文档。AI 不再是隔着门喊话的助手,而是真正坐进工作台的同事。从 Telegram 到飞书,OpenClaw 的能力边界又拓展了一步。
相关免费在线工具
- RSA密钥对生成器
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
- Mermaid 预览与可视化编辑
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
- Base64 字符串编码/解码
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
- Base64 文件转换器
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
- Markdown转HTML
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
- HTML转Markdown
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online