核心用法
Swarm Layer 是 OpenClaw 生态中的工作流编排引擎，采用规格驱动（Spec-driven）设计理念。用户以 Markdown 编写包含目标与分阶段任务的规格文件，系统自动生成依赖排序的任务图。执行层提供双轨机制：ACP 自动化路径为默认-capable 的代理执行通道，manual 人工回退作为安全兜底。通过 openclaw swarm plan 导入规格、run 触发执行、review 完成审批门控，形成完整的 Plan-Run-Review 循环。
会话管理是核心差异化能力：支持持久化会话的绑定键复用、线程绑定跟进任务（follow-up）与转向消息（steer），实现跨会话连续性。自动状态机驱动任务流转：ready → running → pending_review → done/failed，拒绝审批可触发重试流程并返回 ready 状态。
显著优点
1. 审查与质量控制：内置显式 approve/reject 门控，可选质量评分矩阵（功能/正确性/设计/工艺四维度加权），满足高可靠性场景需求。
2. 弹性执行策略：支持 --parallel N 与 --all-ready 批量调度、自动重试机制（含死信追踪）、并发保护（ACP 会话队列限流）。
3. 监督式自动驾驶：Autopilot 控制平面提供 start/pause/resume/stop/tick 全生命周期管理，支持 lease-backed 决策与 watcher 驱动模式，兼顾自动化与可控性。
4. 可观测性：本地报告（Markdown）与 Obsidian 可选同步，覆盖状态快照、运行日志、审查日志、规格归档与完成摘要。
潜在缺点与局限性
- 单机约束：非分布式多节点编排器，限于单项目单机器执行，无法替代 Kubernetes 或大规模分布式工作流引擎。
- 非 CI/CD 工具：无 Git 推送、PR 创建、部署自动化能力，需与外部 DevOps 工具链配合使用。
- 人工回路强制：设计哲学要求操作员始终参与审查决策，非完全自主的 "PR 工厂"，自动化天花板受限于人工审批延迟。
- 生态锁定：深度绑定 OpenClaw 运行时（>= 2026.3.22）与 Node.js >= 22，跨平台移植性有限。
适合人群
- AI 辅助开发团队：需结构化管理多步骤编码任务、要求人机协作审查的工程师。
- 研究/实验型工作流：任务需要可复现、可审计的执行轨迹，且偏好 Markdown 优先的规格管理。
- OpenClaw 生态用户：已采用 OpenClaw 作为 AI 代理运行时的开发者，寻求本地优先、可控的编排增强。
常规风险
- ACP 可用性依赖：自动化路径依赖 ACP 控制平面的公开出口与代理就绪状态，
doctor需定期监控。 - 会话泄漏：异常终止可能导致会话孤儿，需配置
--stale-minutes清理策略。 - 预算超限：
maxDurationSeconds与maxRetries配置不当可能导致资源耗尽或无限重试循环。 - 配置漂移：OpenClaw 版本升级后可能出现桥接层兼容性警告，需按
remediation指引清理遗留元数据。