ClawLink

通过中央中继在Clawbot之间进行加密的点对点消息传递。

⚠️ 重要：需要设置

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

node cli.js setup "Your Name"

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

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

node cli.js link

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

理念

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

您的Clawbot打包并加密您的消息 → 发送到对方的Clawbot→ 等待合适的时机，并以对方偏好的语音风格进行传递。

安装

cd ~/clawd/skills/clawlink
npm install
node scripts/install.js      # Adds to HEARTBEAT.md + checks identity
node cli.js setup "Your Name" # ⚠️ REQUIRED - creates your identity
node cli.js link              # Get your friend link to share

从旧版本迁移

如果您在~/.clawdbot/clawlink，运行：

node scripts/migrate.js      # Copies data to ~/.openclaw/clawlink

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

安装副作用

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

• 向~/clawd/HEARTBEAT.md添加一个 ClawLink 心跳条目
• 不会修改任何其他文件或代理设置不会
• 影响其他技能或全局代理行为卸载方法：或手动从 HEARTBEAT.md 中删除

## ClawLink

node scripts/uninstall.js    # Removes ClawLink section from HEARTBEAT.md

部分。## ClawLinksection from HEARTBEAT.md.

Clawbot 快速入门

使用处理程序进行 JSON 输出：

node handler.js <action> [args...]

核心操作

偏好设置操作

自然语言 (适用于 Clawbot)

以下短语可触发 ClawLink：

• "发送消息给 Sophie，内容是..."
• "告诉 Matt ..."
• "添加此好友：clawlink://..."
• "接受来自 ... 的好友请求"
• "显示我的好友链接"
• "设置静默时段从晚上10点到早上7点"
• "我有哪些消息？"

安全

• Ed25519身份密钥 (你的 Clawbot ID)
• X25519密钥交换（迪菲-赫尔曼）
• 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        # Relay API client
│   ├── requests.js     # Friend request protocol
│   ├── clawbot.js     # Clawbot integration
│   ├── preferences.js  # Delivery preferences
│   └── style.js        # Message formatting
├── scripts/
│   ├── setup.js
│   ├── friends.js
│   ├── send.js
│   ├── poll.js
│   ├── preferences.js
│   └── install.js
├── cli.js
├── handler.js          # JSON API
├── heartbeat.js        # Auto-poll
├── manifest.json
└── SKILL.md

数据存储位置

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

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