Shell / BashNode.jsAI
OpenClaw 接入飞书：机器人配置与文档表格操作指南
OpenClaw 接入飞书教程涵盖应用创建、权限配置、插件安装及长连接设置。通过飞书开放平台建立机器人，获取 App ID 与 Secret，在服务器端使用 npm 命令部署插件。配置事件回调确保在线状态，并在群聊或私聊中完成配对。最终实现 AI 自动读写文档、管理日程及处理任务功能。
OpenClaw 接入飞书教程涵盖应用创建、权限配置、插件安装及长连接设置。通过飞书开放平台建立机器人，获取 App ID 与 Secret，在服务器端使用 npm 命令部署插件。配置事件回调确保在线状态，并在群聊或私聊中完成配对。最终实现 AI 自动读写文档、管理日程及处理任务功能。
上一篇，我们给 OpenClaw 接了 Telegram，实现了手机遥控。
但说实话，Telegram 只解决了'能聊天'的问题。你跟 OpenClaw 说'帮我写个文档'，它写完了——然后呢？你还得自己复制粘贴到你的编辑器中。
这就像请了个助手，他只能站在门外隔着门跟你喊话，但不能进屋帮你干活。
今天这篇，我们把门打开。让 OpenClaw 直接进入你的飞书——读文档、写文档、操作表格、管理日程，全部自己来。
先看效果👇
飞书的配置比 Telegram 多一些步骤，但别慌——跟着我走，每一步都有截图，大概 10 分钟搞定。
飞书的接入分四个阶段，先有个全局概念，不容易迷路：
看着多，其实每个阶段都是点点点的事。开干。
打开飞书开放平台：https://open.feishu.cn/app，点击创建企业自建应用。
填一下应用名称、描述、图标。名字随便起，之后能改，别纠结。点创建。
创建完会跳到配置页面。找到「添加应用能力」里的机器人模块，点添加。
这一步是告诉飞书：'这个应用是个机器人，能在聊天里跟人说话。'
接下来要给机器人开权限。这步很重要——权限决定了 OpenClaw 能在飞书里干什么。
点击左侧的权限管理，再点批量导入导出权限按钮。
把弹窗里的默认内容删掉，粘贴下面这段配置：
{"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"
💡 这段配置干了什么？ 简单说，它让 OpenClaw 拥有了操作飞书文档、表格、日历、任务、知识库等几乎所有功能的权限。你不需要逐个理解每一条，直接全部粘贴就行。想详细了解的，可以看飞书的 权限说明文档。
点击「下一步，确认新增权限」。
弹出数据范围确认窗口，直接点确定。
权限配好了，接下来让这个机器人正式'入职'。
点击页面顶部的创建版本按钮。
填一下版本号和更新说明，随便写就行。
拉到底部点保存。
弹窗里点申请线上发布。
这时候你的飞书会收到开发小助手发来的审批通知。点消息里的「进入管理后台审核」。
找到你刚创建的机器人，点审核。
点通过。
⚠️ 踩坑预警：这里是自己审批自己，别觉得奇怪。因为你既是开发者又是管理员，所以自己创建自己批。直接通过就好。
审核通过后，回到机器人配置页面，找到左侧导航的基础信息 → 凭证与基础信息。
记录下 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
💡 这四条干了什么？ 切换 npm 源 → 下载飞书官方插件包 → 全局安装 → 清理安装包。复制粘贴就好，不需要理解每一行。
然后执行安装命令：
feishu-plugin-onboard install
如果提示要删除已安装的飞书 MCP，直接输入大写的 Y 回车。
接着会让你输入 App ID 和 App Secret，就是刚才让你记录的那两个。依次粘贴进去。
看到 Installation finished 就说明安装成功了。
💡 后面可能会跟一个'检查失败'的提示，不用管它，不影响使用。实在不放心可以跑一下：
看到
feishu-openclaw-plugin的 Status 是loaded就稳了。
最后重启 gateway：
openclaw gateway restart
服务器端搞定。做到这里，你已经完成了 80%。
这一步解决一个问题：让机器人一直在线，不会聊着聊着突然没反应。
回到飞书开放平台，找到左侧导航的事件与回调 → 事件配置。
点击订阅方式右边的小铅笔图标。
选择长连接方式。
然后点右侧的添加事件按钮。
在弹窗中搜索'接收消息'，勾选搜出来的结果，点确认添加。
💡 为什么要加这个事件？ 不加的话，机器人收不到你发的消息。这就像你给了助手一个工位，但没告诉前台'有人找他要转达'。
加完事件后，还需要再创建一个新版本让配置生效。点顶部的创建版本，流程和之前一样——填版本号、保存、申请发布、自己审批通过。
找到你想让 OpenClaw 加入的飞书群，点击群机器人。
点添加机器人。
选你刚创建的那个，点添加。
现在在群里 @你的机器人，随便说句话试试。
收到回复了？恭喜，群聊搞定。群里直接 @就能用，不需要额外配对。
但如果你想跟 OpenClaw 一对一私聊，还需要配对一下。
双击机器人头像进入私聊，发条消息。OpenClaw 会回你一个配对码。
回到服务器，执行：
openclaw pairing approve feishu <配对码>--notify
把 <配对码> 换成你收到的那个。
看到授权成功的提示，私聊通道也打通了。
现在，回到飞书，让 OpenClaw 帮你约个会议试试。
它不再是隔着门喊话的助手了。它能直接坐到你的飞书工位上，帮你写文档、读资料、操作表格、管理任务。
从 Telegram 的'能聊天'，到飞书的'能干活'，OpenClaw 的能力边界又往外推了一大步。
AI 不是装上就有用的，得让它够得着你的工作台。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online