chore(i18n): refresh zh-CN translations

2026-04-27 14:32:17 +00:00 · 2026-04-27 14:32:17 +00:00 · f36409e286
commit f36409e286
parent 35b68fc443
2 changed files with 71 additions and 71 deletions
--- a/docs/zh-CN/cli/update.md
+++ b/docs/zh-CN/cli/update.md
@ -1,14 +1,14 @@
 ---
 read_when:
-    - 你想要安全地更新源代码检出副本
-    - 你需要理解 `--update` 的简写行为
+    - 你想安全地更新一个源代码检出副本
+    - 你需要了解 `--update` 简写行为
 summary: '`openclaw update` 的 CLI 参考（相对安全的源更新 + Gateway 网关自动重启）'
 title: 更新
 x-i18n:
-    generated_at: "2026-04-27T07:27:58Z"
+    generated_at: "2026-04-27T14:31:40Z"
    model: gpt-5.4
    provider: openai
-    source_hash: e4a8fe1ed5a699bbdbd4a6784bb910f41f8e85c4904643f8fd23a8d0da4413a6
+    source_hash: 45e9bd031acc6cc5a92631ff7120bf32535af8514be6c7d785c8f8b475a018bd
    source_path: cli/update.md
    workflow: 15
 ---
@ -17,7 +17,7 @@ x-i18n:

 安全地更新 OpenClaw，并在 stable/beta/dev 渠道之间切换。

-如果你通过 **npm/pnpm/bun** 安装（全局安装，没有 git 元数据），更新将通过 [Updating](/zh-CN/install/updating) 中的软件包管理器流程进行。
+如果你通过 **npm/pnpm/bun** 安装（全局安装，无 git 元数据），更新会通过[更新](/zh-CN/install/updating)中的包管理器流程进行。

 ## 用法

@ -38,12 +38,12 @@ openclaw --update

 ## 选项

- `--no-restart`：成功更新后跳过重启 Gateway 网关服务。对于确实会重启 Gateway 网关的软件包管理器更新，命令只有在验证重启后的服务报告了预期的更新版本后才会成功。
+- `--no-restart`：成功更新后跳过重启 Gateway 网关服务。对于确实会重启 Gateway 网关的包管理器更新，命令只有在验证重启后的服务报告了预期的更新版本后才会成功。
 - `--channel <stable|beta|dev>`：设置更新渠道（git + npm；会持久化到配置中）。
- `--tag <dist-tag|version|spec>`：仅为此次更新覆盖软件包目标。对于软件包安装，`main` 会映射到 `github:openclaw/openclaw#main`。
- `--dry-run`：预览计划执行的更新操作（渠道/标签/目标/重启流程），不会写入配置、安装、同步插件或重启。
- `--json`：输出机器可读的 `UpdateRunResult` JSON；当在更新后的插件同步期间检测到 npm 插件工件漂移时，其中包括 `postUpdate.plugins.integrityDrifts`。
- `--timeout <seconds>`：每个步骤的超时时间（默认 1800 秒）。
+- `--tag <dist-tag|version|spec>`：仅为本次更新覆盖包目标。对于包安装，`main` 会映射到 `github:openclaw/openclaw#main`。
+- `--dry-run`：预览计划执行的更新操作（渠道/标签/目标/重启流程），但不写入配置、不安装、不同步插件，也不重启。
+- `--json`：打印机器可读的 `UpdateRunResult` JSON；当在更新后插件同步期间检测到 npm 插件产物漂移时，其中包含 `postUpdate.plugins.integrityDrifts`。
+- `--timeout <seconds>`：每个步骤的超时时间（默认为 1800 秒）。
 - `--yes`：跳过确认提示（例如降级确认）。

 <Warning>
@ -52,7 +52,7 @@ openclaw --update

 ## `update status`

