把 AI助手搬进飞书！OpenClaw接入完整指南

摘要：还在为每次跟 AI 对话都要翻墙开代理而烦恼？Out！今天就教你把 OpenClaw AI助手直接接入飞书，不用切换窗口、不用翻墙、不用公网 IP，在公司内网也能爽玩 AI！从创建应用到配置权限，从安装插件到调试 BUG，手把手带你从零搭建专属 AI助手，让工作效率原地起飞！

目录

• 前置准备：这些事你得先知道
• [第一步：创建飞书应用（5 分钟搞定）](#第一步创建飞书应用 5 分钟搞定)
• 第二步：配置权限（避坑指南）
• [第三步：OpenClaw安装（含 BUG 解决）](#第三步 openclaw 安装含 bug 解决)
• 第四步：对接飞书（见证奇迹的时刻）
• 第五步：测试与调优
• [进阶玩法：AI技能大全](#进阶玩法 ai 技能大全)
• [常见问题 Q&A](#常见问题 q-a)

前置准备：这些事你得先知道

硬件&软件要求

• ✅ 一台能跑 OpenClaw的电脑（Windows/Mac/Linux都行）
• ✅ Node.js环境（建议 v22+）
• ✅ 一个飞书账号（个人版/企业版都 OK）
• ✅ 一点点耐心（真的，就一点点）

心理准备

⚠️高能预警：中间可能会遇到几个小坑，但我都给你标出来了，照着做准没错！

第一步：创建飞书应用（5 分钟搞定）

1.1 登录飞书开放平台

传送门：https://open.feishu.cn

注意：如果你用的是国际版飞书（Lark），要去 https://open.larksuite.com/app，别跑错了！

1.2 创建企业自建应用

1. 登录后点「创建企业自建应用」
2. 填写应用名称（随便起，比如"我的 AI助手"、“OpenClaw Bot”）
3. 描述随便写几个字占位
4. 图标可以先跳过（后面再上传）
5. 点击「创建」
   

1.3 获取 App ID 和 App Secret（重点！）

创建完成后，进入应用详情页，在「凭证与基础信息」这个 Tab 里能看到：

• App ID（格式是cli_xxx）
• App Secret

🔴血泪教训：这两个值一会儿要填进 OpenClaw，建议先复制粘贴到记事本里，别到时候来回切窗口！

1.4 添加机器人能力

1. 左侧菜单找「应用功能」→「机器人」
2. 把开关打开（这一步很关键，跳过会失败！）
3. 添加后，应用能力下方会多出一个机器人菜单

划重点：如果跳过这一步，你的应用就不具备机器人能力，后面消息收发会直接失败！

第二步：配置权限（避坑指南）

要让机器人能收发消息、读取群聊信息、处理文件等，需要在飞书开放平台里为它开通相应权限。

⚠️ 权限配置

逐项勾选

1. 进入应用后台
2. 点击「权限管理 → 开通权限」
3. 手动搜索im，并全部勾选
4. 点击确认开通
   

🔴 重要提示

企业版飞书：权限需要管理员审批，提交之后让管理员在后台通过就行

个人版飞书：一般直接自动通过，几分钟之内就好

必要权限说明

• im:message- 消息收发基础权限
• im:message:send_as_bot- 以机器人身份发消息
• im:chat.members:bot_access- 读取群成员信息
• contact:user.employee_id:readonly- 读取用户信息
• 其他…

发布应用版本

权限配好之后，还要把机器人功能显式开启，然后走发布流程：

1. 左侧菜单找「版本管理与发布」
2. 点「创建新版本」
3. 填写版本号和版本说明（随便写，比如"v1.0.0 初始版本"）
4. 提交发布

企业版飞书：会走一个内部审批流程，管理员需要在飞书客户端里点通过

个人版飞书：自动通过，通常等个几分钟刷新一下就显示已发布了

如果你设置了免审核策略，发布后会在飞书客户端收到一条类似"审批通过"的消息：

到这里，飞书侧的"身份"和"权限"已经准备好了，接下来轮到本地的 OpenClaw 上场！

第三步：OpenClaw安装（含 BUG 解决）

3.1 安装 OpenClaw

正常情况下，一行命令搞定：

npminstall-gopenclaw@latest

⚠️ 高能预警：遇到这个 BUG 别慌！

如果你看到类似这样的错误：

Error: ENOTEMPTY: directory not empty, rename '/home/user/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw'...

原因：你的 NVM 目录下已经存在一个 openclaw 文件夹，但它可能已损坏或处于不完整状态，导致 npm 在尝试覆盖安装时无法重命名该目录。

解决方案（亲测有效）：

Step 1: 删除旧文件

# 删除库文件目录rm-rf/home/user/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw# 删除可能存在的二进制软链接rm-f/home/user/.nvm/versions/node/v22.22.0/bin/openclaw

Windows 用户注意：路径分隔符要用反斜杠，或者在 PowerShell 里用正斜杠也行

Step 2: 清理 npm 缓存（可选但建议）

防止 npm 继续调用损坏的临时文件：

npmcache clean--force

Step 3: 重新安装

npminstall-gopenclaw@latest

这次应该就能顺利安装了！

3.2 安装飞书插件

方法一：安装第三方插件（旧版本）

openclaw pluginsinstall@m1heng-clawd/feishu

方法二：使用官方内置插件（新版本推荐）

如果你安装的是最新版本（2026.2.2+），OpenClaw已经内置了飞书插件，不需要额外安装！

检查插件是否已存在：

ls~/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/extensions/

如果看到feishu相关的文件夹，说明已经内置了，跳过这一步！

插件路径参考：

~/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/extensions

第四步：对接飞书（见证奇迹的时刻）

4.1 配置飞书渠道

执行渠道配置命令：

openclaw channelsadd

会出现交互式菜单，按提示操作：

1. 选择Feishu（飞书）
2. 输入你的App ID（就是之前复制的那个cli_xxx）
3. 输入你的App Secret
4. 选择「飞书中国」版本（如果用国际版就选 Lark）
5. 勾选「允许群组聊天」（这样机器人群里也能用）

4.2 重启网关

配置完成后，重启 OpenClaw 的 gateway 让配置生效：

openclaw gateway restart

我在重启的时候报错了，是由于openclaw已经内置了一个飞书插件，我又安装了飞书插件导致。需要删除一个。将内置的飞书插件删除，路径如下

ls ~/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/extensions/

然后再重启，等待几秒钟，看到类似"Gateway started"的提示就说明重启成功了！

第五步：测试与调优

5.1 在飞书中测试机器人

1. 打开飞书客户端
2. 在顶部搜索框里搜你的机器人名称
3. 找到之后点进去
4. 发一条测试消息，比如"你好"
5. 如果机器人正常回应了，恭喜！整个链路都通了！🎉

如果没有响应，接着往下看👇

5.2 检查插件状态

查看已安装的扩展：

ls~/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/extensions/

应该能看到飞书插件的文件夹。

5.3 查看运行日志（排查问题神器）

实时日志能让你直接看到连接飞书时报了什么错：

openclaw logs--follow

常见错误及解决方案：

❌App Secret 复制的时候带了空格→ 重新复制，确保前后没空格
❌权限还没审批通过→ 找管理员审批，或者等个人版自动通过
❌应用还没发布→ 回去走发布流程
❌网关没启动→ 执行openclaw gateway status确认服务状态

5.4 补充权限（如需要）

如果发现机器人无法正常获取用户信息，可能需要补充开通：

• 通讯录基本信息权限
  

• 用户信息读取权限
  在事件与回调的菜单中
  
  

然后重新发布应用版本。

常见问题 Q&A

Q1: npm 安装失败，报 ENOTEMPTY 错误

A: 这是最常见的坑！原因是 NVM 目录下已存在损坏或不完整的 openclaw 文件夹。

解决方案：按照第三步里的清理步骤，删除旧文件并重新安装。亲测有效！

Q2: 机器人没有响应

排查清单（按顺序检查）：

✅ 应用已发布（版本管理与发布中显示已发布）
✅ 权限已开通（特别是 im 相关权限）
✅ App ID 和 App Secret 配置正确（检查有没有多余空格）
✅ 网关已重启（openclaw gateway status确认服务状态）
✅ 机器人能力已添加（应用功能里有机器人菜单）

终极杀招：用openclaw logs --follow看实时日志，错误信息会直接告诉你问题在哪。

Q3: 找不到飞书插件

检查：

ls~/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/extensions/

如果已经有内置插件，不需要重复安装第三方插件。

如果是旧版本，手动安装：

openclaw pluginsinstall@m1heng-clawd/feishu

Q4: 权限不足/审批未通过

确保开通了以下权限：

• im:message
• im:message:send_as_bot
• im:message:readonly
• im:chat.members:bot_access
• contact:user.employee_id:readonly
• 其他必要权限（直接用我上面给的 JSON 批量导入，省事）

企业版用户：找管理员审批，催一下，很快

个人版用户：自动通过，等几分钟就行

Q5: Windows 下安装插件报错 spawn npm ENOENT

原因：Windows 环境下的已知问题，OpenClaw 调用 npm 子进程时需要shell: true

临时解决方案：

找到 OpenClaw 安装目录下的dist/process/exec.js，在 spawn 调用处加shell: true：

constchild=spawn(cmd,args,{...options,shell:true});

改完重新安装插件就能正常跑了。

接入成功后你能得到什么？

✅ 一个 7x24 小时待命的 AI 私人助理
✅ 不用翻墙、不用切换窗口、不用暴露内网
✅ 在公司内网环境下也能爽玩 AI
✅ 团队协作时逼格拉满，同事都以为你是技术大佬

最后说两句

这篇文章我把能想到的坑都给你标出来了，照着做应该能省掉不少踩坑时间。

如果还是遇到问题，别慌，多用openclaw logs --follow看日志，错误信息会告诉你答案。

祝你玩得开心！有问题欢迎交流讨论～ 👋

觉得有用？点个赞 + 收藏支持下！💖

关注我，获取更多 AI 实战干货！🚀