铭甫小智

OpenClaw多Agent系统完整配置指南，避免踩坑，快速上手多Agent架构。提供正确的CLI命令配置方式、完整目录结构说明、常见问题解决方案。来自真实的配置失败和成功案例，帮助你在OpenClaw中创建和管理多个独立Agent。

【2026.5.0版本已发布】解决飞书平台限制机器人之间无法互相@通信的问题，通过WebSocket中继服务实现多机器人协作通信。 --- ## ⚠️ 重要警告（安装前必读） ### 🔴 OpenClaw 版本兼容性问题 **feishu-swarm 与 OpenClaw v2026.4.9 存在 SDK API 不兼容问题：** - `createDefaultChannelRuntimeState` 函数不存在 - `createDedupeCache` 函数不存在 - 多处使用旧版 SDK API **症状**： - Gateway 启动时插件被自动禁用 - 日志显示 `enabled: false` - 飞书通道完全无法工作 **解决方案**： 1. 等待插件作者适配 OpenClaw v2026.4.x 2. 或降级 OpenClaw 到 v2026.3.x --- ### 🔴 双通道冲突问题 **绝对不要把同一个 Bot 同时配置在 `feishu` 和 `feishu-swarm` 两个通道！** 错误配置示例： ```jsonc // ❌ 错误：同一个 appId 出现在两个通道 { "channels": { "feishu": { "accounts": { "main": { "appId": "cli_xxxx" // 同一个 appId } } }, "feishu-swarm": { "accounts": { "botA": { "appId": "cli_xxxx" // 同一个 appId，会冲突！ } } } } } ``` **症状**： - 消息重复接收 - Gateway 启动卡死 - 飞书 WebSocket 连接异常 **正确配置**： - 需要多 Bot 协作的 bot → 放在 `channels.feishu-swarm` - 不需要多 Bot 协作的 bot → 放在 `channels.feishu` - **同一个 appId 只能出现在一个通道** --- ## 功能特性 ✅ 已适配OpenClaw 2026.4.10+ SDK（修复导入路径变更问题） ✅ 支持自建私有Registry服务 ✅ 实时双向消息转发 使用提示： 1. 确保双方Gateway同时启动（peers>0才能通信） 2. 配置Registry地址：wss://claw.devset.top 3. 如遇代理问题，设置NO_PROXY环境变量 适用于：多机器人协作系统、建工项目管理、企业自动化流程等场景。