-显示当前生效的更新渠道，以及 git 标签/分支/SHA（对于源代码检出副本），并显示更新可用性。
+显示当前激活的更新渠道 + git 标签/分支/SHA（对于源代码检出副本），以及是否有可用更新。

 ```bash
 openclaw update status
@ -62,30 +62,30 @@ openclaw update status --timeout 10

 选项：

- `--json`：输出机器可读的状态 JSON。
- `--timeout <seconds>`：检查超时时间（默认 3 秒）。
+- `--json`：打印机器可读的状态 JSON。
+- `--timeout <seconds>`：检查的超时时间（默认为 3 秒）。

 ## `update wizard`

-用于选择更新渠道并确认更新后是否重启 Gateway 网关的交互式流程（默认会重启）。如果你在没有 git 检出副本的情况下选择 `dev`，它会提供创建检出副本的选项。
+交互式流程，用于选择更新渠道，并确认更新后是否重启 Gateway 网关（默认会重启）。如果你在没有 git 检出副本的情况下选择 `dev`，它会提供创建一个检出副本的选项。

 选项：

 - `--timeout <seconds>`：每个更新步骤的超时时间（默认 `1800`）

-## 它会做什么
+## 它的作用

-当你显式切换渠道（`--channel ...`）时，OpenClaw 还会保持安装方式与之对齐：
+当你显式切换渠道（`--channel ...`）时，OpenClaw 也会保持安装方式一致：

 - `dev` → 确保存在一个 git 检出副本（默认：`~/openclaw`，可通过 `OPENCLAW_GIT_DIR` 覆盖），更新它，并从该检出副本安装全局 CLI。
 - `stable` → 使用 `latest` 从 npm 安装。
- `beta` → 优先使用 npm 的 `beta` dist-tag，但当 beta 缺失或比当前 stable 发布版本更旧时，会回退到 `latest`。
+- `beta` → 优先使用 npm 的 `beta` dist-tag，但当 beta 缺失或比当前 stable 版本更旧时，会回退到 `latest`。

 Gateway 网关核心自动更新器（在配置中启用时）会复用这条相同的更新路径。

-对于软件包管理器安装，`openclaw update` 会在调用软件包管理器之前解析目标软件包版本。即使已安装版本已经与目标一致，该命令仍会刷新全局软件包安装，然后执行插件同步、核心命令补全刷新以及重启相关工作。这样可以让打包的 sidecar 和渠道所拥有的插件记录与已安装的 OpenClaw 构建保持一致，同时将完整的插件命令补全重建留给显式的 `openclaw completion --write-state` 运行来完成。
+对于包管理器安装，`openclaw update` 会在调用包管理器之前解析目标包版本。npm 全局安装使用分阶段安装：OpenClaw 会先将新包安装到临时 npm prefix 中，在那里验证打包后的 `dist` 清单，然后再将这个干净的包树替换进真实的全局 prefix。如果验证失败，更新后的 doctor、插件同步和重启操作都不会在可疑的包树上运行。即使已安装版本已经与目标版本一致，该命令仍会刷新全局包安装，然后执行插件同步、核心命令补全刷新和重启操作。这样可以让打包的 sidecar 和渠道拥有的插件记录与已安装的 OpenClaw 构建保持一致，同时将完整的插件命令补全重建留给显式执行的 `openclaw completion --write-state`。

-## git 检出副本流程
+## Git 检出副本流程

 ### 渠道选择

@ -106,44 +106,44 @@ Gateway 网关核心自动更新器（在配置中启用时）会复用这条相
    仅适用于 dev。
  </Step>
  <Step title="预检构建（仅 dev）">
-    在临时工作树中运行 lint 和 TypeScript 构建。如果最新提交失败，会最多回退 10 个提交，以找到最新一个可成功构建的提交。
+    在临时工作树中运行 lint 和 TypeScript 构建。如果最新提交失败，会最多向前回退 10 个提交，以找到最新一个可干净构建的提交。
  </Step>
  <Step title="Rebase">
-    rebase 到所选提交上（仅 dev）。
+    rebase 到所选提交之上（仅适用于 dev）。
  </Step>
  <Step title="安装依赖">
-    使用仓库的软件包管理器。对于 pnpm 检出副本，更新器会按需引导安装 `pnpm`（先通过 `corepack`，然后回退到临时执行 `npm install pnpm@10`），而不是在 pnpm workspace 中运行 `npm run build`。
+    使用仓库的包管理器。对于 pnpm 检出副本，更新器会按需引导 `pnpm`（先通过 `corepack`，然后回退到临时执行 `npm install pnpm@10`），而不是在 pnpm workspace 中运行 `npm run build`。
  </Step>
  <Step title="构建 Control UI">
-    构建网关和 Control UI。
+    构建 gateway 和 Control UI。
  </Step>
-  <Step title="运行 Doctor">
+  <Step title="运行 doctor">
    `openclaw doctor` 会作为最终的安全更新检查运行。
  </Step>
  <Step title="同步插件">
-    将插件同步到当前渠道。Dev 使用内置插件；stable 和 beta 使用 npm。会更新通过 npm 安装的插件。
+    将插件同步到当前渠道。Dev 使用内置插件；stable 和 beta 使用 npm。还会更新通过 npm 安装的插件。
  </Step>
 </Steps>

 <Warning>
-如果某个精确固定版本的 npm 插件更新解析到的工件，其完整性与存储的安装记录不同，`openclaw update` 会中止该插件工件更新，而不是安装它。只有在确认你信任该新工件后，才应显式重新安装或更新该插件。
+如果某个精确固定版本的 npm 插件更新解析到的产物，其完整性与存储的安装记录不同，`openclaw update` 会中止该插件产物更新，而不是安装它。只有在确认你信任这个新产物之后，才应显式重新安装或更新该插件。
 </Warning>

 <Note>
-更新后的插件同步失败会导致更新结果失败，并停止后续的重启相关工作。请先修复插件安装或更新错误，然后重新运行 `openclaw update`。
+更新后的插件同步失败会导致更新结果失败，并停止后续重启操作。请先修复插件安装或更新错误，然后重新运行 `openclaw update`。

-当更新后的 Gateway 网关启动时，已启用的内置插件运行时依赖会在插件激活前完成暂存。由更新触发的重启会在关闭 Gateway 网关之前排空所有活跃的运行时依赖暂存，因此服务管理器重启不会中断正在进行中的 npm 安装。
+当更新后的 Gateway 网关启动时，已启用的内置插件运行时依赖会在插件激活前完成暂存。由更新触发的重启会在关闭 Gateway 网关之前排空所有活跃的运行时依赖暂存，因此服务管理器执行的重启不会打断正在进行中的 npm 安装。

-如果 pnpm 引导安装仍然失败，更新器会尽早停止，并返回特定于软件包管理器的错误，而不是尝试在检出副本中运行 `npm run build`。
+如果 pnpm 引导仍然失败，更新器会提前停止，并报告特定于包管理器的错误，而不会尝试在检出副本中运行 `npm run build`。
 </Note>

 ## `--update` 简写

-`openclaw --update` 会被改写为 `openclaw update`（对 shell 和启动脚本很有用）。
+`openclaw --update` 会重写为 `openclaw update`（对 shell 和启动脚本很有用）。

-## 相关内容
+## 相关

- `openclaw doctor`（在 git 检出副本上会先提供运行更新的选项）
- [Development channels](/zh-CN/install/development-channels)
- [Updating](/zh-CN/install/updating)
- [CLI reference](/zh-CN/cli)
+- `openclaw doctor`（在 git 检出副本中会先提供运行 update 的选项）
+- [开发渠道](/zh-CN/install/development-channels)
+- [更新](/zh-CN/install/updating)
+- [CLI 参考](/zh-CN/cli)
--- a/docs/zh-CN/install/updating.md
+++ b/docs/zh-CN/install/updating.md
@ -5,15 +5,15 @@ read_when:
 summary: 安全更新 OpenClaw（全局安装或源码安装），以及回滚策略
 title: 更新中
 x-i18n:
-    generated_at: "2026-04-27T09:02:34Z"
+    generated_at: "2026-04-27T14:31:37Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 1f0ab7bf825068a5e2590011faab637d3ffe8d475f1737051d1726c93316af2a
+    source_hash: 17d4839002b153976e014e0eefcb44f92dcb9bb45b81bf30efb1e8e8c0f30ec3
    source_path: install/updating.md
    workflow: 15
 ---

-保持 OpenClaw 为最新版本。
+让 OpenClaw 保持最新。

 ## 推荐：`openclaw update`

@ -23,7 +23,7 @@ x-i18n:
 openclaw update
 ```

