配对
“配对”是 OpenClaw 的所有者显式批准步骤。 它用于两个场景：- 私信配对（谁被允许与机器人聊天）
- 节点配对（哪些设备/节点被允许加入网关网络）
1) 私信配对（入站聊天访问）
当频道配置了私信策略pairing 时，未知发送者会获得一个短代码，且其消息不会被处理，直到你批准。
默认的私信策略见文档：安全
配对代码：
- 8 个字符，大写，不含易混淆字符（
0O1I）。 - 1 小时后过期。机器人只有在创建新请求时才会发送配对消息（大约每个发送者每小时一次）。
- 待处理私信配对请求默认限制为每频道 3 个；超过后将被忽略，直到有请求过期或被批准。
批准发送者
telegram、whatsapp、signal、imessage、discord、slack、feishu。
状态存储位置
存储路径为~/.openclaw/credentials/：
- 待处理请求：
<channel>-pairing.json - 已批准的允许列表存储：
- 默认账户：
<channel>-allowFrom.json - 非默认账户：
<channel>-<accountId>-allowFrom.json
- 默认账户：
- 非默认账户只读写其作用域内的允许列表文件。
- 默认账户使用频道作用域的非作用域允许列表文件。
2) 节点设备配对（iOS/Android/macOS/无头节点）
节点作为role: node 的设备连接到网关。网关创建设备配对请求，必须经过批准。
通过 Telegram 配对（iOS 推荐）
如果你使用device-pair 插件，可以完全通过 Telegram 进行首次设备配对：
- 在 Telegram 里向机器人发送指令：
/pair - 机器人回复两条消息：一条说明信息，一条单独的设置代码消息（方便在 Telegram 中复制粘贴）。
- 在手机上打开 OpenClaw iOS 应用 → 设置 → 网关。
- 粘贴设置代码并连接。
- 回到 Telegram，输入：
/pair approve
url：网关 WebSocket URL（ws://...或wss://...）token：短期有效的配对令牌
批准节点设备
节点配对状态存储
存储路径为~/.openclaw/devices/：
pending.json（短期，待处理请求会过期）paired.json（已配对设备 + 令牌）
注意事项
- 旧版
node.pair.*API（CLI：openclaw nodes pending/approve）是网关拥有的独立配对存储。 - WebSocket 节点仍需要设备配对。