核心用法
OpenClaw Swarm 是基于 OpenClaw 的分支项目，专注于高级子代理编排。它提供了一套完整的工具集，让开发者能够像编排分布式系统一样管理多个 AI 子代理。
四大核心能力：
1. 上下文共享（contextSharing） - 父会话可将上下文以四种粒度传递给子代理：none（零上下文）、summary（压缩摘要）、recent（最近消息）、full（完整历史），灵活控制信息暴露。
2. 状态存储（context_store） - 跨代理键值存储，支持 set/get/delete/list/subscribe/broadcast 操作，实现子代理间的数据流转与状态同步。
3. 事件通知（context_publish） - 基于发布-订阅模式，子代理完成任务后可主动向编排器推送事件，消除轮询开销。
4. 并行调度（parallel_spawn） - 一键启动多子代理，支持 all（全等待）、any（首响应）、race（竞速）三种等待策略。
显著优点
- 无轮询架构：自动完成通知机制大幅降低系统复杂度和资源消耗
- 灵活的上下文控制：四种共享模式兼顾效率与信息完整性
- 声明式并行：类似 Promise.all/race 的语义，降低并发编程心智负担
- 开源可审计：基于 OpenClaw 分叉，代码透明
局限性与风险
- 生态成熟度：作为 fork 项目，社区支持、长期维护承诺存疑
- 调试复杂度：多代理状态交织，故障追踪难度高于单代理
- 资源消耗：并行子代理可能快速耗尽上下文窗口和 API 配额
- 竞态条件：
any/race模式可能导致非确定性结果，需幂等设计
适合人群
- 构建复杂工作流自动化系统的开发者
- 需要并行信息检索（如同时搜索多源）的场景
- 多步骤链式处理任务（ETL、文档生成、代码审查等）
常规风险
| 风险类型 | 说明 |
|---------|------|
| 成本失控 | 并行任务叠加导致 Token 消耗激增 |
| 状态污染 | 共享命名空间可能被意外覆盖 |
| 死锁/饥饿 | 子代理相互等待依赖数据 |
| 提示注入 | `full` 上下文共享可能泄露敏感历史 |