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-06-28 21:01:43 +03:00 · 2026-02-02 15:46:45 +01:00
parent 2b1f68c928
commit 5676a6b38d
237 changed files with 2322 additions and 2337 deletions
@@ -27,7 +27,7 @@ x-i18n:

 ## 自动检测（默认）

-如果您**未配置模型**且 `tools.media.audio.enabled` **未**设置为 `false`，OpenClaw 会按以下顺序自动检测，并在找到第一个可用选项时停止：
+如果你**未配置模型**且 `tools.media.audio.enabled` **未**设置为 `false`，OpenClaw 会按以下顺序自动检测，并在找到第一个可用选项时停止：

 1. **本地 CLI**（如已安装）
   - `sherpa-onnx-offline`（需要 `SHERPA_ONNX_MODEL_DIR` 包含 encoder/decoder/joiner/tokens）
@@ -116,5 +116,5 @@ x-i18n:
 ## 常见陷阱

 - 作用域规则采用首次匹配优先。`chatType` 会被规范化为 `direct`、`group` 或 `room`。
- 确保您的 CLI 以退出码 0 退出并输出纯文本；JSON 格式需要通过 `jq -r .text` 进行转换。
+- 确保你的 CLI 以退出码 0 退出并输出纯文本；JSON 格式需要通过 `jq -r .text` 进行转换。
 - 保持合理的超时时间（`timeoutSeconds`，默认 60 秒），以避免阻塞回复队列。
@@ -17,9 +17,9 @@ x-i18n:

 OpenClaw 支持智能体工作流中的**相机捕获**：

- **iOS 节点**（通过 Gateway 配对）：通过 `node.invoke` 捕获**照片**（`jpg`）或**短视频片段**（`mp4`，可选音频）。
- **Android 节点**（通过 Gateway 配对）：通过 `node.invoke` 捕获**照片**（`jpg`）或**短视频片段**（`mp4`，可选音频）。
- **macOS 应用**（通过 Gateway 的节点）：通过 `node.invoke` 捕获**照片**（`jpg`）或**短视频片段**（`mp4`，可选音频）。
+- **iOS 节点**（通过 Gateway网关配对）：通过 `node.invoke` 捕获**照片**（`jpg`）或**短视频片段**（`mp4`，可选音频）。
+- **Android 节点**（通过 Gateway网关配对）：通过 `node.invoke` 捕获**照片**（`jpg`）或**短视频片段**（`mp4`，可选音频）。
+- **macOS 应用**（通过 Gateway网关的节点）：通过 `node.invoke` 捕获**照片**（`jpg`）或**短视频片段**（`mp4`，可选音频）。

 所有相机访问都受**用户控制的设置**保护。

@@ -31,7 +31,7 @@ OpenClaw 支持智能体工作流中的**相机捕获**：
  - 默认：**开启**（缺少该键时视为已启用）。
  - 关闭时：`camera.*` 命令返回 `CAMERA_DISABLED`。

-### 命令（通过 Gateway `node.invoke`）
+### 命令（通过 Gateway网关 `node.invoke`）

 - `camera.list`
  - 响应载荷：
@@ -1,7 +1,7 @@
 ---
 read_when:
  - 修改媒体处理管道或附件
-summary: 发送、Gateway 和智能体回复的图片与媒体处理规则
+summary: 发送、Gateway网关和智能体回复的图片与媒体处理规则
 title: 图片与媒体支持
 x-i18n:
  generated_at: "2026-02-01T21:17:54Z"
@@ -14,7 +14,7 @@ x-i18n:

 # 图片与媒体支持 — 2025-12-05

-WhatsApp 渠道通过 **Baileys Web** 运行。本文档记录了发送、Gateway 和智能体回复的当前媒体处理规则。
+WhatsApp 渠道通过 **Baileys Web** 运行。本文档记录了发送、Gateway网关和智能体回复的当前媒体处理规则。

 ## 目标

@@ -1,6 +1,6 @@
 ---
 read_when:
-  - 将 iOS/Android 节点配对到 Gateway
+  - 将 iOS/Android 节点配对到 Gateway网关
  - 使用节点 canvas/相机为智能体提供上下文
  - 添加新的节点命令或 CLI 辅助工具
 summary: 节点：配对、能力、权限，以及 canvas/相机/屏幕/系统的 CLI 辅助工具