-如需切换渠道或指定特定版本：
+如需切换通道或指定特定版本：

 ```bash
 openclaw update --channel beta
@ -32,16 +32,16 @@ openclaw update --tag main
 openclaw update --dry-run   # 仅预览，不实际应用
 ```

-`--channel beta` 会优先选择 beta，但当 beta 标签不存在，或其版本比最新 stable 发布更旧时，运行时会回退到 stable/latest。如果你想要一次性使用原始 npm beta dist-tag 进行包更新，请使用 `--tag beta`。
+`--channel beta` 会优先选择 beta，但当 beta 标签缺失或版本比最新 stable 发布版更旧时，运行时会回退到 stable/latest。如果你想进行一次性的包更新并使用原始的 npm beta dist-tag，请使用 `--tag beta`。

-有关渠道语义，请参阅 [Development channels](/zh-CN/install/development-channels)。
+通道语义请参阅 [Development channels](/zh-CN/install/development-channels)。

-## 在 npm 和 git 安装之间切换
+## 在 npm 安装和 git 安装之间切换

-当你想更改安装类型时，请使用渠道。更新器会保留你在 `~/.openclaw` 中的状态、配置、凭证和工作区；它只会更改 CLI 和 Gateway 网关所使用的 OpenClaw 代码安装来源。
+当你想更改安装类型时，请使用通道。更新器会保留你在 `~/.openclaw` 中的状态、配置、凭证和工作区；它只会更改 CLI 和 Gateway 网关所使用的 OpenClaw 代码安装方式。

 ```bash
-# npm 包安装 -> 可编辑的 git 检出
+# npm 包安装 -> 可编辑 git 检出
 openclaw update --channel dev

 # git 检出 -> npm 包安装
@ -55,17 +55,17 @@ openclaw update --channel dev --dry-run
 openclaw update --channel stable --dry-run
 ```

