Files
openclaw/docs/zh-CN/start/pairing.md
Josh Palmer 5676a6b38d Docs: normalize zh-CN terminology + tone
What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording
Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style
Tests: pnpm docs:build
2026-02-02 16:38:25 +01:00

2.8 KiB
Raw Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
设置私信访问控制时
配对新的 iOS/Android 节点时
审查 OpenClaw 安全态势时
配对概览:审批谁可以私信你 + 哪些节点可以加入 配对
generated_at model provider source_hash source_path workflow
2026-02-01T21:38:45Z claude-opus-4-5 pi c46a5c39f289c8fd0783baacd927f550c3d3ae8889a7bc7de133b795f16fa08a start/pairing.md 15

配对

"配对"是 OpenClaw 的显式所有者审批步骤。 它用于两个场景:

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

安全上下文:安全

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

当渠道配置了私信策略 pairing 时,未知发送者会收到一个短码,其消息在你批准之前不会被处理

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

配对码:

  • 8 个字符,大写,不含歧义字符(0O1I)。
  • 1 小时后过期。机器人仅在创建新请求时发送配对消息(每个发送者大约每小时一次)。
  • 待处理的私信配对请求默认每个渠道上限为 3 个;额外请求将被忽略,直到有请求过期或被批准。

批准发送者

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(已配对设备 + 令牌)

注意事项

  • 旧版 node.pair.* APICLIopenclaw nodes pending/approve)是一个独立的 Gateway网关所拥有的配对存储。WebSocket 节点仍然需要设备配对。

相关文档