将openclaw接入飞书：10分钟，让你的AI员工直接操作你的文档和表格！

上一篇，我们给小龙虾接了 Telegram，实现了手机遥控。

但说实话，Telegram 只解决了"能聊天"的问题。你跟小龙虾说"帮我写个文档"，它写完了------然后呢？你还得自己复制粘贴到你的编辑器中。

这就像请了个助手，他只能站在门外隔着门跟你喊话，但不能进屋帮你干活。

今天这篇，我们把门打开。让小龙虾直接进入你的飞书------读文档、写文档、操作表格、管理日程，全部自己来。

先看效果👇

飞书的配置比 Telegram 多一些步骤，但别慌------跟着我走，每一步都有截图，大概10分钟搞定。

飞书的接入分四个阶段，先有个全局概念，不容易迷路：

在飞书上造一个机器人 --- 相当于给小龙虾办一张飞书工牌
在服务器上装飞书插件 --- 让小龙虾学会"说飞书的语言"
配置长连接 --- 让机器人保持在线，不会聊着聊着断了
加入群聊 & 配对 --- 正式上岗

看着多，其实每个阶段都是点点点的事。开干。

第一阶段：在飞书上造一个机器人

创建应用

打开飞书开放平台：open.feishu.cn/app ，点击创建企业自建应用。

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

给机器人开能力

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

这一步是告诉飞书："这个应用是个机器人，能在聊天里跟人说话。"

批量导入权限（关键步骤）

接下来要给机器人开权限。这步很重要------权限决定了小龙虾能在飞书里干什么。

点击左侧的权限管理 ，再点批量导入导出权限按钮。

把弹窗里的默认内容删掉，粘贴下面这段配置：

json 复制代码

{
  "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 连上你的服务器，依次执行下面这四条命令：

bash 复制代码

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 源 → 下载飞书官方插件包 → 全局安装 → 清理安装包。复制粘贴就好，不需要理解每一行。

然后执行安装命令：

bash 复制代码

feishu-plugin-onboard install

如果提示要删除已安装的飞书 MCP，直接输入大写的 Y 回车。

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

看到 Installation finished 就说明安装成功了。

💡 后面可能会跟一个"检查失败"的提示，不用管它，不影响使用。实在不放心可以跑一下：
bash 复制代码
openclaw plugins list
看到 feishu-openclaw-plugin 的 Status 是 loaded 就稳了。

最后重启 gateway：

bash 复制代码

openclaw gateway restart

服务器端搞定。做到这里，你已经完成了80%。

第三阶段：配置长连接（保持在线）

这一步解决一个问题：让机器人一直在线，不会聊着聊着突然没反应。

回到飞书开放平台，找到左侧导航的事件与回调 → 事件配置。

点击订阅方式右边的小铅笔图标。

选择长连接方式。

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

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

💡 为什么要加这个事件？ 不加的话，机器人收不到你发的消息。这就像你给了助手一个工位，但没告诉前台"有人找他要转达"。

加完事件后，还需要再创建一个新版本让配置生效。点顶部的创建版本，流程和之前一样------填版本号、保存、申请发布、自己审批通过。

第四阶段：让机器人正式上岗

群聊使用

找到你想让小龙虾加入的飞书群，点击群机器人。

点添加机器人。

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

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

收到回复了？恭喜，群聊搞定。群里直接 @就能用，不需要额外配对。

私聊配对

但如果你想跟小龙虾一对一私聊，还需要配对一下。

双击机器人头像进入私聊，发条消息。小龙虾会回你一个配对码。

回到服务器，执行：

bash 复制代码

openclaw pairing approve feishu <配对码> --notify

把 <配对码> 换成你收到的那个。

看到授权成功的提示，私聊通道也打通了。

现在，回到飞书，让小龙虾帮你约个会议试试。

它不再是隔着门喊话的助手了。它能直接坐到你的飞书工位上，帮你写文档、读资料、操作表格、管理任务。

截个图发到群里吧："我的AI助手，现在能直接操作我的飞书了。"

从 Telegram 的"能聊天"，到飞书的"能干活"，小龙虾的能力边界又往外推了一大步。

AI不是装上就有用的，得让它够得着你的工作台。

你最希望小龙虾在飞书里帮你自动化哪件事？写周报？整理会议纪要？还是自动填表？评论区聊聊👇