-`dev` 渠道会确保存在一个 git 检出，对其进行构建，并从该检出安装全局 CLI。`stable` 和 `beta` 渠道使用包安装方式。如果 Gateway 网关已经安装，`openclaw update` 会刷新服务元数据并重启它，除非你传入 `--no-restart`。
+`dev` 通道会确保存在一个 git 检出，对其进行构建，并从该检出安装全局 CLI。`stable` 和 `beta` 通道使用包安装。如果 Gateway 网关已经安装，`openclaw update` 会刷新服务元数据并重启它，除非你传入 `--no-restart`。

-## 备选方案：重新运行安装脚本
+## 另一种方式：重新运行安装脚本

 ```bash
 curl -fsSL https://openclaw.ai/install.sh | bash
 ```

-添加 `--no-onboard` 可跳过新手引导。要通过安装脚本强制指定安装类型，请传入 `--install-method git --no-onboard` 或 `--install-method npm --no-onboard`。
+添加 `--no-onboard` 可跳过新手引导。如需通过安装器强制指定安装类型，传入 `--install-method git --no-onboard` 或 `--install-method npm --no-onboard`。

-如果 `openclaw update` 在 npm 包安装阶段之后失败，请重新运行安装脚本。安装脚本不会调用旧版更新器；它会直接运行全局包安装，因此可以恢复部分更新失败的 npm 安装。
+如果 `openclaw update` 在 npm 包安装阶段之后失败，请重新运行安装器。安装器不会调用旧的更新器；它会直接运行全局包安装，因此可以恢复部分更新失败的 npm 安装。

 ```bash
 curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm
@ -77,13 +77,13 @@ curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm
 curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>
 ```

-## 备选方案：手动使用 npm、pnpm 或 bun
+## 另一种方式：手动使用 npm、pnpm 或 bun

 ```bash
 npm i -g openclaw@latest
 ```

-当 `openclaw update` 管理全局 npm 安装时，它会先运行常规的全局安装命令。如果该命令失败，OpenClaw 会使用 `--omit=optional` 重试一次。这次重试有助于解决原生可选依赖无法编译的主机场景，同时如果回退方案也失败，原始失败信息仍会保留并可见。
+当 `openclaw update` 管理全局 npm 安装时，它会先将目标版本安装到一个临时 npm prefix 中，验证已打包的 `dist` 清单，然后再将干净的包树替换到真实的全局 prefix 中。这样可以避免 npm 把新包覆盖到旧包遗留文件之上。如果安装命令失败，OpenClaw 会使用 `--omit=optional` 重试一次。这个重试有助于处理那些无法编译原生可选依赖的主机，同时如果回退方案也失败，仍会保留原始失败信息。

 ```bash
 pnpm add -g openclaw@latest
@ -97,12 +97,12 @@ bun add -g openclaw@latest

 <AccordionGroup>
  <Accordion title="只读包树">
-    OpenClaw 在运行时会将打包的全局安装视为只读，即使当前用户对全局包目录具有写权限也是如此。内置插件的运行时依赖会暂存到可写的运行时目录中，而不是直接修改包树。这样可以避免在同一次安装期间，`openclaw update` 与正在修复插件依赖的 Gateway 网关或本地智能体发生竞争。
+    OpenClaw 在运行时会将已打包的全局安装视为只读，即使当前用户对全局包目录有写权限也是如此。内置插件的运行时依赖会暂存到一个可写的运行时目录，而不是修改包树本身。这样可以避免在同一次安装期间，`openclaw update` 与正在修复插件依赖的运行中 Gateway 网关或本地智能体发生竞争。

-    某些 Linux npm 配置会将全局包安装到由 root 拥有的目录下，例如 `/usr/lib/node_modules/openclaw`。OpenClaw 通过相同的外部暂存路径支持这种布局。
+    某些 Linux npm 配置会将全局包安装到 root 拥有的目录中，例如 `/usr/lib/node_modules/openclaw`。OpenClaw 通过同样的外部暂存路径支持这种布局。

  </Accordion>
-  <Accordion title="强化的 systemd 单元">
+  <Accordion title="加固的 systemd 单元">
    设置一个包含在 `ReadWritePaths` 中的可写暂存目录：

    ```ini
