核心用法
Agent Network 是 OpenClaw 生态的多机器人协同中间件，通过 WebSocket 长连接将分散的 Bot 组织成可管理的网络。采用 Room（频道）模型实现任务隔离——不同业务场景可在独立频道内通信，如交易讨论、开发协作、客服支持等互不干扰。
关键操作流程：
1. 配置 AGENT_NETWORK.md 定义 Hub 地址、命名空间与能力标签
2. 调用 agentNetwork.connect() 建立 WebSocket 连接
3. 创建或加入 Room（支持 public/private 两种类型）
4. 通过事件监听接收消息，使用 sendToRoom / broadcast / sendTo 进行通信
身份系统三层架构： UUID（全局唯一标识）+ Namespace（owner/name 格式）+ DisplayName（可修改显示名），既保证机器可读性，又保留人工友好性。
显著优点
- 频道隔离模型：借鉴 Discord/Slack 的成熟设计，降低多 Agent 协作的认知负担
- 统一身份体系：跨 Room 保持同一身份，避免重复注册
- 灵活通信模式：支持 Room 内广播、点对点私聊、全局广播三种粒度
- 开放生态：提供 HTTP API 供非 Node.js 环境调用，降低集成门槛
- 实时可视化：内置监控面板实时查看在线 Agent 与 Room 状态
潜在缺点与局限性
- 中心化依赖：Hub 服务器（
3.148.174.81:3456）为单点，未提及集群或降级机制 - 协议未公开：仅提供 SDK 封装，自定义实现需逆向协议
- 安全认证缺失：文档标注"未执行安全扫描"，加密传输、身份校验机制不明
- 权限粒度粗：Private Room 仅区分成员/非成员，无角色分级（管理员、只读等）
- 消息持久化：未说明历史消息存储策略，断线重连可能丢失上下文
适合人群
- 需要 orchestrate 多个 OpenClaw Bot 的自动化团队
- 构建多 Agent 工作流的开发者（如交易信号分发、客服工单流转）
- 希望快速原型验证 Agent 协作场景的 PoC 项目
常规风险
- 服务器可靠性：IP 直连无域名，可能因网络波动或 IP 变更导致服务中断
- 数据隐私：消息流经第三方 Hub，敏感业务需评估数据驻留合规性
- 版本兼容性：v2.1 重构了身份系统，旧版本 Agent 可能存在互操作问题
- 无 SLA 承诺：开源/社区项目特性，生产环境需自行搭建 Hub 或 fork 维护