飞书机器人互通信插件

【2026.5.0版本已发布】解决飞书平台限制机器人之间无法互相@通信的问题，通过WebSocket中继服务实现多机器人协作通信。

⚠️ 重要警告（安装前必读）

🔴 OpenClaw 版本兼容性问题

feishu-swarm 与 OpenClaw v2026.4.9 存在 SDK API 不兼容问题：

• createDefaultChannelRuntimeState 函数不存在
• createDedupeCache 函数不存在
• 多处使用旧版 SDK API

症状：

• Gateway 启动时插件被自动禁用
• 日志显示 enabled: false
• 飞书通道完全无法工作

解决方案：

🔴 双通道冲突问题

绝对不要把同一个 Bot 同时配置在 feishu 和 feishu-swarm 两个通道！

错误配置示例：

// ❌ 错误：同一个 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服务

✅ 实时双向消息转发

使用提示：

适用于：多机器人协作系统、建工项目管理、企业自动化流程等场景。