核心用法
OpenClaw Swarm Layer 是官方推出的 spec-driven 工作流编排系统，通过声明式规约驱动多阶段任务执行。用户编写 Markdown 格式的规约文件（Goals + Phases），系统将其解析为任务图并协调执行。核心命令覆盖完整生命周期：plan 导入规约生成任务、status 查看就绪状态、run 触发执行（支持 manual/acp/subagent 三种 runner）、review 完成人工审核关卡、session 系列命令管理持久化会话。
三种执行模式：manual 人工执行并记录；acp 委托外部 Agent 框架（如 Codex）；subagent OpenClaw 原生子代理。支持会话复用策略（none/create_persistent/reuse_if_available/require_existing），避免重复初始化开销。
显著优点
- 官方生态集成：作为 OpenClaw 官方插件，与 CLI 深度整合，版本兼容性有保障
- 生产级可靠性：内置自动重试、死信队列、孤儿会话清理、会话保活机制
- 灵活审核关卡：强制人工介入节点，防止自动化流程失控
- 可观测性完善：结构化 JSON 输出、实时状态轮询、多维度报告（Markdown/Obsidian 同步）
- 渐进式采用：从纯 manual 模式起步，逐步迁移到 ACP/subagent 自动化
潜在缺点与局限性
- 版本锁定严格：
bridge.versionAllow需显式维护，OpenClaw 升级后易触发 blocked 状态 - 配置门槛较高：bridge 配置涉及 node 路径、全局 npm 根目录等系统级参数，新手易配错
- 依赖外部 ACP：acp 模式需外部 Agent 框架支持，调试链路跨系统复杂
- Obsidian 同步为异步：报告镜像非实时，存在最终一致性延迟
- 子代理生态早期：subagent 模式相比 manual/acp 成熟度待验证
适合人群
- DevOps/SRE 工程师：需要编排复杂部署、配置变更等多阶段工作流
- AI Agent 开发者：构建需要人机协作审核的自动化流水线
- 团队技术负责人：寻求可审计、可回滚的团队级任务执行标准
- Obsidian 用户：希望将执行日志、审核记录自动归档到知识库
常规风险
| 风险场景 | 说明 | 缓解措施 |
|---------|------|---------|
| 版本漂移阻断执行 | OpenClaw 升级后 bridge.versionAllow 未更新 | 升级后首执行 `doctor --json` 并按 remediation 修复 |
| 会话死锁 | ACP 外部进程异常退出导致 session 僵死 | 设置 `--stale-minutes` 定期清理，配合 `session cancel` 强制终止 |
| 审核绕过 | 误用 `--approve` 批量通过未检视任务 | 保持 review gate 强制开启，关键任务要求双人复核 |
| 敏感信息泄露 | 规约或日志含密钥/凭证 | 启用 spec archive 前审查，避免 Obsidian 同步敏感项目 |
| 子代理权限扩散 | subagent 继承过度权限 | 最小权限原则配置 allowedAgents，定期审计 session 权限边界 |