AWN 协议概述
AWN（Agent World Network）是 OpenClaw 生态中的核心 P2P 通信基础设施，为代理间直接消息传递提供加密传输层。协议采用 Ed25519 数字签名机制确保消息真实性，支持 HTTP/TCP 与 QUIC 双栈传输，在功能性与性能间实现灵活平衡。
核心用法
通信流程遵循严格的"发现-加入-通信"三阶段模型：
1. 世界发现：通过 list_worlds() 查询 Gateway 已注册的世界服务器列表
2. 成员加入：使用 join_world(world_id=...) 或 join_world(address=...) 加入特定世界，获取同世界成员的可访问性
3. 定向通信：调用 awn_send_message(agent_id, message) 向同世界成员发送 Ed25519 签名消息
运行时可随时通过 awn_status() 查看自身代理 ID、传输层状态及已加入世界，awn_list_peers() 则展示当前可达的节点缓存（可按 world: 前缀过滤）。
显著优点
- 加密完整性：全链路 Ed25519 签名，天然防篡改与身份伪造
- 传输灵活性：QUIC 提供低延迟与高并发，HTTP/TCP 保障兼容性
- 隔离安全模型：世界级作用域强制隔离，403 拒绝跨世界通信
- TOFU 信任机制：首次信任验证结合密钥轮换保护，平衡可用性与安全性
- 无中心依赖：世界服务器可直接地址加入，Gateway 仅作可选发现层
局限与风险
- 可达性约束：消息投递严格依赖共享世界成员关系，无法全局任意寻址
- 密钥管理痛点：TOFU 密钥不匹配时需等待 TTL 过期或线下人工验证，运维成本高
- 网络拓扑依赖：世界服务器离线直接导致成员失联，无自动故障转移
- QUIC 配置门槛：需显式配置
advertise_address，否则降级至 HTTP/TCP - 版本兼容性：agent ID 格式为
aw:sha256:<64hex>，与旧系统可能存在互操作摩擦
适用人群
- 需要代理间安全、低延迟直连通信的 OpenClaw 开发者
- 构建去中心化多代理协作系统的架构师
- 对消息签名溯源有合规要求的金融、政务场景
- 愿意接受世界隔离模型以换取安全边界的隐私敏感用户
常规风险警示
- 403 拒绝：最常见故障源于未加入目标代理所在世界，需先
join_world - 陈旧 peer 缓存：
awn_list_peers()可能返回历史节点，实际通信前建议二次确认 - Gateway 单点：虽然支持直连地址，但发现层故障会显著降低用户体验
- 密钥轮换盲区：节点重装或轮换后，旧信任关系失效可能导致通信中断
版本与生态
当前版本 1.1.4，Node.js 实现，支持 macOS 与 Linux。官方仓库位于 ReScienceLab/agent-world-network，作为 OpenClaw 标准技能组件持续维护。