@ -110,30 +110,30 @@ bun add -g openclaw@latest
    ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp
    ```

-    `OPENCLAW_PLUGIN_STAGE_DIR` 也接受路径列表。OpenClaw 会按照从左到右的顺序，在列出的根目录中解析内置插件的运行时依赖，将前面的根目录视为只读的预安装层，并且只在最后一个可写根目录中安装或修复：
+    `OPENCLAW_PLUGIN_STAGE_DIR` 也接受路径列表。OpenClaw 会按照从左到右的顺序在列出的根路径中解析内置插件运行时依赖，将较前面的根视为只读的预安装层，并且只在最后一个可写根中进行安装或修复：

    ```ini
    Environment=OPENCLAW_PLUGIN_STAGE_DIR=/opt/openclaw/plugin-runtime-deps:/var/lib/openclaw/plugin-runtime-deps
    ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp
    ```

-    如果未设置 `OPENCLAW_PLUGIN_STAGE_DIR`，当 systemd 提供 `$STATE_DIRECTORY` 时，OpenClaw 会优先使用它；否则回退到 `~/.openclaw/plugin-runtime-deps`。修复步骤会将该暂存目录视为 OpenClaw 自有的本地包根目录，并忽略用户的 npm prefix 和全局设置，因此全局安装 npm 配置不会把内置插件依赖重定向到 `~/node_modules` 或全局包树中。
+    如果未设置 `OPENCLAW_PLUGIN_STAGE_DIR`，当 systemd 提供 `$STATE_DIRECTORY` 时，OpenClaw 会使用它；否则回退到 `~/.openclaw/plugin-runtime-deps`。修复步骤会将该暂存区视为一个由 OpenClaw 拥有的本地包根目录，并忽略用户的 npm prefix 和全局设置，因此全局安装的 npm 配置不会将内置插件依赖重定向到 `~/node_modules` 或全局包树中。

  </Accordion>
-  <Accordion title="磁盘空间预检查">
-    在包更新和内置运行时依赖修复之前，OpenClaw 会尽力对目标卷执行磁盘空间检查。空间不足时会针对被检查路径发出警告，但不会阻止更新，因为文件系统配额、快照和网络卷可能会在检查后发生变化。实际的 npm 安装、复制和安装后验证仍然是最终依据。
+  <Accordion title="磁盘空间预检">
+    在包更新和内置运行时依赖修复之前，OpenClaw 会尽力对目标卷执行磁盘空间检查。空间不足会生成一条警告，其中包含被检查的路径，但不会阻止更新，因为文件系统配额、快照和网络卷可能会在检查后发生变化。实际的 npm 安装、复制和安装后验证仍然是最终依据。
  </Accordion>
  <Accordion title="内置插件运行时依赖">
-    打包安装会将内置插件运行时依赖保留在只读包树之外。在启动期间以及执行 `openclaw doctor --fix` 时，OpenClaw 只会为以下内置插件修复运行时依赖：在配置中处于活动状态、通过旧版渠道配置处于活动状态，或由其内置清单默认启用。仅有已持久化的渠道认证状态，并不会触发 Gateway 网关启动时的运行时依赖修复。
+    已打包安装会将内置插件运行时依赖保留在只读包树之外。在启动时以及执行 `openclaw doctor --fix` 期间，OpenClaw 只会为以下内置插件修复运行时依赖：在配置中处于活跃状态、通过旧版渠道配置处于活跃状态，或由其内置清单默认启用的插件。仅有持久化的渠道认证状态，并不会触发 Gateway 网关启动时的运行时依赖修复。

-    显式禁用优先。已禁用的插件或渠道不会仅因存在于包中就修复其运行时依赖。外部插件和自定义加载路径仍然使用 `openclaw plugins install` 或 `openclaw plugins update`。
+    显式禁用具有最高优先级。被禁用的插件或渠道不会仅因为存在于包中就修复其运行时依赖。外部插件和自定义加载路径仍然使用 `openclaw plugins install` 或 `openclaw plugins update`。

  </Accordion>
 </AccordionGroup>

 ## 自动更新器

-自动更新器默认关闭。在 `~/.openclaw/openclaw.json` 中启用：
+自动更新器默认关闭。请在 `~/.openclaw/openclaw.json` 中启用：

 ```json5
 {
@ -149,14 +149,14 @@ bun add -g openclaw@latest
 }
 ```

-| 渠道 | 行为 |
-| -------- | ------------------------------------------------------------------------------------------------------------- |
-| `stable` | 等待 `stableDelayHours`，然后在 `stableJitterHours` 范围内使用确定性抖动进行应用（分散发布）。 |
+| Channel  | 行为 |
+| -------- | ---- |
+| `stable` | 等待 `stableDelayHours`，然后在 `stableJitterHours` 范围内按确定性抖动应用（分散发布）。 |
 | `beta`   | 每隔 `betaCheckIntervalHours` 检查一次（默认：每小时），并立即应用。 |
 | `dev`    | 不自动应用。请手动使用 `openclaw update`。 |

-Gateway 网关也会在启动时记录更新提示（可通过 `update.checkOnStart: false` 禁用）。
-对于降级或事故恢复，请在 Gateway 网关环境中设置 `OPENCLAW_NO_AUTO_UPDATE=1`，即使已配置 `update.auto.enabled` 也会阻止自动应用。除非同时禁用 `update.checkOnStart`，否则启动时的更新提示仍可能运行。
+Gateway 网关也会在启动时记录更新提示（可使用 `update.checkOnStart: false` 禁用）。
+如需降级或进行事故恢复，请在 Gateway 网关环境中设置 `OPENCLAW_NO_AUTO_UPDATE=1`，即使已配置 `update.auto.enabled`，也能阻止自动应用。除非同时禁用 `update.checkOnStart`，否则启动时的更新提示仍可能运行。

 ## 更新后

@ -168,7 +168,7 @@ Gateway 网关也会在启动时记录更新提示（可通过 `update.checkOnSt
 openclaw doctor
 ```

-迁移配置、审计私信策略，并检查 Gateway 网关健康状态。详情请参阅：[Doctor](/zh-CN/gateway/doctor)
+迁移配置、审计私信策略并检查 Gateway 网关健康状态。详情请参阅：[Doctor](/zh-CN/gateway/doctor)

 ### 重启 Gateway 网关

@ -195,7 +195,7 @@ openclaw gateway restart
 ```

 <Tip>
