核心用法
OpenClaw Swarm Layer 是一款面向单项目场景的 spec-driven 工作流编排工具，核心能力是将 Markdown 格式的工作流规范转化为依赖排序的任务图并执行。用户通过 plan 命令导入规范生成任务，run 命令选择 manual 或 acp 两种执行模式，并通过 review 完成质量门控。工具支持会话持久化与复用、并行任务调度（--parallel N）、自动重试与死信追踪，以及可选的 Autopilot 监督式自动循环控制。
显著优点
- Spec-first 设计：纯 Markdown 定义目标与阶段，降低编排门槛
- 双轨执行：ACP 自动化路径与 manual 安全兜底并存，兼顾效率与可控性
- 丰富门控机制：支持二进制 approve/reject 及四维度加权质量评分
- 会话管理完善：binding-key 复用、线程绑定、steering 消息注入，适合长周期任务
- 可观测性强：结构化状态查询、多格式报告（本地 + Obsidian 同步）、运行日志与审查日志自动归档
- 防护机制：任务字段不可变性保护、会话预算控制（时长 + 重试次数）、ACP 并发保护
潜在缺点与局限性
- 单节点限制：明确非分布式多节点编排器，无法横向扩展
- 非 CI/CD 工具：无 git push、PR 创建、部署自动化等流水线能力
- 人工依赖：审查决策必须由操作员确认，非完全自主的 "PR 工厂"
- 生态锁定：深度绑定 OpenClaw 运行时（要求 Node ≥22、OpenClaw ≥2026.3.22），跨平台移植性受限
- 配置复杂度：Harness 高级特性（GAN 模式、Sprint Contracts、Evaluator 注入）需额外 JSON 配置，学习曲线较陡
适合人群
- 需要结构化编排复杂多阶段开发任务的软件团队
- 追求自动化但要求关键节点人工确认的安全敏感场景
- 已使用 OpenClaw 生态、希望获得比裸 ACP 更强流程控制的开发者
- 需要会话状态持久化与跨运行上下文继承的长期工作流场景
常规风险
- 版本漂移：OpenClaw 升级后可能出现 bridge 元数据兼容性问题，需运行
doctor诊断并清理旧配置 - 会话泄漏：异常终止可能导致孤儿会话，需定期
cleanup或配置 stale 自动清理 - 预算耗尽：未配置
maxDurationSeconds/maxRetries可能导致资源无限占用 - ACP 就绪性：自动化路径依赖公共 ACP 导出就绪状态，配置不当会静默回退或失败
- 数据丢失风险：报告与日志默认本地存储，Obsidian 同步为异步镜像，关键数据需额外备份策略