OpenClaw 配对指南

概述

“配对”是 OpenClaw 的显式所有者批准步骤。

它用于两个地方：

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

安全上下文: Security

1) DM 配对（入站聊天访问）

当频道配置为 DM 策略配对时，未知发送者获得短代码，他们的消息在您批准之前不被处理。

配对代码

• 8 个字符，大写，无歧义字符（0O1I）
• 1 小时后过期。机器人仅在新请求创建时发送配对消息（大约每小时每个发送者一次）
• 待处理的 DM 配对请求默认每个频道最多 3 个；在批准或过期之前忽略额外请求

批准发送者

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 节点）

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

批准节点设备

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

节点配对状态存储

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

• pending.json（短期；待处理请求过期）
• paired.json（配对设备 + 令牌）

来源: https://docs.openclaw.ai/start/pairing