核心用法
feishu-multi-agent 是一套完整的 OpenClaw 多 Agent 生产部署方案，采用"包工头-下属"层级架构：
1. 飞书绑定：每个 Agent 独立飞书自建应用，通过 WebSocket 实时交互
2. 层级调度：main 包工头通过 bash 命令向各 Agent 的 tasks/pending/ 目录写入任务文件，避免 Write 工具的沙箱限制
3. 持续工作流：各下属 Agent 配置 HEARTBEAT.md，被 cron 高频触发后自动检查任务队列，有活干活、无活自主找活
4. 状态巡查：包工头定期用 openclaw sessions 和 ls 检查下属状态，动态派活或催进度
显著优点
- 生产验证充分：7 个 Agent（包工头+游戏工厂+出版社+虾妹+炒币/股+猎头）长期稳定运行
- 架构清晰：文件驱动任务队列天然解耦，Agent 崩溃不丢任务；cron 编排实现真正的持续自动化而非单次执行
- 沙箱绕过方案完整：明确区分 Write 工具限制与 bash 写文件的适用场景，附目录迁移+symlink 的最佳实践
- 故障排查系统：涵盖 WebSocket 断连、token 失效、消息去重、context 溢出等 7 类典型问题的诊断与恢复命令
潜在局限
- 飞书强依赖：需企业管理员权限批量创建应用，个人开发者门槛较高
- cron 密度权衡：高频触发（如 20 分钟）易累积上下文，需配合
--session isolated使用 - 调试复杂度：多 Agent 交织运行时，定位问题需熟练运用
openclaw sessions/cron/list等 CLI
适合人群
- 需要让 AI Agent 7×24 持续产出内容的团队（内容生产、游戏开发、研究写作）
- 已掌握 OpenClaw 基础、希望从"对话式"升级到"自动化团队"的中高级用户
- 具备 Linux 运维能力、能接受 YAML/JSON 配置的工程师
常规风险
| 风险项 | 说明 | 缓解措施 |
|--------|------|---------|
| 沙箱误用 | 用 Write 工具跨 workspace 写文件触发失败 | 强制使用 bash `cat >` 命令 |
| Session 类型混淆 | main session cron 误用 `--message` | 严格区分 `--system-event` vs `--message` |
| 飞书断连静默 | WebSocket 假死无自动重连 | 每日检查日志+定时重启 gateway |
| Context 膨胀 | 长期运行导致回复质量下降 | 监控 `ctx %`，超标时开 isolated session |