Agent Network

核心用法

Agent Network 是一个面向 OpenClaw Bot 的分布式协作插件，通过 WebSocket 连接到中央 Agent Hub，实现多机器人之间的实时通信与任务协作。

主要功能模块：

• 实时通信：WebSocket 长连接保持低延迟消息传递
• 广播机制：向所有在线 Agent 群发消息
• 任务委托：将任务动态分发给能力匹配的 Agent 处理
• 状态监控：查看在线 Agent 列表及其声明的能力

使用流程：
1. 通过 clawhub install agent-network 安装
2. 在 HEARTBEAT.md 中配置 Hub 地址、Agent 唯一标识和能力声明
3. 调用 connect() 建立连接，使用 sendTo()/broadcast() 发送消息
4. 通过 onAgentMessage.js 钩子处理接收到的消息

API 设计：
提供完整的事件驱动接口（connected/disconnected/message/agent_online/agent_offline）和结构化数据发送能力（sendData/sendCommand），支持任务接力、信息同步、投票决策等复杂协作场景。

显著优点

• 开箱即用：配置简单，自动重连机制完善
• 灵活的消息模式：支持点对点、广播、结构化数据三种通信方式
• 能力声明机制：Agent 可声明自身能力（chat/task/notify），便于智能任务分发
• 场景示例丰富：文档包含任务接力、信息同步、投票决策等完整代码示例
• 可视化监控：提供 Web 面板实时查看在线 Agent 状态

潜在缺点与局限性

• 依赖中心化 Hub：所有通信必须经过 3.148.174.81:3456，存在单点故障风险
• 安全性待完善：默认使用明文 ws://，生产环境需手动切换 wss://；鉴权 Token 需 Hub 端配合支持
• 无内置加密：消息传输无端到端加密，敏感数据需自行处理
• 网络可见性：Hub IP 地址硬编码在文档中，可能暴露基础设施信息
• 消息可靠性：WebSocket 断线期间消息可能丢失，无持久化队列机制

适合人群

• 需要多 Bot 协作处理复杂工作流的开发者
• 构建分布式 Agent 系统的团队（如交易机器人集群、客服机器人矩阵）
• 希望实现"主从架构"或"联邦学习"式 Agent 协作的研究者

常规风险

• 网络安全风险：默认明文通信可能被中间人窃听或篡改
• Hub 可用性风险：第三方托管的 Hub 服务稳定性未知，IP 归属需确认
• 标识冲突风险：Agent ID 不唯一会导致消息路由混乱
• 资源泄露风险：异常断开时可能未正确清理 WebSocket 连接
• 消息注入风险：广播机制若无鉴权，恶意 Agent 可发送垃圾广播

核心用法

Agent Network 是 OpenClaw 生态中的多 Agent 协同技能，通过中心化的 Agent Hub 实现分布式 Bot 之间的实时通信。用户只需配置 hub_url 和 agent_id，即可将单个 Bot 接入协同网络。核心操作包括：connect() 建立 WebSocket 长连接、sendTo() 向指定 Agent 发送消息、broadcast() 全网广播、sendData() 传输结构化任务数据，以及通过事件监听实现消息回调处理。

显著优点

该技能填补了 OpenClaw 单 Agent 孤岛的架构空白，使多个 Bot 能够像团队协作一样分工配合。WebSocket 长连接保证低延迟实时通信；广播机制支持信息同步和群体决策场景；任务委托模式让专业 Agent 各司其职（如 Bot A 抓取、Bot B 分析、Bot C 通知）；状态监控和自动重连机制提升了网络稳定性。代码结构清晰，API 设计简洁，接入成本低，仅需几行配置即可启用。

潜在缺点与局限性

最突出的问题是默认使用未加密的 `ws://` 协议，所有传输数据（包括 Agent 身份信息、消息内容、任务详情）均以明文传输，存在中间人攻击风险。此外，依赖个人部署的公共 Hub 服务器（3.148.174.81），无企业级 SLA 保障，服务可用性和数据持久性存疑。隐私合规方面，数据外发行为缺乏明确的用户告知和同意机制，不符合 GDPR/CCPA 要求。功能上暂无消息持久化、离线消息队列或端到端加密等高级特性。

适合的目标群体

• 多 Bot 运维团队：需要统一管理多个功能专精的 OpenClaw Bot，实现任务流水线协作
• 分布式自动化场景：如跨服务器监控告警、多账号社交媒体运营、分角色客服系统
• 实验性项目开发者：快速验证 Agent 协同架构，对安全性要求不高的原型阶段
• 自托管用户：有能力自行部署 Agent Hub，通过内网 WSS 连接规避公共服务器风险

使用风险

1. 数据泄露风险：明文传输可能导致敏感信息被网络监听截获，生产环境务必改用 WSS
2. 服务依赖风险：公共 Hub 由个人维护，可能出现宕机、数据丢失或永久关闭
3. 隐私合规风险：向第三方服务器传输 Agent 元数据，可能违反企业内部数据政策或地区法规
4. 供应链风险：虽当前依赖安全，但未来 ws 库若出现漏洞需及时更新
5. 身份伪造风险：无 Token 鉴权机制时，恶意 Agent 可伪装接入网络（需 Hub 端配合加固）