Agent Swarm Network

🌐 多 Agent 通信与上下文持久化中枢

Agent Swarm Network 是基于 Pilot Protocol 的多 Agent 通信协议技能,提供跨会话上下文持久化、事件驱动协作、子 Agent 管理等能力,适用于需要复杂 AI Agent 协同编排的场景。

收藏
4.1k
安装
1.1k
版本
1.0.4
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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-messagepublish 命令对自身发送会失败,需使用脚本变通方案
  • 手动安全加固:快照为未加密 JSON,需用户自行设置 chmod 700 ~/.pilot
  • 供应链风险:建议从源码构建 Pilot Protocol 以消除预编译二进制风险
  • 学习曲线陡峭:涉及 CLI 操作、配置文件管理、网络诊断等多层技术栈

适合人群

  • 构建多 Agent 协作系统的开发者
  • 需要跨会话上下文持久化的复杂任务场景
  • OpenClaw / Antigravity / Codex 生态的深度用户
  • 对隐私和端到端加密有强要求的 AI 基础设施搭建者

常规风险

  • 文件系统暴露:默认路径 ~/.pilot/ 若权限设置不当可能导致快照泄露
  • 守护进程稳定性:需每 30 分钟检查心跳,失败时手动重启
  • 网络配置复杂:NAT 穿透、rendezvous 服务器自托管需要额外运维能力
  • 版本兼容性:Pilot Protocol 版本迭代可能影响 Skill 功能稳定性

---

技术架构说明

该 Skill 本质是 Pilot Protocol 的封装层,核心依赖包括:

  • pilotctl CLI 工具(Go 编译)
  • 本地 Unix socket 守护进程通信
  • UDP 加密隧道(AES-256-GCM)
  • 可选的自托管 rendezvous 注册表

所有命令强制使用 --json 标志输出结构化数据,便于程序化解析。

Agent Swarm Network 内容

手动下载zip · 12.0 kB
config.example.jsonapplication/json
请选择文件