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" } } }
注意：群聊级绑定优先级更高，会覆盖账户级绑定！
使用方式
交互模式（通过对话）
直接说："添加飞书机器人"
我会询问：
- App ID 和 App Secret
- 账户信息（账户 ID、机器人名称）
- 选择路由绑定方案（账户级/群聊级）
- 选择绑定的 Agent
- 群聊 ID（如果选群聊级绑定）
- 先做预览，再确认执行
命令行调用
# 账户级绑定 - 该机器人所有消息都由指定 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
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
| --app-id | ✅ | 飞书 App ID (cli_xxx) |
| --app-secret | ✅ | 飞书 App Secret |
| --account-id | ❌ | 账户标识，默认自动生成 |
| --bot-name | ❌ | 机器人名称，默认 "Feishu Bot" |
| --dm-policy | ❌ | DM 策略: open/pairing/allowlist，默认 open |
| --agent-id | ❌ | 要绑定的 Agent ID |
| --chat-id | ❌ | 群聊 ID (oc_xxx)，群聊绑定时需要 |
| --routing-mode | ❌ | 路由模式: account/group，默认 account |
配置结构示例
添加新机器人后，配置会变成这样（保留现有配置）：
{
"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" }
}
}
]
}
流程
- 检查现有配置与潜在冲突
- 备份现有配置
- 添加新账户到
channels.feishu.accounts - 根据选择的路由模式添加 binding
- 预览变更
- 设置
session.dmScope为per-account-channel-peer - 重启 Gateway（可用
--no-restart跳过）
注意事项
- 保留现有配置：现有
appId/appSecret完全不动 - 自动备份：修改前自动备份 openclaw.json
- 冲突检测：默认检查账户/群聊/Agent 绑定冲突，必要时才用
--force - dry-run：建议先用
--dry-run预览，再正式写入 - dmScope 设置：自动设置会话绑定颗粒度
- 重启 Gateway：重启后约 10-30 秒恢复服务，可用
--no-restart跳过 - 恢复方法：如出问题可用备份文件手动恢复