@@ -16,20 +16,20 @@ x-i18n:

 # 节点

-**节点**是一个伴侣设备（macOS/iOS/Android/无头），通过 **WebSocket**（与操作员相同的端口）以 `role: "node"` 连接到 Gateway，并通过 `node.invoke` 暴露命令接口（例如 `canvas.*`、`camera.*`、`system.*`）。协议详情：[Gateway 协议](/gateway/protocol)。
+**节点**是一个伴侣设备（macOS/iOS/Android/无头），通过 **WebSocket**（与操作员相同的端口）以 `role: "node"` 连接到 Gateway网关，并通过 `node.invoke` 暴露命令接口（例如 `canvas.*`、`camera.*`、`system.*`）。协议详情：[Gateway网关协议](/gateway/protocol)。

 旧版传输：[Bridge 协议](/gateway/bridge-protocol)（TCP JSONL；当前节点已弃用/移除）。

-macOS 也可以在**节点模式**下运行：菜单栏应用连接到 Gateway 的 WS 服务器，并将其本地 canvas/相机命令作为节点暴露（因此 `openclaw nodes …` 可以对该 Mac 使用）。
+macOS 也可以在**节点模式**下运行：菜单栏应用连接到 Gateway网关的 WS 服务器，并将其本地 canvas/相机命令作为节点暴露（因此 `openclaw nodes …` 可以对该 Mac 使用）。

 注意事项：

- 节点是**外围设备**，不是 Gateway。它们不运行 Gateway 服务。
- Telegram/WhatsApp 等消息到达的是 **Gateway**，而非节点。
+- 节点是**外围设备**，不是 Gateway网关。它们不运行 Gateway网关服务。
+- Telegram/WhatsApp 等消息到达的是 **Gateway网关**，而非节点。

 ## 配对 + 状态

-**WS 节点使用设备配对。** 节点在 `connect` 时提供设备身份；Gateway 为 `role: node` 创建设备配对请求。通过设备 CLI（或 UI）审批。
+**WS 节点使用设备配对。** 节点在 `connect` 时提供设备身份；Gateway网关为 `role: node` 创建设备配对请求。通过设备 CLI（或 UI）审批。

 快速 CLI：

@@ -44,15 +44,15 @@ openclaw nodes describe --node <idOrNameOrIp>
 注意事项：

 - `nodes status` 在设备配对角色包含 `node` 时将节点标记为**已配对**。
- `node.pair.*`（CLI：`openclaw nodes pending/approve/reject`）是一个独立的 Gateway 拥有的节点配对存储；它**不会**拦截 WS `connect` 握手。
+- `node.pair.*`（CLI：`openclaw nodes pending/approve/reject`）是一个独立的 Gateway网关拥有的节点配对存储；它**不会**拦截 WS `connect` 握手。

 ## 远程节点主机（system.run）

-当你的 Gateway 运行在一台机器上而你希望命令在另一台机器上执行时，使用**节点主机**。模型仍然与 **Gateway** 通信；当选择 `host=node` 时，Gateway 将 `exec` 调用转发给**节点主机**。
+当你的 Gateway网关运行在一台机器上而你希望命令在另一台机器上执行时，使用**节点主机**。模型仍然与 **Gateway网关** 通信；当选择 `host=node` 时，Gateway网关将 `exec` 调用转发给**节点主机**。

 ### 各部分运行位置

- **Gateway 主机**：接收消息，运行模型，路由工具调用。
+- **Gateway网关主机**：接收消息，运行模型，路由工具调用。
 - **节点主机**：在节点机器上执行 `system.run`/`system.which`。
 - **审批**：通过节点主机上的 `~/.openclaw/exec-approvals.json` 执行。

@@ -73,7 +73,7 @@ openclaw node restart

 ### 配对 + 命名

-在 Gateway 主机上：
+在 Gateway网关主机上：

 ```bash
 openclaw nodes pending
@@ -84,11 +84,11 @@ openclaw nodes list
 命名选项：

 - 在 `openclaw node run` / `openclaw node install` 上使用 `--display-name`（持久保存在节点的 `~/.openclaw/node.json` 中）。
- `openclaw nodes rename --node <id|name|ip> --name "Build Node"`（Gateway 覆盖）。
+- `openclaw nodes rename --node <id|name|ip> --name "Build Node"`（Gateway网关覆盖）。

 ### 将命令加入允许列表

-执行审批是**按节点主机**的。从 Gateway 添加允许列表条目：
+执行审批是**按节点主机**的。从 Gateway网关添加允许列表条目：

 ```bash
 openclaw approvals allowlist add --node <id|name|ip> "/usr/bin/uname"
