clawdio

🔐 AI 智能体安全 P2P 通信工具

AI Agent 安全 P2P 通信方案,基于 Telegram,采用 Noise XX 加密,无需端口转发即可跨平台通信。

收藏
9.4k
安装
2.2k
版本
latest
CLS 安全性认证2026-05-14
点击查看完整报告 >

使用说明

Clawdio 是一个专为 AI Agent 设计的点对点(P2P)安全通信解决方案,创新性地利用 Telegram 作为底层传输层,结合 Noise XX 握手协议和 XChaCha20-Poly1305 加密算法,为分布式 AI 系统提供无需端口转发的加密通信能力。该技能通过将复杂的网络安全细节抽象为简单的 JavaScript API,使开发者能够快速构建跨平台、跨网络的 Agent 协作系统。

核心用法上,Clawdio 采用"中心辐射"式的连接模型。开发者首先创建名为"Clawdio Hub"的 Telegram 群组并接入 Bot,随后通过交换公钥建立加密通道。两个 Agent 之间通过 Noise XX 协议完成双向认证和密钥交换,之后所有通信均通过 XChaCha20-Poly1305 进行端到端加密。系统支持连接同意机制(Connection Consent),未知对等节点需要显式批准才能建立连接,同时提供可选的六词验证码人工验证环节,进一步防止中间人攻击。

显著优点体现在多个维度。首先,依托 Telegram 的基础设施,用户无需配置端口转发、NAT 穿透或维护专用服务器,解决了传统 P2P 连接的网络配置难题。其次,采用成熟的 libsodium-wrappers 加密库,实现了前向保密、双向认证、重放保护等企业级安全特性。再者,Telegram 的消息队列机制天然支持离线消息存储,确保通信的可靠性。此外,纯 JavaScript 实现和简洁的 API 设计(如 node.connect()node.send())大幅降低了开发门槛。

然而,该技能也存在明显的局限性。最突出的是对 Telegram 服务的强依赖性,一旦 Telegram 服务中断或政策变化,通信链路将立即失效。技术实现上,scripts/start.js 使用 exec() 函数执行系统命令(如 pgrepnode run.js),这不仅构成动态代码执行风险,还包含硬编码的绝对路径和 IP 地址,缺乏生产环境所需的灵活性。后台进程采用 detached: true 模式运行,可能导致进程管理失控和资源泄露。

适合的目标群体主要包括构建分布式 AI 工作流的开发者、需要跨平台 Agent 协调的技术团队,以及关注通信隐私的自动化系统架构师。对于需要在不同机器间安全委托任务、协调多 Agent 协作场景的用户尤为适用。

使用风险方面,除了前述的 exec 调用带来的潜在命令注入风险外,用户还需注意:私钥文件(默认存储于 .clawdio-identity.json)的本地安全性完全依赖于文件系统权限;虽然加密通道本身安全,但 Telegram 元数据(如通信时间、频率、IP 地址)仍可能被收集;在资源受限环境中,后台 Node.js 进程可能消耗不必要的内存资源。建议在生产环境中移除 start.js,改用标准的进程管理工具(如 PM2 或 systemd)直接启动 Node.js 应用。

安全解读

核心用法

Clawdio 为 AI 代理提供零服务器配置的加密 P2P 通信能力,以 Telegram 作为传输层,通过 Noise XX 协议建立端到端安全通道。

三步启动:创建 "Clawdio Hub" Telegram 群组 → 添加机器人 → 交换公钥即可连接。代理间自动完成 XX 握手、会话密钥协商,后续通信采用 XChaCha20-Poly1305 AEAD 加密。

典型场景:跨机器任务委托、分布式 AI 工作流、离线弹性消息队列(Telegram 天然支持消息暂存与重发)。

---

显著优点

| 维度 | 优势 |
|------|------|
| **部署零门槛** | 无需公网 IP、端口转发或服务器,Telegram 即网络基础设施 |
| **密码学硬核** | libsodium 标准库 + Noise XX(前向保密+双向认证)+ 抗重放攻击 |
| **人机共验** | 可选 6 单词验证码面对面比对,防范中间人攻击 |
| **连接可控** | 入站连接需显式同意(`acceptPeer`/`rejectPeer`),非自动授信 |
| **身份持久化** | 支持导出/导入密钥对,跨会话保持身份 |

---

局限与风险

| 问题 | 说明 |
|------|------|
| **Telegram 依赖** | 可用性与隐私策略受 Telegram 平台制约;需信任其消息投递可靠性 |
| **传输层非端到端** | Telegram 服务器可获知密文流量模式(虽无法解密内容) |
| **密钥本地存储** | 私钥默认以明文 JSON 存于本地,建议配置 `0o600` 权限或硬件密钥托管 |
| **子进程风险** | 启动脚本使用 `child_process.exec`,虽命令硬编码,仍存在理论注入面 |
| **无内置证书固定** | 首次连接依赖公钥指纹人工比对,自动化场景下易跳过验证 |

---

适合人群

  • 多代理架构开发者:需要快速搭建跨节点安全通信,不愿维护 MQTT/RabbitMQ 等中间件
  • 个人 AI 工作流用户:希望手机、PC、云端代理互联互通,且重视消息隐私
  • 原型验证团队:快速验证分布式 AI 协作逻辑,后期可迁移至专用 P2P 网络

---

常规风险管控

1. 必做:启用 human verification 或至少比对指纹 emoji 后再标记信任
2. 建议:将身份文件路径配置为加密卷或密钥管理服务(如 macOS Keychain、Windows DPAPI)

3. 监控:定期检查 libsodium-wrappers 安全公告,保持依赖更新

4. 边界:敏感高场景建议叠加 WireGuard 或 Tailscale 等底层加密隧道,不单独依赖应用层加密

clawdio 内容

scripts文件夹
src文件夹
__tests__文件夹
手动下载zip · 13.4 kB
start.jstext/javascript
请选择文件