一个飞书 App ID 通常不能直接接入多个 OpenClaw

一个飞书 App ID 通常不能直接接入多个 OpenClaw 实例‌，原因如下：

• ‌飞书平台限制‌：飞书的自建应用（含机器人）在创建时会生成唯一的 App ID 和 App Secret，这些凭证与特定的回调 URL、事件订阅及长连接绑定。若尝试将同一组凭证用于多个 OpenClaw 网关（Gateway），会导致连接冲突、消息重复或认证失败。
• ‌OpenClaw 架构设计‌：OpenClaw 的 Gateway 采用“单一事实来源”（Single Source of Truth）架构，‌独占管理所有 Channel 连接‌（包括飞书的 WebSocket 或轮询连接），不支持多实例共享同一 Channel 配置 ‌。

✅ 正确做法：实现“一个飞书机器人服务多个智能体”

虽然不能用‌同一个 App ID 接多个 OpenClaw‌，但可以通过以下方式实现类似效果：

• ‌方案一：单 Bot 多 Agent 路由（推荐）‌
  • 仅创建‌一个飞书机器人‌（即一个 App ID）。
  • 在 OpenClaw 中创建‌多个智能体（Agent）‌。
  • 通过 bindings 配置，根据消息来源（如群组、用户）将请求路由到不同 Agent ‌612。
  • 示例命令：

方案二：多 Bot 独立部署（适用于强隔离场景）‌

• 为每个独立智能体‌分别创建一个飞书自建应用‌，获得多个 App ID。
• 每个 OpenClaw 实例绑定一个专属 App ID ‌212。
• 适用于团队协作、角色分离等高隔离需求场景。

注意事项

• ‌不要重复使用同一 App ID‌：这会导致飞书回调混乱、OpenClaw 网关连接异常 ‌8。
• ‌优先使用官方插件‌：OpenClaw 已内置 @openclaw/feishu 插件，功能更稳定，建议通过以下命令配置：