将openclaw接入飞书:10分钟,让你的AI员工直接操作你的文档和表格!
上一篇,我们给小龙虾接了 Telegram,实现了手机遥控。
但说实话,Telegram 只解决了"能聊天"的问题。你跟小龙虾说"帮我写个文档",它写完了——然后呢?你还得自己复制粘贴到你的编辑器中。
这就像请了个助手,他只能站在门外隔着门跟你喊话,但不能进屋帮你干活。
今天这篇,我们把门打开。让小龙虾直接进入你的飞书——读文档、写文档、操作表格、管理日程,全部自己来。
先看效果👇

飞书的配置比 Telegram 多一些步骤,但别慌——跟着我走,每一步都有截图,大概10分钟搞定。
飞书的接入分四个阶段,先有个全局概念,不容易迷路:
- 在飞书上造一个机器人 — 相当于给小龙虾办一张飞书工牌
- 在服务器上装飞书插件 — 让小龙虾学会"说飞书的语言"
- 配置长连接 — 让机器人保持在线,不会聊着聊着断了
- 加入群聊 & 配对 — 正式上岗
看着多,其实每个阶段都是点点点的事。开干。
第一阶段:在飞书上造一个机器人
创建应用
打开飞书开放平台:https://open.feishu.cn/app ,点击创建企业自建应用。

填一下应用名称、描述、图标。名字随便起,之后能改,别纠结。点创建。

给机器人开能力
创建完会跳到配置页面。找到「添加应用能力」里的机器人模块,点添加。

这一步是告诉飞书:“这个应用是个机器人,能在聊天里跟人说话。”
批量导入权限(关键步骤)
接下来要给机器人开权限。这步很重要——权限决定了小龙虾能在飞书里干什么。
点击左侧的权限管理,再点批量导入导出权限按钮。

