OpenClaw Swarm Layer 综合评估
核心用法
OpenClaw Swarm Layer 是一个面向单项目、单机的规约驱动型工作流编排引擎，核心定位是将 Markdown 格式的工作流规约（Spec）转化为可执行的任务图（Task Graph）。用户通过 swarm plan 导入规约后，系统生成依赖排序的任务链，支持 manual（人工）与 ACP（自动化控制平面）双路径执行。执行层提供完整的会话管理：持久化会话支持绑定键复用、线程跟随、定向消息注入；任务完成需经审查关卡（approve/reject），支持多维度加权评分（functionality/correctness/design/craft）。系统内置自动重试、死信追踪、并行批量调度（--parallel N/--all-ready）、ACP并发保护队列等机制，并可选开启监督式自动驾驶（Autopilot）控制平面，实现 lease 背书的策略化自动推进。
显著优点
1. 执行模式灵活：双轨制 runner（ACP 自动化 + manual 人工回退）兼顾效率与可控性，ACP 路径完整接入 OpenClaw 公共 ACP 控制平面。
2. 会话治理精细：持久化会话、跨会话连续性（progress.json 合成、启动引导序列）、会话预算控制（时长+重试次数）、会话复用策略（create_persistent/reuse_if_available/require_existing）满足复杂长时任务场景。
3. 质量管控体系化：审查关卡强制化，支持 GAN 启发的 Sprint 契约（可验证验收标准自动生成）、自动评估器注入（-eval 任务链）、四维加权质量评分，避免二元化粗糙审批。
4. 健壮性机制完备：自动重试（per-task 策略）、死信追踪、并发保护（ACP 会话限流+FIFO 队列）、任务字段不可变保护（enforceTaskImmutability）、假设追踪生命周期管理。
5. 可观测与报告：本地化 Markdown 报告（swarm-report.md/run-log.md/review-log.md/completion-summary.md）+ Obsidian 双向同步，支持操作员级状态快照与诊断。
潜在缺点与局限性
1. 非分布式架构：明确限制单机单项目，无法横向扩展至多节点集群，不适合大规模分布式 CI/CD 场景。
2. 非完整 DevOps 链路：无 Git 推送、PR 创建、部署自动化能力，定位是"本地工作流编排"而非 CI/CD 流水线。
3. 人工回路强制：审查决策必须由操作员（operator）执行，非完全自主的"PR 工厂"，自动化天花板受限于人工审批节奏。
4. 生态锁定：深度绑定 OpenClaw 运行时（Node >= 22, OpenClaw >= 2026.3.22），ACP 能力依赖 OpenClaw 公共控制平面，外部替代方案兼容性未明。
5. 配置复杂度：harness 高级特性（evaluator 注入、Sprint 契约、质量评分）需 JSON 级配置，学习曲线陡峭，易因配置不当导致预期外行为。
适合人群
- AI 辅助开发个体/小团队：需要将大模型代码生成纳入结构化工作流，同时保留人工审查权的开发者。
- 规约驱动型项目管理：偏好 Markdown 声明式规约、需要任务依赖图自动生成与可视化追踪的项目经理。
- 长时会话场景用户：涉及多轮会话、上下文复用、跨会话连续性需求的复杂 feature 开发或重构任务。
- Obsidian 知识管理用户：希望开发日志、审查记录与知识库双向同步的笔记重度用户。
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 会话资源泄漏 | 异常退出导致孤儿会话堆积 | 配置 `--stale-minutes` 定期 `session cleanup` |
| 预算超限逃逸 | `maxDurationSeconds`/`maxRetries` 配置疏漏导致无限重试 | 项目初始化时强制配置预算字段 |
| ACP 就绪误判 | `doctor` 报告 healthy 但 ACP 实际不可用（桥接配置残留） | 升级后执行 `doctor --json` 清理 legacy bridge 元数据 |
| 任务状态误迁移 | 手动数据库操作或插件异常导致状态机违规 | 启用 `enforceTaskImmutability`，避免直接修改 `.openclaw/swarm/` 原始文件 |
| 并行调度竞态 | `--parallel`/`--all-ready` 高并发下 ACP 会话限流触发队列堆积 | 监控 `swarm status` attention 区，及时调整 `acp.concurrency` 配额 |
| 报告数据敏感泄露 | Obsidian 同步路径配置错误导致报告写入公共目录 | 验证 `obsidianRoot` 指向私有 vault 子目录，避免使用云同步根目录 |