核心用法
swarm-layer 是 OpenClaw 生态中的工作流编排引擎，通过 Markdown 规格文件定义目标与分阶段任务，自动生成依赖有序的任务图。支持双轨执行模式：ACP 自动化路径（默认）与 manual 人工回退路径。核心命令涵盖完整生命周期：
- 规划：
swarm plan --spec SPEC.md导入规格并生成任务图 - 执行：
swarm run --runner acp|manual支持单任务、并行批处理（--parallel N/--all-ready） - 会话管理：持久化会话支持绑定键复用、线程跟随、定向干预（
session follow-up/steer） - 审核门禁：任务完成需显式 approve/reject，支持加权多维度评分（functionality/correctness/design/craft）
- 自动驾驶：
autopilot start/pause/resume/stop实现受监督的自动化循环，可选 watcher 驱动 tick - 诊断报告：
doctor健康检查、status实时快照、report生成完整 Markdown 报告并同步 Obsidian
显著优点
1. 规格即代码：Markdown 规格文件降低使用门槛，同时保持机器可解析性
2. 执行灵活性：ACP 自动化与 manual 人工回退无缝切换，适应不同信任场景
3. 会话连续性：跨会话进度合成、启动引导序列、假设追踪，支持长周期复杂项目
4. 质量门禁：Sprint 合约（GAN 启发模式）自动注入验证任务，多维度加权评分替代二元判断
5. 防御性设计：任务字段不可变性保护、会话预算控制（时长+重试）、死信追踪、并发保护队列
潜在缺点与局限性
- 单节点架构：非分布式编排器，无法横向扩展至多机集群
- 非 CI/CD 工具：无 Git 集成、PR 创建、部署自动化能力
- 人机耦合：审核门禁强制 operator 参与，非完全自主的"PR 工厂"
- 生态依赖：深度绑定 OpenClaw 运行时（>=2026.3.22）与 Node.js >=22
- 学习曲线：Harness 增强模式（evaluator 注入、质量量规）需理解 GAN 风格验证模式
适合人群
- 需要结构化任务管理的独立开发者或小团队
- 追求AI 自动化与人工监督平衡的谨慎用户
- 使用 Obsidian 进行知识管理并希望工作流报告同步的个人
- 愿意投入学习规格驱动工作流的长期项目维护者
常规风险
| 风险场景 | 缓解措施 |
|---------|---------|
| ACP 就绪失败 | `swarm doctor --json` 前置检查，保留 manual 回退路径 |
| 任务僵死 | `session status` 轮询检测，`session cancel` 强制终止 |
| 会话孤儿 | `session cleanup --stale-minutes` 定期清理 |
| 版本漂移 | 升级后执行 `doctor` 清理遗留桥接元数据 |
| 预算超限 | 配置 `maxDurationSeconds`/`maxRetries`，关注 `[BUDGET EXCEEDED]` 标注 |