把弹窗里的默认内容删掉,粘贴下面这段配置:
{"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 npminstall /tmp/feishu-openclaw-plugin-onboard-cli.tgz -grm /tmp/feishu-openclaw-plugin-onboard-cli.tgz 💡 这四条干了什么? 切换 npm 源 → 下载飞书官方插件包 → 全局安装 → 清理安装包。复制粘贴就好,不需要理解每一行。
然后执行安装命令:
feishu-plugin-onboard install如果提示要删除已安装的飞书 MCP,直接输入大写的 Y 回车。

接着会让你输入 App ID 和 App Secret,就是刚才让你记录的那两个。依次粘贴进去。

看到 Installation finished 就说明安装成功了。
💡 后面可能会跟一个"检查失败"的提示,不用管它,不影响使用。实在不放心可以跑一下:
看到feishu-openclaw-plugin的 Status 是loaded就稳了。
最后重启 gateway:
openclaw gateway restart 服务器端搞定。做到这里,你已经完成了80%。
第三阶段:配置长连接(保持在线)
这一步解决一个问题:让机器人一直在线,不会聊着聊着突然没反应。
回到飞书开放平台,找到左侧导航的事件与回调 → 事件配置。
点击订阅方式右边的小铅笔图标。

选择长连接方式。

然后点右侧的添加事件按钮。

在弹窗中搜索"接收消息",勾选搜出来的结果,点确认添加。

💡 为什么要加这个事件? 不加的话,机器人收不到你发的消息。这就像你给了助手一个工位,但没告诉前台"有人找他要转达"。
加完事件后,还需要再创建一个新版本让配置生效。点顶部的创建版本,流程和之前一样——填版本号、保存、申请发布、自己审批通过。

第四阶段:让机器人正式上岗
群聊使用
找到你想让小龙虾加入的飞书群,点击群机器人。

点添加机器人。

选你刚创建的那个,点添加。

现在在群里 @你的机器人,随便说句话试试。

收到回复了?恭喜,群聊搞定。群里直接 @就能用,不需要额外配对。
私聊配对
但如果你想跟小龙虾一对一私聊,还需要配对一下。
双击机器人头像进入私聊,发条消息。小龙虾会回你一个配对码。

回到服务器,执行:
openclaw pairing approve feishu <配对码>--notify把 <配对码> 换成你收到的那个。

看到授权成功的提示,私聊通道也打通了。
现在,回到飞书,让小龙虾帮你约个会议试试。

它不再是隔着门喊话的助手了。它能直接坐到你的飞书工位上,帮你写文档、读资料、操作表格、管理任务。
截个图发到群里吧:“我的AI助手,现在能直接操作我的飞书了。”
从 Telegram 的"能聊天",到飞书的"能干活",小龙虾的能力边界又往外推了一大步。
AI不是装上就有用的,得让它够得着你的工作台。
你最希望小龙虾在飞书里帮你自动化哪件事?写周报?整理会议纪要?还是自动填表?评论区聊聊👇# 将openclaw接入飞书:10分钟,让你的AI员工直接操作你的文档和表格!
上一篇,我们给小龙虾接了 Telegram,实现了手机遥控。
但说实话,Telegram 只解决了"能聊天"的问题。你跟小龙虾说"帮我写个文档",它写完了——然后呢?你还得自己复制粘贴到你的编辑器中。
这就像请了个助手,他只能站在门外隔着门跟你喊话,但不能进屋帮你干活。
今天这篇,我们把门打开。让小龙虾直接进入你的飞书——读文档、写文档、操作表格、管理日程,全部自己来。
先看效果👇

飞书的配置比 Telegram 多一些步骤,但别慌——跟着我走,每一步都有截图,大概10分钟搞定。
飞书的接入分四个阶段,先有个全局概念,不容易迷路:
- 在飞书上造一个机器人 — 相当于给小龙虾办一张飞书工牌
- 在服务器上装飞书插件 — 让小龙虾学会"说飞书的语言"
- 配置长连接 — 让机器人保持在线,不会聊着聊着断了
- 加入群聊 & 配对 — 正式上岗
看着多,其实每个阶段都是点点点的事。开干。
第一阶段:在飞书上造一个机器人
创建应用
打开飞书开放平台:https://open.feishu.cn/app ,点击创建企业自建应用。

填一下应用名称、描述、图标。名字随便起,之后能改,别纠结。点创建。

给机器人开能力
创建完会跳到配置页面。找到「添加应用能力」里的机器人模块,点添加。

这一步是告诉飞书:“这个应用是个机器人,能在聊天里跟人说话。”
批量导入权限(关键步骤)
接下来要给机器人开权限。这步很重要——权限决定了小龙虾能在飞书里干什么。
点击左侧的权限管理,再点批量导入导出权限按钮。

把弹窗里的默认内容删掉,粘贴下面这段配置:
{"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 npminstall /tmp/feishu-openclaw-plugin-onboard-cli.tgz -grm /tmp/feishu-openclaw-plugin-onboard-cli.tgz 💡 这四条干了什么? 切换 npm 源 → 下载飞书官方插件包 → 全局安装 → 清理安装包。复制粘贴就好,不需要理解每一行。
然后执行安装命令:
feishu-plugin-onboard install如果提示要删除已安装的飞书 MCP,直接输入大写的 Y 回车。

接着会让你输入 App ID 和 App Secret,就是刚才让你记录的那两个。依次粘贴进去。

看到 Installation finished 就说明安装成功了。
💡 后面可能会跟一个"检查失败"的提示,不用管它,不影响使用。实在不放心可以跑一下:
看到feishu-openclaw-plugin的 Status 是loaded就稳了。
最后重启 gateway:
openclaw gateway restart 服务器端搞定。做到这里,你已经完成了80%。
第三阶段:配置长连接(保持在线)
这一步解决一个问题:让机器人一直在线,不会聊着聊着突然没反应。
回到飞书开放平台,找到左侧导航的事件与回调 → 事件配置。
点击订阅方式右边的小铅笔图标。

选择长连接方式。

然后点右侧的添加事件按钮。

在弹窗中搜索"接收消息",勾选搜出来的结果,点确认添加。

💡 为什么要加这个事件? 不加的话,机器人收不到你发的消息。这就像你给了助手一个工位,但没告诉前台"有人找他要转达"。
加完事件后,还需要再创建一个新版本让配置生效。点顶部的创建版本,流程和之前一样——填版本号、保存、申请发布、自己审批通过。

第四阶段:让机器人正式上岗
群聊使用
找到你想让小龙虾加入的飞书群,点击群机器人。

点添加机器人。

选你刚创建的那个,点添加。

现在在群里 @你的机器人,随便说句话试试。

收到回复了?恭喜,群聊搞定。群里直接 @就能用,不需要额外配对。
私聊配对
但如果你想跟小龙虾一对一私聊,还需要配对一下。
双击机器人头像进入私聊,发条消息。小龙虾会回你一个配对码。

回到服务器,执行:
openclaw pairing approve feishu <配对码>--notify把 <配对码> 换成你收到的那个。

看到授权成功的提示,私聊通道也打通了。
现在,回到飞书,让小龙虾帮你约个会议试试。

它不再是隔着门喊话的助手了。它能直接坐到你的飞书工位上,帮你写文档、读资料、操作表格、管理任务。
截个图发到群里吧:“我的AI助手,现在能直接操作我的飞书了。”
从 Telegram 的"能聊天",到飞书的"能干活",小龙虾的能力边界又往外推了一大步。
AI不是装上就有用的,得让它够得着你的工作台。
你最希望小龙虾在飞书里帮你自动化哪件事?写周报?整理会议纪要?还是自动填表?评论区聊聊👇