-`npm view openclaw version` 会显示当前已发布版本。
+`npm view openclaw version` 会显示当前已发布的版本。
 </Tip>

 ### 固定提交（源码）
@ -207,17 +207,17 @@ pnpm install && pnpm build
 openclaw gateway restart
 ```

-要恢复到最新版本：`git checkout main && git pull`。
+如需回到最新版本：`git checkout main && git pull`。

 ## 如果你卡住了

 - 再次运行 `openclaw doctor`，并仔细阅读输出内容。
- 对于源码检出上的 `openclaw update --channel dev`，更新器会在需要时自动引导安装 `pnpm`。如果你看到 pnpm/corepack 引导错误，请手动安装 `pnpm`（或重新启用 `corepack`），然后重新运行更新。
+- 对于源码检出的 `openclaw update --channel dev`，更新器会在需要时自动引导安装 `pnpm`。如果你看到 pnpm/corepack 引导错误，请手动安装 `pnpm`（或重新启用 `corepack`），然后重新运行更新。
 - 查看：[故障排除](/zh-CN/gateway/troubleshooting)
 - 在 Discord 中提问：[https://discord.gg/clawd](https://discord.gg/clawd)

 ## 相关内容

- [安装概览](/zh-CN/install)：所有安装方式。
+- [Install overview](/zh-CN/install)：所有安装方式。
 - [Doctor](/zh-CN/gateway/doctor)：更新后的健康检查。
- [迁移](/zh-CN/install/migrating)：主版本迁移指南。
+- [迁移](/zh-CN/install/migrating)：主要版本迁移指南。