核心用法
feishu-bot-manager 是 OpenClaw 生态中专用于飞书机器人账户生命周期管理的技能，覆盖从机器人创建、认证凭据录入到多层级路由绑定的完整链路。
标准流程：用户首先在飞书开放平台网页创建机器人并获取 App ID 与 App Secret → 向技能提供凭据 → 选择「绑定现有 Agent」或「创建新 Agent」→ 指定账户级（全消息路由）或群聊级（单群精准路由）绑定模式 → 系统自动生成配置并提示重启 Gateway → 最终引导用户完成 /feishu auth 私聊授权。
命令行支持：除交互式对话外，技能暴露完整 CLI 接口，支持 --routing-mode account/group 一键切换，满足自动化部署场景。
显著优点
1. 分层路由灵活性：账户级与群聊级双模式并存，群聊级优先级更高，允许同一机器人按群隔离不同 Agent 服务域，实现「一机多能」。
2. Agent 生态闭环：创建新 Agent 时自动初始化治理文件体系（AGENTS.md/SOUL.md/MEMORY.md/USER.md/HEARTBEAT.md/TOOLS.md 及 .learnings/），强制规范后续运维。
3. 防御性配置管理：每次修改前自动备份 openclaw.json，误操作可快速回滚；session.dmScope 固定为 per-account-channel-peer，避免跨会话污染。
潜在缺点与局限性
- 外部依赖前置：必须依赖飞书开放平台网页端获取初始凭据，手动流程仅在用户明确拒绝网页时兜底，流程断裂风险存在。
- Gateway 重启卡点：配置生效依赖人工确认后重启 Gateway，自动化程度受限；若用户跳过确认直接重启，可能因配置未落地导致服务异常。
- 授权步骤易遗漏：
/feishu auth为飞书侧强制校验，但依赖用户主动操作，失败排查成本较高。 - 群聊 ID 获取门槛：群聊级绑定需要用户自行获取
oc_xxx格式群 ID，对非技术用户不够友好。
适合人群
- 企业内部 IT 管理员或开发者，需将飞书机器人接入 OpenClaw 多 Agent 架构
- 多业务线共享飞书租户、需按群隔离服务域的场景
- 追求 Agent 治理规范化的团队（需利用自动生成的治理文件模板）
常规风险
| 风险点 | 说明 |
|--------|------|
| 凭据泄露 | App Secret 在交互或 CLI 中明文传输，需确保终端环境安全 |
| 配置漂移 | 手动修改 `openclaw.json` 后未备份，与技能生成配置冲突 |
| 授权过期 | 飞书侧机器人权限调整或企业微信授权失效，需定期巡检 `/feishu auth` 状态 |
| 路由冲突 | 同一群聊同时匹配账户级与群聊级规则时，虽优先级已定义，但复杂配置仍可能引发预期外行为 |