Pairing overview: approve who can DM you + which nodes can join

Read when…
  • Setting up DM access control
  • Pairing a new iOS/Android node
  • Reviewing OpenClaw security posture

配对

“配对”是OpenClaw的显式所有者批准步骤。 它在两个地方使用:

  1. DM配对(谁被允许与机器人对话)
  2. 节点配对(哪些设备/节点被允许加入网关网络)

安全上下文:Security

1) DM配对(入站聊天访问)

当一个频道配置了DM策略pairing,未知发送者会收到一个短码,他们的消息在你批准之前不会被处理

默认的DM策略记录在:Security

配对码:

  • 8个字符,大写,无歧义字符 (0O1I)。
  • 1小时后过期。机器人仅在创建新请求时发送配对消息(大约每小时每个发送者一次)。
  • 待处理的DM配对请求默认限制为每个频道3个;额外的请求会被忽略,直到其中一个过期或被批准。

批准发送者

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

支持的频道:telegramwhatsappsignalimessagediscordslack

状态存储位置

存储在~/.openclaw/credentials/下:

  • 待处理请求:<channel>-pairing.json
  • 已批准的白名单存储:<channel>-allowFrom.json

将这些视为敏感信息(它们控制对你助手的访问)。

2) 节点设备配对(iOS/Android/macOS/无头节点)

节点以设备身份使用role: node连接到网关。网关 创建一个设备配对请求,必须获得批准。

通过Telegram配对(推荐用于iOS)

如果你使用device-pair插件,你可以完全从Telegram进行首次设备配对:

  1. 在Telegram中,向你的机器人发送消息:/pair
  2. 机器人回复两条消息:一条指令消息和一条单独的设置码消息(在Telegram中易于复制/粘贴)。
  3. 在你的手机上,打开OpenClaw iOS应用 → 设置 → 网关。
  4. 粘贴设置码并连接。
  5. 回到Telegram:/pair approve

设置码是一个包含以下内容的base64编码JSON负载:

  • url:网关WebSocket URL (ws://...wss://...)
  • token:短期配对令牌

在有效期内将设置码视为密码。

批准节点设备

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

节点配对状态存储

存储在~/.openclaw/devices/下:

  • pending.json(短期;待处理请求过期)
  • paired.json(已配对的设备+令牌)

注意事项

  • 旧版node.pair.* API(CLI: openclaw nodes pending/approve) 是一个 独立的网关拥有的配对存储。WS节点仍然需要设备配对。

相关文档