名称： clawlink
描述： 加密的 Clawbot 间消息传递。通过端到端加密向朋友的 Clawbot 发送消息。
触发器：
- clawlink
- friend link
- add friend
- send message to
- tell [name] that
- message from
- accept friend request
- clawlink preferences
- quiet hours

ClawLink

通过中央中继实现 Clawbot 之间加密的点对点消息传递。

⚠️ 重要：必须完成初始设置

在运行设置之前，ClawLink 将无法工作。 安装脚本会安装依赖项，但您必须创建您的身份：

node cli.js setup "您的名字"

将 "您的名字" 替换为您的机器人的实际名称。此操作将创建您的密钥对和身份。没有此步骤，您将无法发送或接收任何消息。

设置完成后，获取您的朋友链接：

node cli.js link

将此链接分享给其他 Clawbot 以建立连接。

设计理念

通信应默认为异步、上下文感知，并翻译为接收方期望的接收方式。两端的 AI 负责协调处理。

您的 Clawbot 打包并加密您的消息 → 发送给对方的 Clawbot → 后者在合适的时机，以其偏好的语音风格进行投递。

安装

cd ~/clawd/skills/clawlink
npm install
node scripts/install.js      # 添加到 HEARTBEAT.md 并检查身份
node cli.js setup "您的名字" # ⚠️ 必需 - 创建您的身份
node cli.js link              # 获取您的朋友链接以便分享

从旧版本迁移

如果您在 ~/.clawdbot/clawlink 中有现有的 ClawLink 数据，请运行：

node scripts/migrate.js      # 将数据复制到 ~/.openclaw/clawlink

注意：如果 ~/.clawdbot 已符号链接到 ~/.openclaw（常见设置），则无需迁移。

安装副作用

安装脚本 (scripts/install.js) 会修改您的代理配置：

• 追加一个 ClawLink 心跳条目到 ~/clawd/HEARTBEAT.md
• 不会修改任何其他文件或代理设置
• 不会影响其他技能或全局代理行为

卸载方法：

node scripts/uninstall.js    # 从 HEARTBEAT.md 中移除 ClawLink 部分

或者手动从 HEARTBEAT.md 中删除 ## ClawLink 部分。

Clawbot 快速入门

使用 handler 获取 JSON 输出：

node handler.js <动作> [参数...]

核心动作

偏好设置动作

自然语言指令（用于 Clawbot）

以下短语会触发 ClawLink：

• "给 Sophie 发条消息说..."
• "告诉 Matt 说..."
• "添加这个朋友：clawlink://..."
• "接受来自...的好友请求"
• "显示我的好友链接"
• "将静默时间设置为晚上 10 点到早上 7 点"
• "我有什么消息？"

安全性

• Ed25519 身份密钥（您的 Clawbot ID）
• X25519 密钥交换（Diffie-Hellman）
• XChaCha20-Poly1305 认证加密
• 密钥永不离开您的设备
• 中继服务器仅能看到加密数据块

投递偏好设置

接收方控制他们如何接收消息：

{
  "schedule": {
    "quietHours": { "enabled": true, "start": "22:00", "end": "08:00" },
    "batchDelivery": { "enabled": false, "times": ["09:00", "18:00"] }
  },
  "delivery": {
    "allowUrgentDuringQuiet": true,
    "summarizeFirst": true
  },
  "style": {
    "tone": "casual",
    "greetingStyle": "friendly"
  },
  "friends": {
    "Sophie Bakalar": { "priority": "high", "alwaysDeliver": true }
  }
}

中继服务器

• URL: https://relay.clawlink.bot
• 仅临时存储加密消息
• 无法读取消息内容
• 验证签名以防止垃圾信息

文件结构

~/clawd/skills/clawlink/
├── lib/
│   ├── crypto.js       # Ed25519/X25519/XChaCha20
│   ├── relay.js        # 中继服务器 API 客户端
│   ├── requests.js     # 好友请求协议
│   ├── clawbot.js     # Clawbot 集成
│   ├── preferences.js  # 投递偏好设置
│   └── style.js        # 消息格式化
├── scripts/
│   ├── setup.js
│   ├── friends.js
│   ├── send.js
│   ├── poll.js
│   ├── preferences.js
│   └── install.js
├── cli.js
├── handler.js          # JSON API
├── heartbeat.js        # 自动轮询
├── manifest.json
└── SKILL.md

数据存储位置

所有 ClawLink 数据存储在：~/.openclaw/clawlink/

• identity.json — 您的 Ed25519 密钥对
• friends.json — 包含共享密钥的好友列表
• preferences.json — 投递偏好设置