OpenClaw 接入飞书保姆级指南

你在工作中一定遇到过这些情况：

场景一：

你在出差路上，突然收到飞书消息——客户问："你们新项目的架构方案准备好了吗？能先发个版本文档看看吗？

"以前的你会怎么办？找个地方停下来，打开电脑，连上网络，启动 IDE 或文档编辑器，或者打开 AI 工具生成方案，然后再发送回去。至少要半小时，而且路上可能还没法操作。

现在，你只需要拿出手机，在飞书里给 AI 助手发条消息：帮我生成一个新项目的技术架构方案，包括技术选型、模块划分和部署方案 ，三分钟后，一份完整的方案就发到客户邮箱了。

场景二：

再比如，你在地铁上，飞书群里同事正在讨论一个复杂的代码 Bug，大家争论不休。你拿出手机，直接在群里 @AI 助手：分析一下这段代码为什么会报错 ，AI 立刻给出问题定位和修复建议，讨论瞬间有了突破。

这些场景你是不是也经常遇到？我说的处理方法看起来是不是很酷？而这一切，通过飞书 + OpenClaw 就能轻松实现 。

OpenClaw 是什么？

OpenClaw 是一个自托管的 AI 网关，说白了，就是一座"桥梁"，把飞书和 AI 编程助手（比如 Claude Code、OpenCode、Codex 等）连接起来。你只需要在自己的电脑或服务器上运行 OpenClaw 网关进程，就能在飞书里直接跟 AI 助手对话。

我平时用它做什么？

• 💻 写代码、调试 Bug：群里有人遇到问题，我直接把代码发给 AI，让它帮我看看问题在哪
• 📧 写项目方案、邮件：需要给客户发技术方案？直接让 AI 帮我写个初稿，我再修改
• 📁 查看、分析项目文件：想知道某个文件里写了什么？让 AI 帮我看看，不用打开编辑器
• 📝 代码审查、重构建议：同事提交了新代码，想让 AI 帮忙 Review？直接把代码贴给 AI
• 🎯 技术方案设计：需要设计一个新功能？让 AI 帮我梳理思路，给点建议
• 📚 快速理解代码：接手了新项目，想快速了解代码结构？让 AI 帮我分析一下
• 🔍 项目信息查询：想知道某个接口怎么用的、某个模块依赖哪些？直接问 AI

OpenClaw 有什么特点？

• 🛡️ 自己搭、自己管：运行在你自己的电脑或服务器上，数据都是你的，不用担心安全问题
• 💬 飞书里就能用：AI 助手就像你的飞书好友，私聊、群聊、@它都能响应
• 🤖 可以配置多个 AI：不同项目可以用不同的 AI 代理，每个都有独立的记忆
• 📱 手机、电脑都能用：无论你在哪，只要能上飞书，就能找 AI 帮忙
• 🎨 支持发图、发代码：可以把截图、代码片段发给 AI，让它"看懂"图片里的内容
• 🌐 有个网页管理界面：需要配置权限或查看历史会话，打开网页就能操作

我觉得最爽的地方：不用守着电脑了

以前，很多工作必须坐在电脑前才能完成：写代码、查文件、生成文档、Review 代码……现在，通过飞书 + OpenClaw，我在任何地方、任何设备上都能做这些事。

出差路上写个项目方案，没问题。地铁上解决个代码 Bug，可以。咖啡厅里审查代码，都行。

飞书不再只是个聊天工具，变成了一个能随时访问 AI 的工作空间。AI 就在飞书里，不管我在哪，都能让它帮点忙。

听起来很棒吧？但你可能担心：对接过程一定很复杂吧？

别担心，我踩过所有坑，总结了一套十步法， 把配置过程写得明明白白。这篇保姆级教程，每个步骤，每个点击都有图有说明，保证你跟着做就能成功！

选型说明

新版本的 OpenClaw v2026.2.3 官方已经集成了飞书，但我在测试过程中发现了一些问题，所以暂时还是推荐使用社区开源版。这个版本经过了社区的充分验证，稳定性更好。

社区开源版地址：https://github.com/m1heng/clawdbot-feishu

第一步：登录飞书开发者后台

首先，我们需要到飞书平台创建自己的机器人来接入 OpenClaw。

飞书开放平台地址：https://open.feishu.cn

⚠️ 如果你还没有飞书账号，需要先注册一个账号才能继续。

点击右上角的「开发者后台」按钮进入：

第二步：创建应用

进入开发者后台后，点击「创建应用」按钮，开始创建你的飞书机器人应用：

第三步：填写应用信息

接下来，填写你的应用基本信息：

