一、配置前必看：核心说明与前置准备
1.1 核心价值
Openclaw+ 飞书多机器人配置，核心是让多个飞书机器人分别绑定 Openclaw 的不同 Agent，实现「分工协作、各司其职」——无需切换工具，在飞书内即可完成所有操作，大幅提升工作效率。
典型分工场景：
- 1 个机器人负责日常指令响应
- 1 个机器人负责定时推送资讯
- 1 个机器人负责办公流程自动化（会议整理、报表生成等）
1.2 前置环境准备（必做）
提前准备好以下环境和工具，避免配置过程中卡顿，所有工具均为免费可用：
- 基础环境：云端安装 Openclaw；
- 账号权限：飞书个人账号（无需企业认证，个人账号即可创建企业自建应用），拥有飞书开放平台访问权限
- 辅助工具：终端（用于执行 Openclaw 命令）、文本编辑器（用于修改配置文件）、飞书客户端（用于测试机器人功能）。
1.3 核心概念科普（新手必看）
避免配置过程中混淆关键概念，提前梳理 2 个核心名词：
- Openclaw Agent：可理解为「机器人的大脑」，每个 Agent 有独立的工作空间和配置，负责执行特定任务，多机器人配置本质就是为不同 Agent 绑定不同的飞书机器人；
- 飞书企业自建应用：飞书机器人的载体，每个飞书机器人对应一个企业自建应用，需在飞书开放平台创建，获取 App ID 和 App Secret 用于与 Openclaw 对接。
二、分步实操：Openclaw+ 飞书多机器人配置（全程图解式）
📌 核心流程：创建飞书应用 → 配置 Openclaw Agent → 绑定机器人与 Agent → 测试验证
每一步均附关键提示和命令示例，可直接复制执行，降低操作难度。
2.1 第一步：创建多个飞书企业自建应用（对应多机器人）
每个飞书机器人对应一个企业自建应用，需逐个创建，步骤完全一致，此处以创建 1 个为例，其余机器人可重复操作：
- 访问飞书开放平台（https://open.feishu.cn/），登录飞书账号后，点击右上角「创建应用」，选择「企业自建应用」（个人账号可直接创建，无需企业认证）；
- 填写应用信息：应用名称（如「Openclaw-办公助手」「Openclaw-资讯推送」，区分不同机器人用途）、应用描述，上传可选图标，点击「创建」；
- 添加机器人能力：进入应用详情页，左侧菜单点击「添加应用能力」，找到「机器人」能力并点击添加，确保「机器人」开关已开启；
- 配置权限（必加，否则无法正常收发消息）：
- 左侧菜单点击「权限管理」，搜索并添加 3 个核心权限；
- im:message（获取与发送单聊、群组消息，必须）；
- im:message:send_as_bot（以应用的身份发消息，必须）；
- im:chat:readonly（读取群信息，推荐，可选）。
- 获取应用凭证：在应用详情页的「凭证与基础信息」中，复制 App ID 和 App Secret（点击「显示」后复制），妥善保管，后续配置需用到，切勿泄露；
- 发布应用：左侧菜单点击「版本管理与发布」，点击「创建版本」，填写版本号和更新说明，设置可用范围（选择自己或需要使用机器人的人/部门），点击「保存」后「申请发布」，内部应用通常自动审核通过，无需等待；
- 重复步骤 1-6，创建多个飞书企业自建应用，每个应用对应一个机器人，分别记录每个应用的 App ID 和 App Secret，做好区分（建议按机器人用途命名，如「办公助手-AppID」）。
💡 提示：创建多个应用时，应用名称建议差异化，方便后续绑定和管理，避免混淆。
2.2 第二步：配置 Openclaw 多 Agent（对应多机器人分工）
Openclaw 的每个 Agent 对应一个飞书机器人，需先创建多个 Agent，再配置其工作属性，步骤如下：
- 启动 Openclaw 服务（后续配置长连接需用到）：
# 启动 Openclaw 网关
openclaw gateway start
# 查看服务状态，确认启动成功
openclaw gateway status
- 创建多个 Agent（每个 Agent 对应一个飞书机器人）：
# 创建第一个 Agent（办公助手，对应第一个飞书机器人）
openclaw agents add office-assistant
# 创建第二个 Agent（资讯推送，对应第二个飞书机器人）
openclaw agents add news-push
# 创建第三个 Agent（开发助手，对应第三个飞书机器人）
openclaw agents add dev-assistant
- 查看 Agent 列表，确认创建成功：
openclaw agents list
✅ 输出示例：Agents: - main (default)、- office-assistant、- news-push、- dev-assistant，即为创建成功。 4. 配置 Agent 属性（可选）：每个 Agent 可设置独立的身份、行为准则等，进入对应 Agent 的工作空间（路径：~/.openclaw/workspace-xxx，xxx 为 Agent 名称），修改 IDENTITY.md、SOUL.md 等文件，定义 Agent 的性格、功能，让不同机器人有差异化的响应逻辑。
2.3 第三步：配置飞书渠道，绑定 Agent 与飞书机器人（核心步骤）
核心目标：将每个 Openclaw Agent 与对应的飞书应用（机器人）绑定，实现「指令分流」，步骤如下：
- 进入 Openclaw 消息渠道配置界面：
bash ~/.openclaw/config-menu.sh
- 依次选择「(3) 消息渠道配置」→「(7) 飞书 (feishu)」，按提示输入第一个飞书应用的 App ID 和 App Secret，配置完成后选择「是」重启 gateway；
- 重复步骤 1-2，为每个飞书应用（机器人）配置飞书渠道，确保每个渠道对应不同的 App ID 和 App Secret；
- 绑定 Agent 与飞书渠道（示例如下）：
# 绑定 office-assistant Agent 到第一个飞书账号（main 对应第一个渠道）
openclaw agents bind --agent office-assistant --bind feishu:main
# 绑定 news-push Agent 到第二个飞书账号（自定义账号名，如 news）
openclaw agents bind --agent news-push --bind feishu:news
# 绑定 dev-assistant Agent 到第三个飞书账号（自定义账号名，如 dev）
openclaw agents bind --agent dev-assistant --bind feishu:dev
- 查看绑定结果，确认绑定成功：
openclaw agents bindings
✅ 输出示例：Routing bindings: - office-assistant <- feishu accountId=main、- news-push <- feishu accountId=news，即为绑定成功。 6. 配置飞书事件订阅（长连接，必做）：
- 回到飞书开放平台，进入每个飞书应用的详情页，左侧菜单点击「事件与回调」；
- 选择「使用长连接接收事件」（无需填写 webhook 地址，无需公网服务器）；
- 点击「添加事件」，添加「im.message.receive_v1」（接收消息，必须），可选添加「im.message.message_read_v1」（消息已读）、「im.chat.member.bot.added_v1」（机器人进群），添加完成后点击「保存」。
- 添加机器人到飞书群/私聊：打开飞书客户端，进入目标群组或私聊，通过「群设置→群机器人→添加机器人」，搜索每个机器人的应用名称并添加，完成后即可通过飞书与机器人交互。
💡 提示：配置长连接时，需确保 Openclaw 服务已启动，否则无法保存长连接设置；若保存失败，重新执行 openclaw gateway start 启动服务后再尝试。
2.4 第四步：多机器人测试验证（确保配置生效）
配置完成后，需逐个测试机器人，确保每个机器人能正常响应指令，分工明确，测试步骤如下：
- 单个机器人测试：在飞书内找到对应机器人（私聊或群聊），@机器人发送指令（如办公助手发送「帮我整理今天的会议要点」，资讯推送发送「推送今日行业热点」），查看机器人是否正常响应；
- 批量测试：同时向多个机器人发送对应指令，确认每个机器人仅响应自身分工范围内的指令，无串流、无延迟；
- 命令行测试（可选，快速验证连通性）：
bash ~/.openclaw/config-menu.sh # 选择 (7) 快速测试 → (5) 测试飞书机器人
# 按提示输入群组 chat id（以 oc_开头，可在飞书群设置→群信息中复制），发送测试消息
- 异常排查：若机器人不响应，查看日志定位问题：
# 查看飞书渠道日志
openclaw logs --channel feishu
✅ 测试成功标准：每个飞书机器人能正常接收指令，按对应 Agent 的配置响应，无报错、无串流，飞书内可正常查看响应结果。
三、进阶优化：多机器人分工建议与配置技巧
3.1 多机器人分工推荐（实用场景）
根据日常工作需求，推荐以下分工方式，最大化发挥多机器人价值，可直接参考：
- 办公助手机器人：绑定 office-assistant Agent，负责会议录音整理、月度报表生成、邮件提取与总结，解放办公重复劳动；
- 资讯推送机器人：绑定 news-push Agent，负责定时推送行业热点、定制化早报，无需手动搜索信息；
- 开发助手机器人：绑定 dev-assistant Agent，负责代码查询、调试建议、开发文档生成，提升开发效率；
- 生活助手机器人：绑定 life-assistant Agent，负责航班信息提取、自动值机、日程提醒，便捷处理生活事务。
3.2 配置技巧（避坑指南）
- 📌 凭证管理：每个飞书应用的 App Secret 需妥善保管，切勿泄露，若泄露需及时在飞书开放平台重置；
- 📌 权限配置：务必添加核心权限（im:message、im:message:send_as_bot），否则机器人无法收发消息；
- 📌 服务稳定性：本地部署建议设置 Openclaw 开机自启，避免重启电脑后服务中断；云端部署可 7×24 小时运行，推荐新手使用；
- 📌 Agent 配置：不同 Agent 的工作空间做好区分，避免配置文件混淆，可在 IDENTITY.md 中明确 Agent 分工；
- 📌 版本兼容：确保 Openclaw 版本为最新版本及以上，避免因版本过低导致飞书多渠道配置失败。
3.3 拓展功能：定时任务配置（可选）
可通过 Openclaw 为飞书机器人配置定时任务，实现自动化推送，示例如下（以资讯推送机器人为例）：
- 获取飞书群机器人 Webhook 地址：飞书群设置→群机器人→添加机器人→选择自定义机器人，填写名称后复制 Webhook 地址；
- 在飞书内给资讯推送机器人发送指令：「帮我创建定时任务，每天早上 9 点推送行业热点，推送至指定群聊，使用以下 Webhook 地址：[复制的 Webhook 地址]」；
- 验证定时任务：可让 Agent 立即发送测试消息，查看群聊是否收到推送，若需修改或取消定时任务，直接在飞书内发送对应指令即可。
四、常见问题排查（新手必看，避坑神器）
配置过程中难免遇到问题，整理了 6 个高频问题，附详细解决方案，无需额外搜索，直接对照排查：
- 问题 1：飞书长连接保存失败？ 解决方案：确保 Openclaw 服务已启动（执行 openclaw gateway start），飞书后台需要检测到客户端连接才能保存长连接设置，启动服务后重新尝试保存。
- 问题 2：机器人不回复消息？ 解决方案：依次检查 4 点：① Openclaw 服务是否正常运行（openclaw gateway status）；② 飞书事件订阅是否添加了 im.message.receive_v1 事件；③ 飞书应用是否添加了核心权限；④ 应用是否已发布，机器人是否已添加到群聊/私聊。
- 问题 3：群聊中@机器人无响应？ 解决方案：默认情况下，群聊中需@机器人才能触发响应，避免机器人响应所有消息，若需修改触发方式，可在 Openclaw Agent 配置中调整。
- 问题 4：私聊机器人不回复？ 解决方案：确认自己在飞书应用的「可用范围」内，尝试在飞书内搜索机器人名称，点击进入私聊后发送消息测试。
- 问题 5：多机器人出现串流（指令发送给 A 机器人，B 机器人响应）？ 解决方案：检查 Agent 与飞书渠道的绑定关系，确保每个 Agent 仅绑定一个飞书账号，执行 openclaw agents bindings 查看绑定结果，若绑定错误，重新执行绑定命令。
- 问题 6：配置完成后，重启 Openclaw 服务，机器人失效？ 解决方案：检查飞书渠道配置是否保存，可重新进入 config-menu.sh，确认飞书渠道的 App ID 和 App Secret 配置正确，重启 gateway 后再次测试。
五、总结与拓展
到这里，Openclaw+ 飞书多机器人配置就全部完成了！其实核心逻辑很简单：
📝 核心逻辑：创建多个飞书应用（机器人）→ 配置 Openclaw 多 Agent → 绑定两者实现分工
🚀 拓展方向：后续可根据需求，为每个 Agent 配置更多技能（如邮件处理、语音转文字、飞书文档生成等）。
附：常用命令汇总（复制即用）
# Openclaw 服务相关
openclaw gateway start # 启动网关
openclaw gateway status # 查看服务状态
openclaw gateway stop # 停止网关
# Agent 相关
openclaw agents add 【Agent 名称】 # 创建 Agent
openclaw agents list # 查看 Agent 列表
openclaw agents bind --agent 【Agent 名称】 --bind feishu:【账号名】 # 绑定 Agent 与飞书渠道
openclaw agents bindings # 查看绑定结果
# 飞书渠道相关
bash ~/.openclaw/config-menu.sh # 进入配置菜单
openclaw logs --channel feishu # 查看飞书渠道日志
# 测试相关
openclaw pairing approve feishu 【配对码】 # 飞书机器人配对（若需）
