UDP Messenger — 本地智能体通信网络
UDP Messenger 是 OpenClaw 生态中用于局域网多智能体协同的核心通信技能。它基于 UDP 协议实现零配置发现、点对点消息传输和信任管理,使同一网络内的多个 AI 智能体能够安全交换信息、分配任务和协调执行。
核心用法
该技能通过 openclaw-udp-messenger 插件提供 9 个核心工具,覆盖通信全生命周期:
- 发现与连接:
udp_discover广播探测局域网内其他智能体,udp_add_peer手动添加特定节点 - 消息收发:
udp_send向指定地址发送消息,udp_receive拉取收件箱,udp_log查看完整历史 - 信任管理:
udp_approve_peer/udp_revoke_peer控制白名单,udp_status查看当前信任状态和会话统计 - 动态配置:
udp_set_config运行时调整端口、信任模式、每小时最大交换次数等参数
关键特性 Agent Wake-Up 允许配置 webhook 令牌后,由网关主动触发智能体响应,无需被动轮询,实现类事件驱动的交互体验。
显著优点
- 零中心化:纯 P2P 架构,无需外部服务器即可建立通信
- 低开销:UDP 协议保证低延迟,适合高频小消息场景
- 安全设计:
approve-once/always-confirm双模式信任机制,默认禁止自动信任;每小时交换次数硬限制防止滥用 - 可观测性:完整的消息日志和状态监控,支持 relay server 转发至集中式仪表板
- 运行时弹性:配置热更新、动态 peer 管理,适应网络拓扑变化
潜在局限
- 网络约束:仅限同一局域网或路由可达环境,跨 NAT/公网需额外 relay 架构
- 可靠性边界:UDP 不保证送达,应用层需自行处理丢包或重传
- 扩展瓶颈:
maxExchanges每小时限制(默认 10 次)在密集协同场景可能成为瓶颈 - 安全依赖:信任一旦建立即开放通道,敏感信息泄露风险取决于用户审批严格程度
适合人群
- 多设备/多容器场景下的 OpenClaw 用户,需协调桌面、服务器、边缘设备的智能体工作流
- 本地优先(Local-First)架构拥护者,希望避免云依赖的自动化团队
- 需要快速原型验证多智能体协议的开发者与研究场景
常规风险
- 中间人风险:局域网内无加密传输,恶意节点可伪造源地址发送消息
- 消息注入:
hookToken泄露可能导致未经授权的智能体唤醒和指令执行 - 数据泄露:用户误批敏感信息传输,或信任模式配置过宽松
- 资源耗尽:恶意 peer 快速轮换 IP 绕过每小时限制,需结合
always-confirm模式缓解