• 应用名称 ：填写一个你喜欢的名字，比如"OpenClaw 助手"或"My AI Assistant"
• 应用描述 ：简单描述一下这个机器人的用途
• 应用图标 ：上传一个机器人头像图标（可选）

填写完成后点击「创建」：

第四步：给应用添加机器人

创建完应用后，需要给这个应用添加机器人能力，让它能够像助手一样在飞书中工作：

1. 在应用详情页找到「添加应用能力」区域
2. 点击「机器人」选项，添加机器人能力

添加成功后，你会看到机器人能力已经启用：

第五步：给应用配置权限

这一步非常关键！要正常使用 OpenClaw 对接飞书的基本功能，必须开启所需的权限。飞书插件开发者的官方文档中对权限有详细说明，我来帮你梳理一下。

必需权限（不开就跑不起来）

权限	范围	说明
im:message	消息	发送和接收消息的核心权限
im:message.p2p_msg:readonly	私聊	读取发送给机器人的私聊消息
im:message.group_at_msg:readonly	群聊	接收群里 @机器人的消息
im:message:send_as_bot	发送	以机器人身份发送消息
im:resource	媒体	上传和下载图片、文件

可选权限（建议开启以获得更好的体验）

权限	范围	说明
contact:user.base:readonly	用户信息	获取用户基本信息（用于解析发送者姓名，避免在群聊/私聊时把不同人当成同一个说话者）
im:message.group_msg	群聊	读取所有群消息（⚠️ 这个比较敏感，按需开启）
im:message:readonly	读取	获取历史消息
im:message:update	编辑	更新/编辑已发送的消息
im:message:recall	撤回	撤回已发送的消息
im:message.reactions:read	表情	查看消息的表情回复

工具权限（高级功能）

只读权限 （最低要求，能读取飞书文档、表格等内容）：

权限	工具	说明
docx:document:readonly	feishu_doc	读取文档内容
drive:drive:readonly	feishu_drive	列出文件夹、获取文件信息
wiki:wiki:readonly	feishu_wiki	列出空间、列出节点、获取节点详情、搜索
bitable:app:readonly	feishu_bitable	读取多维表格的记录和字段

读写权限 （可选，用于创建/编辑/删除操作）：

权限	工具	说明
docx:document	feishu_doc	创建/编辑文档
docx:document.block:convert	feishu_doc	Markdown 转换为 blocks（write/append 操作必需）
drive:drive	feishu_doc, feishu_drive	上传图片到文档、创建文件夹、移动/删除文件
wiki:wiki	feishu_wiki	创建/移动/重命名知识库节点
bitable:app	feishu_bitable	创建/更新多维表格记录

添加必备权限（图文演示）

下面我以必需权限和几个关键的可选权限为例，为你演示如何添加。其他权限在使用过程中根据需求自行设置即可。

1. 添加所有 im:message 权限

进入「权限管理」页面，在搜索框中输入 im:message，然后全选所有相关权限：

选择完成后，点击「确认开通权限」：

2. 开通用户信息权限

搜索 contact:user.base:readonly 并开通，这个权限非常重要，可以让机器人识别不同用户：

点击「确认开通权限」：

3. 开通媒体文件权限

搜索并开通 im:resource 权限，用于上传和下载图片、文件：

💡 小提示：根据我的测试，这个权限有的人开了就能正常使用，有的人开了还是不能上传图片和文件（我就是后者），目前还在研究中。如果你也遇到这个问题，可以先继续往下配置，后面可以再回来调整。

第六步：创建版本并发布

权限配置完成后，需要创建应用版本并发布，才能在飞书客户端中使用。

1. 进入「版本管理与发布」页面
2. 点击「创建版本」

1. 填写版本信息：

版本号 ：使用默认生成的即可，比如 1.0.0

版本描述 ：简单描述这个版本的更新内容应用功能描述 ：描述你的机器人能够做什么

填写完成后点击「保存」，点击「确认发布」：

1. 确认已发布

发布后，飞书会自动审核。通常这种内部使用的机器人会自动审核通过。你可以在飞书客户端中查看应用状态：

第七步：获取应用凭证

接下来，我们需要获取应用的凭证信息（App ID 和 App Secret），这些信息将在后续配置 OpenClaw 时用到。

1. 在应用详情页找到「凭证与基础信息」
2. 复制 App ID 和 App Secret ，妥善保存

第八步：安装飞书插件

飞书应用创建完成后，现在回到 OpenClaw 这边，安装飞书插件。

打开命令行终端，输入以下命令安装飞书插件：

代码语言：JavaScript

AI 代码解释

openclaw plugins install @m1heng-clawd/feishu

等待安装完成后，打开一个新的命令行窗口 （这一点很重要，确保新窗口能识别新安装的插件），开始配置飞书插件。

输入配置命令：

