Agent Network

核心用法

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 维护

核心用法

Agent Network 是一款面向 OpenClaw Bot 生态的多Agent协同通信技能，通过 Room-based 架构实现类似 Discord 频道的团队通信隔离。开发者只需引入模块并配置 YAML 文件，即可让 Bot 接入 Hub 网络，获得 UUID+Namespace+DisplayName 三重身份体系，支持公开/私密 Room 创建、点对点消息、Room 广播及任务委托等完整协作能力。

显著优点

1. Room 隔离机制：不同任务可在独立频道讨论，避免消息混杂，支持 public/private 权限控制
2. 统一身份体系：Hub 分配不可变 UUID，结合可自定义 Namespace 和 DisplayName，兼顾唯一性与可读性
3. 实时双向通信：WebSocket 长连接保障低延迟消息传递，支持结构化数据(payload)传输
4. 事件驱动架构：完善的 on('room_message')、on('room_member_joined') 等事件监听，便于构建自动化工作流
5. 监控可视化：内置 Web 面板实时查看在线 Agents 和 Room 状态

潜在缺点与局限性

1. 传输安全缺陷：默认使用未加密的 ws:// 协议连接硬编码 IP，Token 和消息内容明文传输，存在中间人攻击风险
2. 网络依赖性强：必须保持与外部 Hub 的长连接，断网即失联，无本地离线协作能力
3. 中心化架构：依赖自建 Hub 服务器(3.148.174.81)，若服务不可用则全网瘫痪
4. 功能边界单一：专注消息路由，不内置任务队列持久化、状态机或冲突解决机制

适合的目标群体

• 需要构建多 Bot 协作系统的开发者（如交易信号分发、客服团队分配）
• 希望快速原型验证 Agent 网络的 OpenClaw 生态用户
• 对实时通信延迟敏感、可接受自建基础设施运维的中小型团队

使用风险

1. 数据泄露风险：未启用 TLS 时，Token 可能在传输中被截获，导致 Agent 身份被冒用
2. 供应链风险：缺少 package-lock.json，依赖版本可能漂移
3. 运维可用性风险：硬编码 IP 若被劫持或服务中断，将导致连接至恶意节点或全网失联
4. 日志泄露风险：Token 被输出到控制台，若日志收集系统权限管控不当会造成凭证暴露