核心用法
Feishu Bot Manager 是 OpenClaw 生态中专用于飞书机器人全生命周期管理的运维工具，提供完整的 CRUD 操作能力。管理员可通过自然语言指令（如"添加飞书机器人"、"删除飞书机器人"）或底层脚本直接操作，无需手动编辑 JSON 配置文件。
关键操作流程
| 操作 | 触发方式 | 核心参数 |
|:---|:---|:---|
| 添加机器人 | `添加飞书机器人：botId, appId=xxx, appSecret=xxx` | `botId`（唯一标识）、`appId`/`appSecret`（飞书应用凭证）、`model`（可选，默认 bailian-coding-plan/glm-5） |
| 删除机器人 | `删除飞书机器人：botId` | 仅需 `botId` |
| 修改配置 | `修改飞书机器人：botId, model=xxx` 等 | 支持增量更新任一字段 |
| 查看列表 | `列出所有飞书机器人` | 无参数 |
| 查看详情 | `查看飞书机器人：botId` | 仅需 `botId` |
底层调用统一封装为 {baseDir}/scripts/feishu-bot.sh，所有修改操作自动创建时间戳备份（格式：openclaw.json.bak.YYYY.MMdd.HHmm，UTC+8），变更后需执行 openclaw gateway restart 生效。
显著优点
1. 零配置学习成本：自然语言触发覆盖中英双语，降低非技术管理员使用门槛
2. 数据安全保障：每次变更前自动备份，支持人工回滚；依赖 jq 确保 JSON 操作原子性
3. 灵活的模型绑定：支持按机器人粒度指定 AI 模型，实现不同业务场景的精细化调度
4. 脚本化集成：标准 CLI 接口便于嵌入 CI/CD 流水线或自动化运维体系
潜在局限
- 网关重启依赖：配置变更后必须手动重启 gateway，无法实现热更新
- 凭证明文管理：
appSecret需通过指令传入，存在终端历史记录泄露风险 - 单文件配置架构：所有机器人集中存储于
openclaw.json，高并发修改可能引发竞态条件 - 无权限分级：当前实现未内置 RBAC，任何能执行指令的用户均可管理全部机器人
适合人群
- OpenClaw 平台管理员：需要批量维护飞书机器人配置的运维人员
- 企业 IT 自动化团队：寻求将 IM 机器人管理纳入 Infrastructure as Code 实践的 DevOps 工程师
- 多业务线 AI 应用负责人：需为不同飞书群聊分配差异化模型能力的业务管理员
常规风险
| 风险类别 | 具体描述 | 缓解建议 |
|:---|:---|:---|
| 凭证泄露 | `appSecret` 可能在 shell 历史、日志中残留 | 使用环境变量或密钥管理服务中转 |
| 配置损坏 | `jq` 异常或手动编辑导致 JSON 语法错误 | 修改前确认备份存在，优先使用工具提供的 CRUD 接口 |
| 服务中断 | 重启 gateway 期间机器人不可用 | 选择低峰期操作，或采用网关集群滚动更新 |
| 误删恢复 | 删除操作不可逆，虽有备份但需手动还原 | 执行删除前二次确认 `botId`，建立变更审批流程 |