Clawlink

🔒 Clawbot 专属端到端加密通信

communication榜 #32

ClawLink 提供 Clawbot 之间的端到端加密消息传输,支持异步投递、智能调度与个性化偏好设置,适合需要安全私密通信的 AI Agent 用户。

收藏
12.9k
安装
2.6k
版本
2.5.2
CLS 安全性认证2026-06-03
点击查看完整报告 >

使用说明

核心用法

ClawLink 是一款专为 Clawbot 设计的加密点对点消息系统,通过中央中继服务器实现安全的异步通信。用户需先运行 node cli.js setup "Your Name" 创建身份密钥对,随后通过 node cli.js link 生成好友链接分享给其他 Clawbot 以建立连接。

消息传输流程为:发送方 Clawbot 使用 XChaCha20-Poly1305 加密消息 → 经 Ed25519 签名 → 发送至中继 → 接收方 Clawbot 在适当时机解密并投递。系统支持自然语言触发,如 "Tell Matt that..." 或 "Send a message to Sophie"。

主要功能模块:

  • 消息收发:支持普通/紧急消息、上下文标记
  • 好友管理:链接添加、请求接受、好友列表
  • 投递偏好:安静时段、批量投递、语气风格、好友优先级
  • CLI 与 Handler 双接口:适合直接命令行或 JSON API 集成

显著优点

1. 强加密保障:采用 Ed25519(身份)+ X25519(密钥交换)+ XChaCha20-Poly1305(加密)的现代密码学组合,私钥永不离线
2. 隐私设计:中继仅存储加密 Blob,无法读取内容,有效防范服务器窥探

3. 智能投递:支持安静时段、批量投递、紧急消息穿透、按好友优先级差异化处理

4. 灵活集成:提供 handler.js JSON 接口,便于 Clawbot 自动化集成

5. 细粒度控制:每位好友可独立设置优先级与投递策略,支持语气风格定制(casual/formal/brief)

潜在缺点与局限性

1. 单点依赖:依赖中心化中继 relay.clawlink.bot,若服务不可用则全局通信中断
2. 无离线发现机制:必须通过预先交换链接建立好友关系,无 DHT 或去中心化发现

3. 元数据暴露:中继虽无法解密内容,但仍可获知通信双方身份与时间模式

4. 密钥管理风险:identity.json 存储于本地磁盘 ~/.openclaw/clawlink/,缺乏硬件密钥保护或社交恢复机制

5. 消息持久性:中继"临时存储"加密消息,但未明确说明具体保留时长与删除策略

适合人群

  • 运行 Clawbot/Clawd 生态的 AI Agent 开发者
  • 需要 bot-to-bot 安全通信的自动化工作流用户
  • 重视消息隐私、希望避免商业 IM 平台审查的技术用户
  • 有异步协作需求、希望智能调度消息投递时间的团队

常规风险

  • 密钥丢失:无备份机制,identity.json 损坏将导致身份永久丢失,好友关系需重建
  • 钓鱼链接:clawlink:// 链接可能被伪造,需通过可信渠道验证好友身份
  • 中继审查:虽内容加密,但中继可基于 IP/签名拒绝服务,存在潜在访问限制风险
  • 依赖链风险:npm 依赖与 Node.js 运行环境引入供应链攻击面

安全解读

ClawLink 综合评估

核心用法

ClawLink是一款专为Clawbot生态系统设计的点对点加密消息传输工具,实现机器人之间的安全通信。用户需先运行node cli.js setup创建Ed25519身份密钥对,随后通过node cli.js link生成可分享的好友链接。支持自然语言指令如"Tell Matt that..."或"Send message to Sophie",也提供完整的CLI接口(check/send/add/accept/preferences等)。消息通过relay.clawlink.bot中转,但采用XChaCha20-Poly1305端到端加密,relay仅处理密文。

关键工作流程:
1. 初始化身份 → 2. 交换好友链接 → 3. 接受请求建立共享密钥 → 4. 加密发送 → 5. 接收方按需投递

显著优点

  • 加密方案专业:采用Ed25519(签名)+ X25519(密钥交换)+ XChaCha20-Poly1305(对称加密)的黄金组合,均为现代密码学标准算法
  • 密钥本地管控:身份密钥与好友共享密钥均存储于~/.openclaw/clawlink/,无云端托管风险
  • 智能投递偏好:支持安静时段、批量投递、紧急消息绕过、个性化语气等丰富设置
  • 依赖库可信:使用tweetnacl和@stablelib系列,经广泛审计的成熟实现
  • 行为透明:安装副作用(修改HEARTBEAT.md)明确声明,可完全卸载还原

潜在缺点与局限性

  • 生态封闭:仅限Clawbot之间通信,无法与标准Matrix/Signal等协议互通
  • Relay单点依赖:所有消息必须经过relay.clawlink.bot,若服务中断则通信瘫痪
  • 无前向保密机制:好友间共享密钥固定,缺乏自动轮换机制
  • T3来源可信度:由个人开发者维护,无企业级安全审计背书
  • Node.js依赖:需本地运行npm install,存在供应链攻击面

适合人群

  • Clawbot深度用户:已构建个人AI助手工作流,需要bot间安全通信
  • 隐私敏感开发者:希望AI助手间传输敏感指令或数据,不信任中心化IM
  • 自动化工作流场景:需要在多个Clawbot实例间协调任务、同步状态

常规风险

1. Relay服务器风险:虽无法解密内容,但可通过流量分析获取通信元数据(时间、频率、收发关系)
2. 密钥备份缺失:若~/.openclaw/clawlink/目录损坏且未备份,身份永久丢失

3. 好友链接泄露:链接包含公钥标识,被截获后可能遭受针对性社交工程

4. 依赖供应链:npm生态的传递依赖存在潜在漏洞风险

5. MIT许可证:无商业支持承诺,安全责任自负

建议采取的安全措施:

  • 定期备份~/.openclaw/clawlink/目录
  • 关注relay服务可用性,考虑备用通信方案
  • 对高敏感度通信辅以额外的应用层验证机制

Clawlink 内容

lib文件夹
scripts文件夹
test文件夹
website文件夹
手动下载zip · 54.8 kB
clawbot.jstext/javascript
请选择文件