From 5234e8bc5bff1f39387f32e71b98b65c580ea040 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 4 May 2026 07:16:45 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/channels/pairing.md | 130 +++++++++++++++++---------------- 1 file changed, 69 insertions(+), 61 deletions(-) diff --git a/docs/zh-CN/channels/pairing.md b/docs/zh-CN/channels/pairing.md index 714e71322..329aff456 100644 --- a/docs/zh-CN/channels/pairing.md +++ b/docs/zh-CN/channels/pairing.md @@ -3,41 +3,41 @@ read_when: - 设置私信访问控制 - 配对新的 iOS/Android 节点 - 审查 OpenClaw 的安全态势 -summary: 配对概览：批准谁可以给你发私信 + 哪些节点可以加入 +summary: 配对概览：批准谁可以私信你 + 哪些节点可以加入 title: 配对 x-i18n: - generated_at: "2026-05-03T23:54:50Z" + generated_at: "2026-05-04T07:16:13Z" model: gpt-5.5 provider: openai - source_hash: 4fb27840f7c9ef55e7270cc29f813e6db90b240aa2180f30952eb9485f0f8874 + source_hash: f2bce4cfba7708b0003f2ffeacada8bc1849cc301f28178b499a9a67bddcf36d source_path: channels/pairing.md workflow: 16 --- “配对”是 OpenClaw 的显式访问批准步骤。 -它用于两个位置： +它用于两个地方： 1. **私信配对**（谁可以与机器人对话） 2. **节点配对**（哪些设备/节点可以加入 Gateway 网关网络） -安全上下文：[安全](/zh-CN/gateway/security) +安全上下文：[安全性](/zh-CN/gateway/security) ## 1) 私信配对（入站聊天访问） -当某个渠道配置为私信策略 `pairing` 时，未知发送者会收到一个短代码，并且在你批准之前，他们的消息**不会被处理**。 +当渠道配置了私信策略 `pairing` 时，未知发送者会获得一个短代码，并且他们的消息在你批准之前**不会被处理**。 -默认私信策略记录在：[安全](/zh-CN/gateway/security) +默认私信策略记录在：[安全性](/zh-CN/gateway/security) -`dmPolicy: "open"` 仅当有效私信允许列表包含 `"*"` 时才是公开的。 -设置和验证要求公开开放配置使用该通配符。如果现有 -状态包含 `open` 且带有具体的 `allowFrom` 条目，运行时仍然只允许 -这些发送者，并且配对存储中的批准不会扩大 `open` 访问范围。 +只有当有效的私信允许列表包含 `"*"` 时，`dmPolicy: "open"` 才是公开的。 +设置和验证要求公开开放配置使用这个通配符。如果现有 +状态包含带具体 `allowFrom` 条目的 `open`，运行时仍然只允许 +这些发送者，配对存储中的批准不会扩大 `open` 访问权限。 配对码： - 8 个字符，大写，不含易混淆字符（`0O1I`）。 -- **1 小时后过期**。机器人只会在创建新请求时发送配对消息（每个发送者大约每小时一次）。 -- 待处理的私信配对请求默认每个渠道上限为 **3 个**；额外请求会被忽略，直到有请求过期或获批。 +- **1 小时后过期**。机器人只会在创建新请求时发送配对消息（约每个发送者每小时一次）。 +- 待处理的私信配对请求默认每个渠道上限为 **3 个**；额外请求会被忽略，直到某个请求过期或被批准。 ### 批准发送者 @@ -46,8 +46,8 @@ openclaw pairing list telegram openclaw pairing approve telegram ``` -如果尚未配置命令所有者，批准私信配对码也会将 -`commands.ownerAllowFrom` 引导设置为已批准的发送者，例如 `telegram:123456789`。 +如果尚未配置命令所有者，批准私信配对码也会引导初始化 +`commands.ownerAllowFrom` 为已批准的发送者，例如 `telegram:123456789`。 这会为首次设置提供一个显式所有者，用于特权命令和 exec 批准提示。所有者存在后，后续配对批准只授予私信 访问权限；它们不会添加更多所有者。 @@ -56,10 +56,11 @@ openclaw pairing approve telegram ### 可复用的发送者组 -当同一组受信任发送者应适用于多个消息渠道，或同时适用于私信和群组允许列表时，请使用顶层 `accessGroups`。 +当同一组可信发送者应适用于多个消息渠道，或同时适用于私信和群组允许列表时， +使用顶层 `accessGroups`。 -静态组使用 `type: "message.senders"`，并通过 -渠道允许列表中的 `accessGroup:` 引用： +静态组使用 `type: "message.senders"`，并通过渠道允许列表中的 +`accessGroup:` 引用： ```json5 { @@ -80,7 +81,7 @@ openclaw pairing approve telegram } ``` -访问组的详细文档在这里：[访问组](/zh-CN/channels/access-groups) +访问组在这里有详细文档：[访问组](/zh-CN/channels/access-groups) ### 状态存储位置 @@ -88,58 +89,65 @@ openclaw pairing approve telegram - 待处理请求：`-pairing.json` - 已批准允许列表存储： - - 默认账户：`-allowFrom.json` - - 非默认账户：`--allowFrom.json` + - 默认账号：`-allowFrom.json` + - 非默认账号：`--allowFrom.json` -账户作用域行为： +账号作用域行为： -- 非默认账户只读写其作用域内的允许列表文件。 -- 默认账户使用渠道作用域的未限定作用域允许列表文件。 +- 非默认账号只读写它们的作用域允许列表文件。 +- 默认账号使用渠道作用域的非作用域允许列表文件。 请将这些文件视为敏感内容（它们控制对你的助手的访问）。 配对允许列表存储用于私信访问。群组授权是分开的。 批准私信配对码不会自动允许该发送者运行群组 -命令或在群组中控制机器人。首个所有者引导是单独的配置 -状态，位于 `commands.ownerAllowFrom`，群组聊天投递仍然遵循 -该渠道的群组允许列表（例如 `groupAllowFrom`、`groups`，或根据渠道不同使用每群组 -或每主题覆盖）。 +命令或在群组中控制机器人。首个所有者引导是 `commands.ownerAllowFrom` +中的独立配置状态，而群聊投递仍遵循该 +渠道的群组允许列表（例如 `groupAllowFrom`、`groups`，或取决于渠道的按群组 +或按主题覆盖）。 ## 2) 节点设备配对（iOS/Android/macOS/无头节点） 节点以 `role: node` 的**设备**身份连接到 Gateway 网关。Gateway 网关 -会创建设备配对请求，必须批准该请求。 +会创建设备配对请求，该请求必须被批准。 ### 通过 Telegram 配对（推荐用于 iOS） -如果你使用 `device-pair` 插件，可以完全通过 Telegram 完成首次设备配对： +如果使用 `device-pair` 插件，你可以完全通过 Telegram 完成首次设备配对： -1. 在 Telegram 中，向你的机器人发送消息：`/pair` +1. 在 Telegram 中，给你的机器人发送消息：`/pair` 2. 机器人会回复两条消息：一条说明消息，以及一条单独的**设置代码**消息（便于在 Telegram 中复制/粘贴）。 -3. 在手机上打开 OpenClaw iOS 应用 → 设置 → Gateway 网关。 -4. 粘贴设置代码并连接。 +3. 在手机上，打开 OpenClaw iOS 应用 → 设置 → Gateway 网关。 +4. 扫描二维码或粘贴设置代码并连接。 5. 回到 Telegram：`/pair pending`（查看请求 ID、角色和作用域），然后批准。 -设置代码是一个 base64 编码的 JSON 载荷，包含： +设置代码是一个 base64 编码的 JSON 载荷，其中包含： - `url`：Gateway 网关 WebSocket URL（`ws://...` 或 `wss://...`） - `bootstrapToken`：用于初始配对握手的短期单设备引导令牌 -该引导令牌携带内置配对引导配置文件： +该引导令牌携带内置的配对引导配置： -- 主要交接的 `node` 令牌保持 `scopes: []` -- 任何交接的 `operator` 令牌都限定在引导允许列表内： +- 交接后的主 `node` 令牌保持 `scopes: []` +- 任何交接后的 `operator` 令牌都受限于引导允许列表： `operator.approvals`、`operator.read`、`operator.talk.secrets`、`operator.write` -- 引导作用域检查按角色加前缀，而不是一个扁平作用域池： +- 引导作用域检查按角色加前缀，而不是一个扁平的作用域池： operator 作用域条目只满足 operator 请求，非 operator 角色 - 仍必须在其自己的角色前缀下请求作用域 -- 后续令牌轮换/吊销仍同时受设备已批准 - 角色合约和调用方会话 operator 作用域的限制 + 仍必须请求其自身角色前缀下的作用域 +- 后续令牌轮换/撤销仍同时受设备已批准 + 角色合约和调用方会话的 operator 作用域约束 设置代码有效期间，请像对待密码一样对待它。 +对于 Tailscale、公开或其他非 loopback 移动端配对，请使用 Tailscale +Serve/Funnel 或其他 `wss://` Gateway 网关 URL。直接的非 loopback `ws://` 设置 +URL 会在二维码/设置代码签发前被拒绝。明文 `ws://` 设置代码 +仅限于 loopback URL；私有网络 `ws://` 客户端仍需要远程 +Gateway 网关指南中描述的显式 `OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1` +破窗开关。 + ### 批准节点设备 ```bash @@ -148,25 +156,25 @@ openclaw devices approve openclaw devices reject ``` -当显式批准被拒绝，原因是执行批准的已配对设备会话 -以仅配对作用域打开时，CLI 会使用 -`operator.admin` 重试同一请求。这让现有具备管理员能力的已配对设备无需手动编辑 -`devices/paired.json`，即可恢复新的 -Control UI/浏览器配对。Gateway 网关仍会验证重试的连接；无法使用 -`operator.admin` 进行身份验证的令牌仍会被阻止。 +当显式批准被拒绝，因为执行批准的已配对设备会话 +以仅配对作用域打开时，CLI 会使用 `operator.admin` +重试同一个请求。这让现有具备 admin 能力的已配对设备能够恢复新的 +Control UI/浏览器配对，而无需手动编辑 `devices/paired.json`。Gateway 网关 +仍会验证重试的连接；无法使用 `operator.admin` 认证的令牌 +仍会被阻止。 -如果同一设备使用不同身份验证详情重试（例如不同的 -角色/作用域/公钥），先前的待处理请求会被取代，并创建新的 +如果同一设备使用不同认证详细信息重试（例如不同的 +角色/作用域/公钥），之前的待处理请求会被取代，并创建新的 `requestId`。 -已配对设备不会静默获得更宽的访问权限。如果它重新连接时请求更多作用域或更宽的角色，OpenClaw 会保持现有批准不变，并创建一个新的待处理升级请求。批准之前，请使用 `openclaw devices list` 对比当前已批准访问权限和新请求的访问权限。 +已配对的设备不会静默获得更广泛的访问权限。如果它重新连接时请求更多作用域或更广泛的角色，OpenClaw 会保持现有批准不变，并创建一个新的待处理升级请求。在批准前，请使用 `openclaw devices list` 比较当前已批准的访问权限和新请求的访问权限。 -### 可选的受信任 CIDR 节点自动批准 +### 可选的可信 CIDR 节点自动批准 -设备配对默认仍然是手动的。对于严格受控的节点网络， -你可以通过显式 CIDR 或精确 IP，选择为首次节点配对启用自动批准： +设备配对默认仍为手动。对于严格受控的节点网络， +你可以使用显式 CIDR 或精确 IP 选择启用首次节点自动批准： ```json5 { @@ -180,8 +188,8 @@ Control UI/浏览器配对。Gateway 网关仍会验证重试的连接；无法 } ``` -这仅适用于没有请求 -作用域的新 `role: node` 配对请求。Operator、浏览器、Control UI 和 WebChat 客户端仍需要手动 +这只适用于没有请求 +作用域的全新 `role: node` 配对请求。Operator、浏览器、Control UI 和 WebChat 客户端仍需要手动 批准。角色、作用域、元数据和公钥变更仍需要手动 批准。 @@ -189,20 +197,20 @@ Control UI/浏览器配对。Gateway 网关仍会验证重试的连接；无法 存储在 `~/.openclaw/devices/` 下： -- `pending.json`（短期；待处理请求会过期） +- `pending.json`（短期存在；待处理请求会过期） - `paired.json`（已配对设备 + 令牌） -### 备注 +### 注意事项 -- 旧版 `node.pair.*` API（CLI：`openclaw nodes pending|approve|reject|remove|rename`）是一个 - 独立的 Gateway 网关自有配对存储。WS 节点仍需要设备配对。 +- 旧版 `node.pair.*` API（CLI：`openclaw nodes pending|approve|reject|remove|rename`）是 + 单独的 Gateway 网关所有的配对存储。WS 节点仍需要设备配对。 - 配对记录是已批准角色的持久事实来源。活动 - 设备令牌仍限定于该已批准角色集合；已批准角色之外的零散令牌条目 + 设备令牌仍受限于该已批准的角色集合；批准角色之外的零散令牌条目 不会创建新的访问权限。 ## 相关文档 -- 安全模型 + 提示注入：[安全](/zh-CN/gateway/security) +- 安全模型 + 提示注入：[安全性](/zh-CN/gateway/security) - 安全更新（运行 Doctor）：[更新](/zh-CN/install/updating) - 渠道配置： - Telegram：[Telegram](/zh-CN/channels/telegram)