核心用法
OpenClaw Swarm Layer 是一套面向复杂工作流的任务编排系统，核心工作流为 Spec → Plan → Run → Review → Report。用户以 Markdown 编写包含目标与阶段任务的规范文件，系统自动生成依赖排序的任务图；支持 [parallel] 阶段屏障实现并发控制。执行层提供 manual（手动回退） 与 acp（自动化） 双路径，通过 openclaw swarm run 派发任务，配合 session status 轮询直至完成。
会话管理 采用持久化设计，支持 binding-key 复用、线程绑定 follow-up 及 steering 消息注入，确保跨会话连续性。任务通过评审门控（approve/reject）流转，拒绝后自动返回 ready 状态支持重试；高级质量评估采用 4 维度加权评分（functionality 0.3 / correctness 0.3 / design 0.2 / craft 0.2）。
自动驾驶控制平面 提供 supervised autopilot 模式，支持 status/start/pause/resume/stop/tick 全生命周期管理，结合 watcher 模式实现事件驱动与轮询降级。并发保护通过 ACP 会话并发限制 + FIFO 队列实现；--parallel N 与 --all-ready 支持批量并行派发。
显著优点
- 规范驱动：Markdown 即代码，降低编排门槛
- 双模式执行：ACP 自动化优先，manual 安全兜底
- 持久化会话：任务级会话复用，减少环境冷启动
- GAN 式评估器：Sprint Contract + 自动注入 eval 任务，形成 coding→eval→next 的验证链
- 预算与不变性保护：任务字段不可变、执行时长与重试次数硬上限
- 丰富可观测性：本地 + Obsidian 双路报告，run/review/spec/completion 全链路归档
潜在缺点与局限性
- 单机限制：非分布式多节点编排器，无法横向扩展
- 非 CI/CD：无 Git 集成、PR 创建或部署自动化
- 人工依赖：评审决策必须由操作员完成，非完全自治
- 生态锁定：深度依赖 OpenClaw 运行时（>=2026.3.22）与 Node.js 22+
- 配置复杂度：harness 高级特性（evaluator、immutability、assumption tracking）需精细 JSON 配置
适合人群
- 需要复杂多阶段任务编排的开发者与团队
- 追求人机协作平衡、保留关键决策人工介入的 AI 辅助工作流用户
- 使用 Obsidian 进行知识管理的个人开发者
- 愿意投入学习成本以换取长期可维护性的技术团队
常规风险
- 版本漂移：OpenClaw 升级后可能出现 bridge 元数据不兼容，需定期执行
swarm doctor - 会话僵死：ACP 侧异常可能导致 running 任务挂起，需手动
session cancel或启用 watcher safety tick - 预算溢出：未配置
maxDurationSeconds可能导致长时间占用资源 - 并发配置误设：
--parallel与 ACP 并发限制不匹配可能导致队列饥饿或过度排队