OpenClaw配置第二个飞书BOT踩坑指南

一、背景：为什么要配置第二个BOT？

在使用OpenClaw的过程中，我发现了一个痛点：

主助手小金负责日常事务协调，但健康助手康康每次都要手动切换很麻烦。

能不能让康康独立运行，用户直接跟康康聊健康，不用经过小金？

答案是可以！配置第二个飞书BOT绑定康康Agent。

二、踩坑记录（关键步骤）

坑1：飞书开放平台启用机器人功能

创建应用后，机器人功能默认未启用。

踩坑点：配置了OpenClaw但飞书里找不到BOT，无法对话。

原因：飞书开放平台 → 应用详情 → 机器人配置 → 未开启"启用机器人"。

解决方法：
1. 进入飞书开放平台 → 应用详情
2. 找到"机器人配置"
3. 点击"启用机器人"
4. 配置机器人名称和描述
5. 发布版本（重要！）

验证命令：

# 在飞书开放平台查看应用状态 # 应该显示：机器人已启用，版本已发布

坑2：事件订阅配置

OpenClaw需要接收飞书消息，必须配置事件订阅。

踩坑点：用户发消息，BOT无响应。

原因：事件订阅URL未配置或配置错误。

解决方法：
1. 飞书开放平台 → 应用详情 → 事件订阅
2. 配置请求网址：http://你的服务器IP:端口/webhook
3. 添加事件：接收消息（im.message.receive_v1）
4. 保存并发布

验证命令：

# 测试webhook是否可达 curl -I http://你的服务器IP:端口/webhook # 应该返回：HTTP 200 OK

坑3：权限配置

BOT需要权限才能读取消息和回复。

踩坑点：BOT能收到消息但无法回复。

原因：缺少"以应用身份读取消息"和"以应用身份发送消息"权限。

解决方法：
1. 飞书开放平台 → 应用详情 → 权限管理
2. 添加权限：
- im:message:read_as_app（读取消息）
- im:message:send_as_app（发送消息）
3. 保存并发布

坑4：OpenClaw配置绑定

这是最关键的一步：让OpenClaw知道哪个飞书BOT对应哪个Agent。

核心配置：
OpenClaw配置文件（~/.openclaw/openclaw.json）里需要添加飞书插件配置。

配置示例：

{ "gateway": { "plugins": { "entries": [ { "name": "feishu", "config": { "appId": "cli_xxxxxxxxxxxxxxxx", "appSecret": "xxxxxxxxxxxxxxxxxxxxxx", "bots": [ { "name": "main", "appId": "cli_a92774787278dcbb", "bind": "main" }, { "name": "kangkang", "appId": "cli_a940430455b85bd8", "bind": "kangkang" } ] } } ] } } }

验证命令：

# 查看配置是否生效 cat ~/.openclaw/openclaw.json | grep -A 20 "feishu" # 重启OpenClaw openclaw gateway restart

坑5：用户授权

配置完成后，用户需要手动添加BOT到对话列表。

踩坑点：配置都对了，但飞书里找不到BOT。

原因：应用未发布，或用户未授权。

解决方法：
1. 飞书开放平台 → 应用详情 → 版本管理与发布
2. 创建版本并发布
3. 发布后获得应用链接
4. 用户点击链接授权添加BOT

三、最终验证清单

配置完成后，逐一验证以下项目：

✅ 验证清单：
□ 飞书开放平台 → 机器人已启用
□ 飞书开放平台 → 版本已发布
□ 飞书开放平台 → 事件订阅已配置
□ 飞书开放平台 → 权限已添加
□ OpenClaw配置文件 → BOT绑定已配置
□ OpenClaw → gateway已重启
□ 飞书客户端 → BOT已添加到对话列表
□ 飞书客户端 → 发送测试消息，BOT正常回复

四、常见问题FAQ

Q1：配置后BOT还是不回复？

A：按验证清单逐一检查，最常见的是事件订阅URL错误或权限未添加。

Q2：如何确认OpenClaw收到飞书消息？

A：查看OpenClaw日志：

# 查看gateway日志 openclaw gateway logs | grep feishu # 应该看到：received message from feishu

Q3：多个BOT如何区分消息来源？

A：OpenClaw配置文件里的bind字段指定了Agent绑定，飞书BOT发送的消息会自动路由到对应Agent。

五、总结

配置第二个飞书BOT的核心流程：

5步流程：
1. 飞书开放平台创建应用
2. 启用机器人 + 配置事件订阅 + 添加权限
3. OpenClaw配置文件添加BOT绑定
4. 发布应用 + 用户授权
5. 测试验证

踩坑最多的地方：

机器人未启用
（飞书开放平台）
事件订阅未配置
（导致收不到消息）
权限未添加
（导致无法回复）
应用未发布
（导致用户找不到BOT）

希望这篇文章能帮到你！有问题欢迎留言交流。

技术原理扩展（深度解析）：

多Agent运行机制详解：共享Gateway vs 独立Gateway架构对比

相关资源：

AI工具集导航：GitHub Pages
AI工具集导航（镜像）：Vercel
OpenClaw官方文档：docs.openclaw.ai
OpenClaw GitHub：github.com/openclaw/openclaw

作者：老刘（Amos Liu）

公众号：爱默如深