feishu-bot-manager

飞书多账户机器人配置管理 Skill。

路由绑定方案

方案 1：账户级绑定

该飞书账户的所有消息 → 指定 Agent

适用场景：一个机器人专门服务一个 Agent。比如创建一个"销售机器人"，它的所有消息都由"销售 Agent"处理。

生成的绑定：

{ "agentId": "recruiter", "match": { "channel": "feishu", "accountId": "bot-sales" } }

方案 2：群聊级绑定

特定群聊的消息 → 指定 Agent

适用场景：把 Agent 绑定到特定群聊。多个机器人在群里，但不同群聊分配给不同 Agent。

生成的绑定：

{ "agentId": "recruiter", "match": { "channel": "feishu", "peer": { "kind": "group", "id": "oc_xxx" } } }

注意：群聊级绑定优先级更高，会覆盖账户级绑定！

使用方式

交互模式（通过对话）

直接说："添加飞书机器人"

我会询问：

1. App ID 和 App Secret
2. 账户信息（账户 ID、机器人名称）
3. 选择路由绑定方案（账户级/群聊级）
4. 选择绑定的 Agent
5. 群聊 ID（如果选群聊级绑定）
6. 先做预览，再确认执行

命令行调用

# 账户级绑定 - 该机器人所有消息都由指定 Agent 处理
openclaw skills run feishu-bot-manager -- \
  --app-id cli_xxx \
  --app-secret yyy \
  --account-id bot-sales \
  --agent-id recruiter \
  --routing-mode account

# 群聊级绑定 - 特定群聊的消息由指定 Agent 处理
openclaw skills run feishu-bot-manager -- \
  --app-id cli_xxx \
  --app-secret yyy \
  --account-id bot-sales \
  --agent-id recruiter \
  --chat-id oc_xxx \
  --routing-mode group

参数说明

配置结构示例

添加新机器人后，配置会变成这样（保留现有配置）：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_现有",           // ← 保留不动
      "appSecret": "现有Secret",      // ← 保留不动
      "dmPolicy": "open",
      "accounts": {                    // ← 新添加
        "bot-new": {
          "appId": "cli_xxx",
          "appSecret": "yyy",
          "botName": "新机器人",
          "dmPolicy": "open",
          "allowFrom": ["*"],
          "enabled": true
        }
      }
    }
  },
  "bindings": [
    {                                  // ← 新添加
      "agentId": "recruiter",
      "match": {
        "channel": "feishu",
        "accountId": "bot-new"       // 或 "peer": { "kind": "group", "id": "oc_xxx" }
      }
    }
  ]
}

流程

1. 检查现有配置与潜在冲突
2. 备份现有配置
3. 添加新账户到 channels.feishu.accounts
4. 根据选择的路由模式添加 binding
5. 预览变更
6. 设置 session.dmScope 为 per-account-channel-peer
7. 重启 Gateway（可用 --no-restart 跳过）

注意事项

• 保留现有配置：现有 appId/appSecret 完全不动
• 自动备份：修改前自动备份 openclaw.json
• 冲突检测：默认检查账户/群聊/Agent 绑定冲突，必要时才用 --force
• dry-run：建议先用 --dry-run 预览，再正式写入
• dmScope 设置：自动设置会话绑定颗粒度
• 重启 Gateway：重启后约 10-30 秒恢复服务，可用 --no-restart 跳过
• 恢复方法：如出问题可用备份文件手动恢复