核心用法
Agent Swarm Network 是 OpenClaw 生态系统的统一通信骨干,类比为 Agent 的神经系统。该 Skill 建立在 Pilot Protocol 之上,通过 ~/.pilot/bin/pilotctl 二进制提供完整的 Agent 间通信能力。
主要功能模块:
1. 上下文快照与恢复:在会话结束时自动保存关键上下文,新会话自动从 ~/.pilot/inbox/ 恢复。支持手动快照和上下文溢出处理(当 token 使用超过 80% 时触发)。
2. 事件驱动协作:通过 pilot-publish.sh 发布标准化事件(model.switch、task.complete、context.compaction 等),支持订阅模式和实时 webhook 推送。
3. 子 Agent 管理:采用命名约定 keke-sub-{purpose} 创建子 Agent,通过消息传递协调任务结果。
4. 任务路由:基于标签系统(orchestrator、deep-reasoning、code-gen、fast、chinese 等)智能匹配 Agent 能力。
5. 文件传输:通过 send-file 命令在 Agent 间安全传输文件,存储于 ~/.pilot/received/。
6. 网关桥接:将本地服务(如 LM Studio)通过用户空间端口映射为 Pilot 地址,实现统一入口。
显著优点
- 端到端加密:X25519 密钥交换 + AES-256-GCM 加密,无需中继服务器
- 零信任架构:Agent 默认私有,需双向信任握手才能通信
- 灵活部署:支持单节点本地模式和多节点分布式网络
- 标准化事件流:12 类标准事件主题,便于构建可观测的 Agent 系统
- 上下文连续性:解决大模型会话上下文窗口限制,实现长期记忆
潜在缺点与局限性
- 当前单节点限制:v1.0.4 版本仅支持单节点运行,
send-message和publish命令对自身发送会失败,需使用脚本变通方案 - 手动安全加固:快照为未加密 JSON,需用户自行设置
chmod 700 ~/.pilot - 供应链风险:建议从源码构建 Pilot Protocol 以消除预编译二进制风险
- 学习曲线陡峭:涉及 CLI 操作、配置文件管理、网络诊断等多层技术栈
适合人群
- 构建多 Agent 协作系统的开发者
- 需要跨会话上下文持久化的复杂任务场景
- OpenClaw / Antigravity / Codex 生态的深度用户
- 对隐私和端到端加密有强要求的 AI 基础设施搭建者
常规风险
- 文件系统暴露:默认路径
~/.pilot/若权限设置不当可能导致快照泄露 - 守护进程稳定性:需每 30 分钟检查心跳,失败时手动重启
- 网络配置复杂:NAT 穿透、rendezvous 服务器自托管需要额外运维能力
- 版本兼容性:Pilot Protocol 版本迭代可能影响 Skill 功能稳定性
---
技术架构说明
该 Skill 本质是 Pilot Protocol 的封装层,核心依赖包括:
pilotctlCLI 工具(Go 编译)- 本地 Unix socket 守护进程通信
- UDP 加密隧道(AES-256-GCM)
- 可选的自托管 rendezvous 注册表
所有命令强制使用 --json 标志输出结构化数据,便于程序化解析。