LocalUDPMessenger

📡 零配置 LAN 智能体通信与信任网络

通过 UDP 实现本地 OpenClaw 智能体间的低延迟通信,支持发现、信任管理和自动唤醒,适合 LAN 环境下的多智能体协同。

收藏
6k
安装
1.4k
版本
1.4.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

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 模式缓解

LocalUDPMessenger 内容

hooks文件夹
check-inbox文件夹
skills文件夹
udp-messenger文件夹
手动下载zip · 19.7 kB
handler.tstext/plain
请选择文件