跳转到内容

配对

“配对”是 OpenClaw 明确的所有者批准步骤。 它用于两个地方:

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

安全上下文:安全

当频道配置了 私信 策略 pairing 时,未知发送者会获得一个短代码,并且在您批准之前,其消息不会被处理

默认私信策略记录在:安全

配对代码:

  • 8 个字符,大写,无歧义字符 (0O1I)。
  • 1 小时后过期。机器人仅在创建新请求时发送配对消息(每个发送者大约每小时一次)。
  • 默认情况下,待处理的私信配对请求上限为每个频道 3 个;额外的请求将被忽略,直到其中一个过期或被批准。
Terminal window
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

支持的频道:telegram, whatsapp, signal, imessage, discord, slack

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

  • 待处理的请求:<channel>-pairing.json
  • 已批准的允许列表存储:<channel>-allowFrom.json

请将这些视为敏感信息(因为它们控制着对您助手的访问权限)。

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

Section titled “2) 节点设备配对(iOS/Android/macOS/headless 节点)”

节点作为设备通过 role: node 连接到 Gateway(网关) 网关。Gateway(网关) 网关 会创建一个必须批准的设备配对请求。

Terminal window
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 节点仍需要设备配对。