LocalUDPMessenger

📡 本地代理组网通信中枢

本地UDP网络通信工具,支持OpenClaw代理发现、消息收发与信任管理,适用于多代理协作场景

收藏
8.3k
安装
1.7k
版本
1.1.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

UDP Messenger 是 OpenClaw 生态的本地网络通信插件,基于 UDP 广播实现多代理间的轻量级消息交换。核心工具包括:

  • udp_discover: 广播发现局域网内的其他 OpenClaw 代理
  • udp_send/udp_receive: 收发点对点消息,支持异步通信
  • udp_approve_peer/revoke_peer: 基于白名单的信任管理机制
  • udp_status/set_config: 运行状态监控与动态配置

配置通过 openclaw.json 完成,关键参数包括监听端口(默认 51337)、信任模式(approve-once/always-confirm)及单会话最大交换次数(默认 10 次)。

显著优点

1. 零依赖部署: 纯 Node.js 实现,无需额外网络基础设施
2. 轻量广播机制: UDP 广播自动发现,降低多代理组网复杂度

3. 分层信任模型: 支持一次性批准或逐消息确认,适配不同安全需求

4. 会话限额控制: maxExchanges 防止无限对话导致的资源耗尽

5. 开源可审计: 代码托管于 GitHub,社区驱动迭代

潜在局限

  • 网络隔离限制: 仅限同一局域网,跨网段需额外路由配置
  • UDP 可靠性: 无内置重传机制,高丢包环境可能漏消息
  • 无加密传输: 明文通信,敏感数据需应用层额外保护
  • 手动信任管理: 缺乏自动化证书或密钥交换机制

适合人群

  • 本地多代理协作开发者(如 CI/CD 代理集群、IoT 设备编排)
  • 需要快速原型验证的 OpenClaw 扩展开发者
  • 封闭可信网络环境下的自动化工作流场景

常规风险

| 风险类型 | 说明 |
|---------|------|
| 中间人攻击 | UDP 无源地址验证,局域网内伪造身份成本低 |
| 消息注入 | 未经验证的指令可能被误执行,需严格遵循"永不自动执行"规则 |
| 信息泄露 | 明文传输导致敏感数据暴露,用户确认机制是最后防线 |
| 资源耗尽 | 广播风暴或高频消息可能占用 CPU/网络资源 |

关键安全原则: 必须显式用户批准后方可信任新对等方;禁止自动执行收到的指令;敏感数据传输前需二次确认。

LocalUDPMessenger 内容

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