代码语言：JavaScript

AI 代码解释

openclaw config

配置步骤详解

第一步：选择渠道

在配置向导中，选择要配置的渠道：

第二步：选择配置连接

选择「飞书」作为要配置的连接：

第三步：填写飞书凭证

输入前面复制的飞书 App ID 和 App Secret ：

填写完成后，系统会进行客户端测试。测试通过后，飞书域名选择「China」 （因为我们使用的是飞书国内版）：

第四步：配置群组聊天权限

接下来配置机器人的群组聊天接受策略。为了简化配置，新手建议选择 Open （允许所有群组）。等熟悉了后期使用后，可以根据需要调整为更精细的策略：

第五步：完成配置

确认配置无误后，点击「完成」：

第六步：配置 DM（私聊）策略

接下来配置机器人接受私聊的策略。同样，为了简化配置，建议新手先选择 Open （允许所有用户），后期可以根据需求调整：

第七步：完成所有配置

点击「继续」，完成配置：

第八步：重启服务使配置生效

重启 OpenClaw 服务，让配置生效。在终端控制台可以看到飞书插件已经成功配置：

⚠️ 此时虽然插件配置成功了，但还不能正常使用！还需要回到飞书后台设置事件回调，让飞书能够把消息发送给 OpenClaw。

第九步：回到飞书后台设置事件回调

现在需要回到飞书开发者后台，配置事件回调。

1. 进入「事件与回调」页面
2. 点击「订阅方式」旁边的「编辑」按钮

1. 选择「使用 长连接 接收事件」
2. 选择后点击「保存」

1. 保存后，你会发现「添加事件」按钮从原来的灰色（不可点击）变成了可点击状态，点击「添加事件」：

1. 在搜索框中输入 im.message，然后勾选以下两个事件：

消息已读 （im.message.message_read_v1）

接收消息 （im.message.receive_v1）

1. 选中后点击「确认添加」
2. 搜索 im.chat.member.bot

1. 点击「确认添加」，系统会弹出一个推荐添加权限的提示框，点击「确认开通权限」：

1. 添加完成后，查看已添加的事件列表：

发布新版本

事件回调配置完成后，需要创建并发布一个新版本才能生效：

1. 点击「创建版本」
2. 填写版本信息
3. 填写版本描述，比如「添加事件回调配置」
4. 保存后点击「申请发布」

跟之前的发布流程一样，填写信息后保存发布：

第十步：在飞书中与 OpenClaw 对话

终于！所有配置都完成了，现在可以在飞书中与 OpenClaw 助手对话了！

打开飞书客户端（电脑端或手机端都可以），找到你的机器人应用：

来打个招呼吧！

发送一条消息给机器人，比如「你好」：

虽然机器人能跟你打招呼了，但返回的信息中可能会提示一个权限问题：contact:contact.base:readonly

💡 这个权限在开发者官方文档中并没有提到，但实际使用时是必需的。

让我们回到飞书开发者后台，添加这个缺失的权限：

1. 进入「权限管理」页面
2. 在搜索框中输入 contact:contact.base:readonly
3. 点击「确认开通权限」

开通权限：

别忘了发布新版本！

权限更新后，需要再次创建版本并发布：

1. 进入「版本管理与发布」页面
2. 创建新版本
3. 填写版本信息
4. 保存并发布

测试功能

配置好所有权限后，我们再试试更多功能：

测试 1：查看电脑上的文件

在飞书中发送指令，让机器人查看本地文件：

测试 2：发送图片

虽然基础对话功能已经正常了，但是让机器人发送图片时，可能会遇到问题。我测试时发现，即使该开的权限都开了，图片发送还是会失败。这可能是对接飞书 插件 的偶发 BUG，也可能是我环境问题。我还在研究解决方案中。

发送图片失败示例：

写在最后

恭喜你！通过这篇保姆级教程，你已经成功将 OpenClaw 接入飞书，拥有了专属的 AI 助手！

你可以用它做什么？

• ✅ 在飞书中直接查看、操作本地文件
• ✅ 让机器人帮你写代码、解释代码
• ✅ 读取飞书文档、多维表格的内容
• ✅ 在群聊中 @机器人，让它协助解决问题
• ✅ 私聊机器人，进行一对一的智能对话

已知问题和解决方案

1. 图片上传失败 ：im:resource 权限已开通，但部分情况下仍然无法上传图片。如果你也遇到这个问题，建议：
   • 检查飞书应用版本是否最新
   • 尝试重新创建应用和配置
   • 关注飞书开放平台的 API 更新
2. 权限配置繁琐 ：飞书的权限体系比较复杂，容易遗漏。建议按照本文的权限清单逐项检查，确保所有必需权限都已开通。