手把手教你:OpenClaw接入飞书机器人,从零到一全攻略

告别繁琐，轻松让你的AI助手走进飞书

如果你正在使用OpenClaw搭建智能助手，并希望它能接入飞书，让团队在飞书群里就能调教AI，那么这篇文章就是为你准备的。本文将分为两大部分：
第一部分：如何在飞书开放平台创建并配置一个机器人应用（即使你是第一次接触飞书后台，也能跟着操作）。
第二部分：如何在OpenClaw中通过命令行添加或修改飞书机器人配置，并最终让两者成功握手。

全文操作性强，每一步都有详细截图级描述（用文字代替），建议先收藏再跟着做。

一、飞书机器人创建与配置（飞书开放平台）

1. 登录飞书开放平台并创建应用

访问飞书开放平台，使用你的飞书账号登录。
点击右上角「开发者后台」，进入后选择「企业自建应用」，点击「创建企业自建应用」。
填写应用名称（例如“我的AI助手”）、应用描述，上传一个头像（可选），点击「确定创建」。

2. 获取核心凭证：App ID 和 App Secret

创建成功后会自动进入应用详情页。在左侧导航栏点击「凭证与基础信息」。
记下 App ID（以 cli_ 开头）和 App Secret。这两个字符串稍后需要填入OpenClaw，请妥善保存（不要泄露）。

3. 为应用添加「机器人」能力

在左侧导航栏点击「添加应用能力」，找到「机器人」卡片，点击「添加」。
添加成功后，左侧菜单会出现「机器人」相关选项。

4. 配置权限（关键）

机器人必须拥有消息收发权限才能工作。

进入左侧「权限管理」页面。
你可以手动搜索以下核心权限并添加：

im:message（基础消息能力）
im:message.group_at_msg:readonly（接收群聊@消息）
im:message.p2p_msg:readonly（接收私聊消息）
im:message:send_as_bot（以机器人身份发送消息）

更快捷的方法：使用「批量导入」功能。点击「批量导入」，将下方JSON复制进去，然后点击「添加」：
json
```
{"scopes":{"tenant":["im:message","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message:send_as_bot","im:chat:readonly","contact:user.employee_id:readonly"]}}
```
实际所需权限可能更多，但上述是最基础的。如果需要机器人处理文件、卡片等，请按需补充。

5. 配置事件与回调（重中之重！）

这是连接OpenClaw与飞书的桥梁。注意顺序：必须先在OpenClaw中完成基础配置并启动，再到飞书后台配置长连接，否则验证会失败。我们先进行到配置这一步，但暂时不要点击保存，等OpenClaw侧准备好再回来。

进入左侧「事件与回调」页面。
在「事件配置」下方，找到「订阅方式」，选择 「使用长连接接收事件」。
点击「添加事件」，搜索 im.message.receive_v1（接收消息事件），勾选并确认添加。
此时先不要点击「保存」，我们会在OpenClaw启动后，再回来完成这一步。

二、OpenClaw侧配置（命令行操作）

假设你已经安装并运行了OpenClaw。如果还未安装，请先参考OpenClaw官方文档完成基础部署。

场景A：首次添加飞书机器人

1. 安装飞书插件

在OpenClaw所在服务器上执行：

bash

openclaw plugins install feishu-openclaw

或备用源：

bash

openclaw plugins install @m1heng-clawd/feishu

2. 交互式添加飞书通道

执行命令：

bash

openclaw channels add

根据提示依次操作：

Configure chat channels now? → 输入 y 或直接回车（默认Yes）
Select a channel → 用方向键选择 Feishu，回车
Enter Feishu App ID → 粘贴刚才保存的 App ID

Enter Feishu App Secret → 粘贴 App Secret。此时会询问：

text

◆ How do you want to provide this App Secret?│ ● Enter App Secret (Stores the credential directly in OpenClaw config)│ ○ Use external secret provider

选择第一项直接存储即可。

Which Feishu domain? → 国内用户选择 China（默认）
Group chat policy → 选择 Open（允许所有群聊），或按需选择
Configure DM access policies now? → 选择 Yes
Feishu DM policy → 选择 Open（允许所有人私聊）
Add display names for these accounts? (optional) → 如果只有一个机器人，选 No；想自定义名称可选 Yes 并输入
Bind configured channel accounts to agents now? → 建议选 Yes，然后选择默认的 default agent，这样配置完就能直接用。

3. 重启网关

bash

openclaw gateway restart

4. 验证配置是否生效

bash

openclaw status

如果看到类似 Feishu │ ON │ OK 的状态，说明OpenClaw端已经就绪。

场景B：修改现有飞书机器人的配置

如果你只是更换了飞书应用（例如更新了App ID/Secret），或想修改某个参数，可以直接用命令行更新。

1. 更新凭证

bash

openclaw config set channels.feishu.appId "cli_你的新AppID"openclaw config set channels.feishu.appSecret "你的新AppSecret"

2. 修改其他常用参数（可选）

bash

# 修改连接模式（推荐websocket，无需公网IP）openclaw config set channels.feishu.connectionMode websocket# 修改私聊策略openclaw config set channels.feishu.dmPolicy open# 修改是否需要@才响应openclaw config set channels.feishu.requireMention true

3. 重启网关

bash

openclaw gateway restart

4. 查看当前完整配置

bash

openclaw config get channels.feishu

三、回到飞书后台，完成最终配置

OpenClaw网关重启成功后（建议等1-2分钟），现在可以回到飞书开放平台，继续刚才未完成的事件配置。

在「事件与回调」页面，确认订阅方式已选为「使用长连接接收事件」。
确认已添加事件 im.message.receive_v1。
点击页面下方的「保存」。此时应该不会再报错，如果保存失败，请检查OpenClaw是否已正常运行，网络是否通畅。
保存成功后，别忘了发布应用！进入「版本管理与发布」，创建一个版本（版本号随意，如1.0.0），填写更新说明，然后点击「保存并发布」。如果是企业自建应用且未开启审核，发布后会立即生效。

四、验证与测试

在飞书客户端搜索你的机器人：打开飞书，在搜索框输入你创建的应用名称，找到它并开始对话。
发送一条消息，例如“你好”，如果机器人正常回复，说明配置成功。
在OpenClaw查看日志：
bash
```
openclaw logs --follow
```
发送消息时，应能看到入站日志。
群聊测试：将机器人拉入一个群，@它并发送消息（如果设置了 requireMention=true 则必须@），看是否能回复。

五、常见问题排查

问题	可能原因与解决方案
飞书后台保存事件时提示“验证失败”	OpenClaw网关未启动或未重启，请检查 `openclaw status`，确保Feishu状态为OK。
机器人收不到消息	1. 应用是否已发布？ 2. 事件订阅是否选择了“长连接”？ 3. 是否添加了 `im.message.receive_v1` 事件？ 4. 权限是否完整？
群聊不回复	检查是否需要@机器人才响应（requireMention配置），以及在群里@机器人。
命令行配置报错	确认OpenClaw版本，执行 `openclaw --version`，确保在v1.0以上。
重启网关后配置丢失	检查配置文件 `~/.openclaw/openclaw.json` 是否存在且有读写权限。

六、总结

通过以上步骤，你已经成功将OpenClaw与飞书机器人连接起来。现在你的飞书同事就可以在群里或私聊中与AI助手互动了。后续你还可以根据需要为不同的Agent绑定不同的飞书账号，实现多机器人分工。

如果在配置过程中遇到任何问题，欢迎在评论区留言，或查阅OpenClaw官方文档。动手试试吧，让你的工作流更智能！