{"skill":{"slug":"feishu-bot-manager-cn","displayName":"Feishu Bot Manager CN","summary":"管理 OpenClaw 中的飞书机器人账户与路由绑定。用于新增飞书机器人账号、把机器人账户级或群聊级绑定到指定 Agent，或在创建新机器人时顺带创建一个全新的独立 Agent 工作区。用户提到“绑定新飞书机器人”“新增飞书机器人”“把机器人绑到某个 Agent”“给某个群绑定 Agent”时使用。","description":"---\nname: feishu-bot-manager\ndescription: 管理 OpenClaw 中的飞书机器人账户与路由绑定。用于新增飞书机器人账号、把机器人账户级或群聊级绑定到指定 Agent，或在创建新机器人时顺带创建一个全新的独立 Agent 工作区。用户提到“绑定新飞书机器人”“新增飞书机器人”“把机器人绑到某个 Agent”“给某个群绑定 Agent”时使用。\n---\n\n# feishu-bot-manager\n\n飞书多账户机器人配置管理 skill。\n\n## 优先路径\n\n当用户说“绑定一个新的飞书机器人”时，先引导用户去网页创建机器人：\n\n- https://open.feishu.cn/page/openclaw?form=multiAgent\n\n网页会给出 App ID 和 App Secret。拿到这两个值之后，再继续绑定流程。\n\n示例回复：\n\n```text\n新机器人先去这里创建：https://open.feishu.cn/page/openclaw?form=multiAgent\n\n拿到 App ID 和 Secret 后发我，我再帮你继续绑定。\n\n*是否要绑定到现有 agent，也可以一起告诉我。*\n```\n\n只有在用户明确说“我不想用网页”或“网页打不开”时，才走纯手动流程。\n\n## 两种绑定方式\n\n### 账户级绑定\n\n该飞书账户的所有消息 → 指定 Agent\n\n适合一个机器人专门服务一个 Agent。\n\n生成的 binding 示例：\n\n```json\n{ \"agentId\": \"recruiter\", \"match\": { \"channel\": \"feishu\", \"accountId\": \"bot-sales\" } }\n```\n\n### 群聊级绑定\n\n特定群聊的消息 → 指定 Agent\n\n适合把某个群单独分配给某个 Agent。\n\n生成的 binding 示例：\n\n```json\n{ \"agentId\": \"recruiter\", \"match\": { \"channel\": \"feishu\", \"peer\": { \"kind\": \"group\", \"id\": \"oc_xxx\" } } }\n```\n\n注意：**群聊级绑定优先级高于账户级绑定**。\n\n## 收集信息顺序\n\n拿到 App ID / App Secret 后，按这个顺序收集：\n\n1. App ID 和 App Secret\n2. **先问：绑定到现有 Agent，还是创建新的 Agent？**\n   - 如果是现有 Agent：直接问要绑定到哪个 Agent\n   - 如果是新 Agent：问新 Agent 的名称、用途、期望的 agentId（可给默认值）\n3. 路由方式：账户级 / 群聊级\n4. 群聊 ID（仅群聊级需要）\n5. 机器人名称（可选）\n6. 给出预览，用户确认后执行\n7. **重启 Gateway 前再次确认**\n\n确认时的回复里，最下面加一行小字：\n\n```text\n*是否要绑定到现有 agent？*\n```\n\n## 创建新 Agent 时的额外要求\n\n如果用户选择“创建新的 Agent”，除了写入 OpenClaw 配置，还必须初始化对应工作区文件，并把治理规则写进合适的文件。\n\n创建新 Agent 时，读取并遵守：\n\n- `references/new-agent-governance.md`\n\n重点包括：\n\n- `AGENTS.md`：任务响应规范、复杂任务优先子代理、修改后先验证、skill-vetter 强制审查、问题升级策略、定时任务与稳定性规则\n- `SOUL.md`：风格、边界感、群聊克制发言、长任务先告知再执行\n- `MEMORY.md`：两层记忆规则、长期信息提炼、必须写文件而不是只靠会话记忆\n- `USER.md`：用户偏好、禁忌、长期习惯\n- `HEARTBEAT.md`：仅放轻量、幂等、低副作用周期任务\n- `TOOLS.md`：环境专属信息\n- `.learnings/`：初始化 `LEARNINGS.md`、`ERRORS.md`、`FEATURE_REQUESTS.md`\n\n## 执行流程\n\n1. 检查并备份现有配置\n2. 如果需要，创建新的 Agent 工作区与基础文件\n3. 添加新账户到 `channels.feishu.accounts`\n4. 根据选择的路由模式添加 binding\n5. 设置 `session.dmScope` 为 `per-account-channel-peer`\n6. 告诉用户配置已改好，**重启 Gateway 前先确认**\n7. 重启完成后，提醒用户去新机器人的私聊发送 `/feishu auth`\n\n## 绑定完成后的固定提醒\n\n每次新机器人创建/绑定完成后，都必须提醒用户：\n\n```text\n请去新机器人的私聊窗口发送 /feishu auth 进行授权，否则机器人无法正常使用。\n```\n\n## 命令行调用\n\n```bash\n# 账户级绑定 - 该机器人所有消息都由指定 Agent 处理\nopenclaw skills run feishu-bot-manager -- \\\n  --app-id cli_xxx \\\n  --app-secret yyy \\\n  --account-id bot-sales \\\n  --agent-id recruiter \\\n  --routing-mode account\n\n# 群聊级绑定 - 特定群聊的消息由指定 Agent 处理\nopenclaw skills run feishu-bot-manager -- \\\n  --app-id cli_xxx \\\n  --app-secret yyy \\\n  --account-id bot-sales \\\n  --agent-id recruiter \\\n  --chat-id oc_xxx \\\n  --routing-mode group\n```\n\n## 参数说明\n\n| 参数 | 必填 | 说明 |\n|------|------|------|\n| --app-id | ✅ | 飞书 App ID (cli_xxx) |\n| --app-secret | ✅ | 飞书 App Secret |\n| --account-id | ❌ | 账户标识，默认自动生成 |\n| --bot-name | ❌ | 机器人名称，默认 `Feishu Bot` |\n| --dm-policy | ❌ | DM 策略: open / pairing / allowlist，默认 open |\n| --agent-id | ❌ | 要绑定的 Agent ID |\n| --chat-id | ❌ | 群聊 ID (oc_xxx)，群聊绑定时需要 |\n| --routing-mode | ❌ | 路由模式: account / group，默认 account |\n\n## 注意事项\n\n- 保留现有配置，不覆盖已有主账号配置\n- 修改前自动备份 `openclaw.json`\n- 绑定新机器人后，重启 Gateway 前必须再次确认\n- 完成后必须提醒用户去机器人私聊发送 `/feishu auth`\n- 如配置有误，可用备份文件手动恢复\n","tags":{"latest":"1.1.0"},"stats":{"comments":0,"downloads":989,"installsAllTime":37,"installsCurrent":4,"stars":0,"versions":1},"createdAt":1773600826810,"updatedAt":1778491928981},"latestVersion":{"version":"1.1.0","createdAt":1773600826810,"changelog":"Add guided new-bot flow, new-agent governance rules, gateway restart confirmation, and /feishu auth reminder.","license":"MIT-0"},"metadata":null,"owner":{"handle":"alex-shen1121","userId":"s17e8rt3ehqr1jwgx55v915cb983gp22","displayName":"AlexShen","image":"https://avatars.githubusercontent.com/u/73343630?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089901223}}