feishu-bot-manager
飞书多账户机器人配置管理 skill。
优先路径
当用户说“绑定一个新的飞书机器人”时，先引导用户去网页创建机器人：
网页会给出 App ID 和 App Secret。拿到这两个值之后，再继续绑定流程。
示例回复：
新机器人先去这里创建：https://open.feishu.cn/page/openclaw?form=multiAgent
拿到 App ID 和 Secret 后发我，我再帮你继续绑定。
*是否要绑定到现有 agent，也可以一起告诉我。*
只有在用户明确说“我不想用网页”或“网页打不开”时，才走纯手动流程。
两种绑定方式
账户级绑定
该飞书账户的所有消息 → 指定 Agent
适合一个机器人专门服务一个 Agent。
生成的 binding 示例：
{ "agentId": "recruiter", "match": { "channel": "feishu", "accountId": "bot-sales" } }
群聊级绑定
特定群聊的消息 → 指定 Agent
适合把某个群单独分配给某个 Agent。
生成的 binding 示例：
{ "agentId": "recruiter", "match": { "channel": "feishu", "peer": { "kind": "group", "id": "oc_xxx" } } }
注意：群聊级绑定优先级高于账户级绑定。
收集信息顺序
拿到 App ID / App Secret 后，按这个顺序收集：
- App ID 和 App Secret
- 先问：绑定到现有 Agent，还是创建新的 Agent？
- 如果是现有 Agent：直接问要绑定到哪个 Agent
- 如果是新 Agent：问新 Agent 的名称、用途、期望的 agentId（可给默认值）
- 路由方式：账户级 / 群聊级
- 群聊 ID（仅群聊级需要）
- 机器人名称（可选）
- 给出预览，用户确认后执行
- 重启 Gateway 前再次确认
确认时的回复里，最下面加一行小字：
*是否要绑定到现有 agent？*
创建新 Agent 时的额外要求
如果用户选择“创建新的 Agent”，除了写入 OpenClaw 配置，还必须初始化对应工作区文件，并把治理规则写进合适的文件。
创建新 Agent 时，读取并遵守：
references/new-agent-governance.md
重点包括：
AGENTS.md：任务响应规范、复杂任务优先子代理、修改后先验证、skill-vetter 强制审查、问题升级策略、定时任务与稳定性规则SOUL.md：风格、边界感、群聊克制发言、长任务先告知再执行MEMORY.md：两层记忆规则、长期信息提炼、必须写文件而不是只靠会话记忆USER.md：用户偏好、禁忌、长期习惯HEARTBEAT.md：仅放轻量、幂等、低副作用周期任务TOOLS.md：环境专属信息.learnings/：初始化LEARNINGS.md、ERRORS.md、FEATURE_REQUESTS.md
执行流程
- 检查并备份现有配置
- 如果需要，创建新的 Agent 工作区与基础文件
- 添加新账户到
channels.feishu.accounts - 根据选择的路由模式添加 binding
- 设置
session.dmScope为per-account-channel-peer - 告诉用户配置已改好，重启 Gateway 前先确认
- 重启完成后，提醒用户去新机器人的私聊发送
/feishu auth
绑定完成后的固定提醒
每次新机器人创建/绑定完成后，都必须提醒用户：
请去新机器人的私聊窗口发送 /feishu auth 进行授权，否则机器人无法正常使用。
命令行调用
# 账户级绑定 - 该机器人所有消息都由指定 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 |
注意事项
- 保留现有配置，不覆盖已有主账号配置
- 修改前自动备份
openclaw.json - 绑定新机器人后，重启 Gateway 前必须再次确认
- 完成后必须提醒用户去机器人私聊发送
/feishu auth - 如配置有误，可用备份文件手动恢复