@@ -99,7 +99,7 @@ openclaw approvals allowlist add --node <id|name|ip> "/usr/bin/sw_vers"

 ### 将执行指向节点

-配置默认值（Gateway 配置）：
+配置默认值（Gateway网关配置）：

 ```bash
 openclaw config set tools.exec.host node
@@ -249,7 +249,7 @@ macOS 节点暴露 `system.run`、`system.notify` 和 `system.execApprovals.get/

 ```bash
 openclaw nodes run --node <idOrNameOrIp> -- echo "Hello from mac node"
-openclaw nodes notify --node <idOrNameOrIp> --title "Ping" --body "Gateway ready"
+openclaw nodes notify --node <idOrNameOrIp> --title "Ping" --body "Gateway网关 ready"
 ```

 注意事项：
@@ -294,7 +294,7 @@ openclaw config unset agents.list[0].tools.exec.node

 ## 无头节点主机（跨平台）

-OpenClaw 可以运行**无头节点主机**（无 UI），它连接到 Gateway WebSocket 并暴露 `system.run` / `system.which`。这适用于 Linux/Windows 或在服务器旁运行一个最小节点。
+OpenClaw 可以运行**无头节点主机**（无 UI），它连接到 Gateway网关 WebSocket 并暴露 `system.run` / `system.which`。这适用于 Linux/Windows 或在服务器旁运行一个最小节点。

 启动方式：

@@ -304,13 +304,13 @@ openclaw node run --host <gateway-host> --port 18789

 注意事项：

- 仍然需要配对（Gateway 会显示节点审批提示）。
- 节点主机将其节点 ID、令牌、显示名称和 Gateway 连接信息存储在 `~/.openclaw/node.json` 中。
+- 仍然需要配对（Gateway网关会显示节点审批提示）。
+- 节点主机将其节点 ID、令牌、显示名称和 Gateway网关连接信息存储在 `~/.openclaw/node.json` 中。
 - 执行审批通过 `~/.openclaw/exec-approvals.json` 在本地执行（参见[执行审批](/tools/exec-approvals)）。
 - 在 macOS 上，无头节点主机在伴侣应用执行主机可达时优先使用它，不可用时回退到本地执行。设置 `OPENCLAW_NODE_EXEC_HOST=app` 以要求使用应用，或设置 `OPENCLAW_NODE_EXEC_FALLBACK=0` 以禁用回退。
- 当 Gateway WS 使用 TLS 时，添加 `--tls` / `--tls-fingerprint`。
+- 当 Gateway网关 WS 使用 TLS 时，添加 `--tls` / `--tls-fingerprint`。

 ## Mac 节点模式

- macOS 菜单栏应用作为节点连接到 Gateway WS 服务器（因此 `openclaw nodes …` 可以对该 Mac 使用）。
- 在远程模式下，应用为 Gateway 端口打开 SSH 隧道并连接到 `localhost`。
+- macOS 菜单栏应用作为节点连接到 Gateway网关 WS 服务器（因此 `openclaw nodes …` 可以对该 Mac 使用）。
+- 在远程模式下，应用为 Gateway网关端口打开 SSH 隧道并连接到 `localhost`。
@@ -97,9 +97,9 @@ x-i18n:

 推送触发流程（未来）：

-1. Gateway 向节点发送推送（静默推送或 FCM 数据）。
+1. Gateway网关向节点发送推送（静默推送或 FCM 数据）。
 2. 节点短暂唤醒并向设备请求位置。
-3. 节点将载荷转发给 Gateway。
+3. 节点将载荷转发给 Gateway网关。

 注意事项：

@@ -120,7 +120,7 @@ CLI 模板还可以使用：
 推荐默认值：

 - `maxChars`：图片/视频为 **500**（简短，适合命令解析）
- `maxChars`：音频**未设置**（完整转录，除非您设置限制）
+- `maxChars`：音频**未设置**（完整转录，除非你设置限制）
 - `maxBytes`：
  - 图片：**10MB**
  - 音频：**20MB**
