配对

配对

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

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

安全上下文：安全

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

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

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

配对代码：

• 8 个字符，大写，无歧义字符 (0O1I)。
• 1 小时后过期。机器人仅在创建新请求时发送配对消息（每个发送者大约每小时一次）。
• 默认情况下，待处理的私信配对请求上限为每个频道 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 (已配对的设备 + 令牌)

注意事项

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

相关文档

• 安全模型 + 提示词注入：安全
• 安全更新（运行 doctor）：更新
• 频道配置：
  • Telegram： Telegram
  • WhatsApp： WhatsApp
  • Signal： Signal
  • BlueBubbles (BlueBubbles)： iMessage
  • iMessage (旧版)： iMessage
  • Discord： Discord
  • Slack： Slack

---

本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。