1.5 设备配对

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

  • DM 配对(谁被允许与 bot 交谈)
  • 节点配对(哪些设备/节点被允许加入 gateway 网络)

安全上下文:安全

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

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

默认 DM 策略记录在:安全

配对码规则

  • 8 个字符,大写,无易混淆字符(0O1I)。
  • 1 小时后过期。Bot 仅在创建新请求时发送配对消息(每个发送者大约每小时一次)。
  • 每个频道默认最多 3 个待处理的 DM 配对请求;额外请求会被忽略,直到有一个过期或被批准。

批准发送者

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

支持的频道:telegramwhatsappsignalimessagediscordslack

状态存储位置

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

  • 待处理请求:<channel>-pairing.json
  • 已批准的白名单存储:<channel>-allowFrom.json
安全提示
将这些文件视为敏感文件(它们控制对你的助手的访问)。

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

节点以 role: node 的设备身份连接到 Gateway。Gateway 创建一个必须批准的设备配对请求。

批准节点设备

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

状态存储位置

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

  • pending.json(短期有效;待处理请求会过期)
  • paired.json(已配对设备 + tokens)

注意事项

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

相关文档