@@ -135,7 +135,7 @@ CLI 模板还可以使用：

 ### 自动检测媒体理解（默认）

-如果 `tools.media.<capability>.enabled` **未**设置为 `false` 且您未配置模型，OpenClaw 会按以下顺序自动检测，并在**找到第一个可用选项时停止**：
+如果 `tools.media.<capability>.enabled` **未**设置为 `false` 且你未配置模型，OpenClaw 会按以下顺序自动检测，并在**找到第一个可用选项时停止**：

 1. **本地 CLI**（仅音频；如已安装）
   - `sherpa-onnx-offline`（需要 `SHERPA_ONNX_MODEL_DIR` 包含 encoder/decoder/joiner/tokens）
@@ -165,7 +165,7 @@ CLI 模板还可以使用：

 ## 能力（可选）

-如果您设置了 `capabilities`，该条目仅针对指定的媒体类型运行。对于共享列表，OpenClaw 可以推断默认值：
+如果你设置了 `capabilities`，该条目仅针对指定的媒体类型运行。对于共享列表，OpenClaw 可以推断默认值：

 - `openai`、`anthropic`、`minimax`：**图片**
 - `google`（Gemini API）：**图片 + 音频 + 视频**
@@ -73,7 +73,7 @@ x-i18n:
 - `interruptOnSpeech`：true
 - `voiceId`：回退到 `ELEVENLABS_VOICE_ID` / `SAG_VOICE_ID`（或在 API 密钥可用时使用第一个 ElevenLabs 语音）
 - `modelId`：未设置时默认为 `eleven_v3`
- `apiKey`：回退到 `ELEVENLABS_API_KEY`（或 Gateway shell 配置文件，如可用）
+- `apiKey`：回退到 `ELEVENLABS_API_KEY`（或 Gateway网关 shell 配置文件，如可用）
 - `outputFormat`：macOS/iOS 默认为 `pcm_44100`，Android 默认为 `pcm_24000`（设置 `mp3_*` 以强制 MP3 流式传输）

 ## macOS UI
@@ -2,7 +2,7 @@
 read_when:
  - 更改语音唤醒词行为或默认值
  - 添加需要唤醒词同步的新节点平台
-summary: 全局语音唤醒词（Gateway 拥有）及其在节点间的同步方式
+summary: 全局语音唤醒词（Gateway网关拥有）及其在节点间的同步方式
 title: 语音唤醒
 x-i18n:
  generated_at: "2026-02-01T21:19:01Z"
@@ -15,15 +15,15 @@ x-i18n:

 # 语音唤醒（全局唤醒词）

-OpenClaw 将**唤醒词视为由 Gateway 拥有的单一全局列表**。
+OpenClaw 将**唤醒词视为由 Gateway网关拥有的单一全局列表**。

 - **没有按节点自定义的唤醒词**。
- **任何节点/应用界面均可编辑**该列表；更改由 Gateway 持久化并广播给所有人。
+- **任何节点/应用界面均可编辑**该列表；更改由 Gateway网关持久化并广播给所有人。
 - 每个设备仍保留自己的**语音唤醒 启用/禁用**开关（本地用户体验和权限各异）。

-## 存储（Gateway 主机）
+## 存储（Gateway网关主机）

-唤醒词存储在 Gateway 机器上：
+唤醒词存储在 Gateway网关机器上：

 - `~/.openclaw/settings/voicewake.json`

@@ -64,9 +64,9 @@ OpenClaw 将**唤醒词视为由 Gateway 拥有的单一全局列表**。
 ### iOS 节点

 - 使用全局列表进行 `VoiceWakeManager` 触发词检测。
- 在设置中编辑唤醒词会调用 `voicewake.set`（通过 Gateway WS），同时保持本地唤醒词检测的即时响应。
+- 在设置中编辑唤醒词会调用 `voicewake.set`（通过 Gateway网关 WS），同时保持本地唤醒词检测的即时响应。

 ### Android 节点

 - 在设置中提供唤醒词编辑器。
- 通过 Gateway WS 调用 `voicewake.set`，使编辑在所有设备间同步。
+- 通过 Gateway网关 WS 调用 `voicewake.set`，使编辑在所有设备间同步。