chore(i18n): refresh zh-CN translations

2026-05-03 20:27:07 +00:00 · 2026-05-03 20:27:07 +00:00 · 1162614656
commit 1162614656
parent dcc4f63d43
2 changed files with 88 additions and 81 deletions
--- a/docs/zh-CN/cli/update.md
+++ b/docs/zh-CN/cli/update.md
@ -1,14 +1,15 @@
 ---
 read_when:
    - 你想安全地更新源代码检出副本
-    - 你需要了解 `--update` 的简写行为
-summary: '`openclaw update` 的 CLI 参考（相对安全的源代码更新 + Gateway 网关自动重启）'
+    - 你正在调试 `openclaw update` 输出或选项
+    - 你需要了解 `--update` 简写行为
+summary: CLI 参考：`openclaw update`（较安全的源更新 + Gateway 网关自动重启）
 title: 更新
 x-i18n:
-    generated_at: "2026-05-03T16:59:17Z"
+    generated_at: "2026-05-03T20:26:35Z"
    model: gpt-5.5
    provider: openai
-    source_hash: 767f3902877209f3945f50f7f8bd6ec7650a708685f1c4008d4191dc00eb1774
+    source_hash: 66bae6ee2b01c667aaf47dfb17fe8a2a5e39e884f157fead242d2f9d4040f817
    source_path: cli/update.md
    workflow: 16
 ---
@ -18,7 +19,7 @@ x-i18n:
 安全更新 OpenClaw，并在 stable/beta/dev 渠道之间切换。

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

 ## 用法

@ -39,22 +40,24 @@ 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`：预览计划的更新操作（渠道/tag/目标/重启流程），不写入配置、不安装、不同步插件，也不重启。
- `--json`：打印机器可读的 `UpdateRunResult` JSON，包括在更新后插件同步期间检测到 npm 插件产物漂移时的
+- `--tag <dist-tag|version|spec>`：仅为本次更新覆盖包目标。对于包安装，`main` 会映射到 `github:openclaw/openclaw#main`。
+- `--dry-run`：预览计划执行的更新操作（渠道/标签/目标/重启流程），不写入配置、不安装、不同步插件，也不重启。
+- `--json`：打印机器可读的 `UpdateRunResult` JSON，包括在更新后插件同步期间检测到 npm 插件工件漂移时的
  `postUpdate.plugins.integrityDrifts`。
- `--timeout <seconds>`：每个步骤的超时时间（默认 1800s）。
+- `--timeout <seconds>`：每个步骤的超时时间（默认是 1800 秒）。
 - `--yes`：跳过确认提示（例如降级确认）。

+`openclaw update` 没有 `--verbose` 标志。使用 `--dry-run` 预览计划的渠道/标签/安装/重启操作，使用 `--json` 获取机器可读结果；如果你只需要渠道和可用性详情，则使用 `openclaw update status --json`。如果你正在调试更新期间的 Gateway 网关日志，控制台详细程度和文件日志级别是分开的：Gateway 网关 `--verbose` 会影响终端/WebSocket 输出，而文件日志需要在配置中设置 `logging.level: "debug"` 或 `"trace"`。参见 [Gateway 网关日志](/zh-CN/gateway/logging)。
+
 <Warning>
-降级需要确认，因为旧版本可能会破坏配置。
+降级需要确认，因为旧版本可能破坏配置。
 </Warning>

 ## `update status`

-显示当前更新渠道 + git tag/分支/SHA（用于源码检出），以及更新可用性。
+显示当前更新渠道 + git 标签/分支/SHA（针对源码检出），以及更新可用性。

 ```bash
 openclaw update status
@ -64,12 +67,12 @@ openclaw update status --timeout 10

 选项：

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

 ## `update wizard`

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

 选项：

@ -77,25 +80,25 @@ openclaw update status --timeout 10

 ## 它会做什么

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

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

-Gateway 网关核心自动更新器（通过配置启用时）会在实时 Gateway 网关请求处理程序之外启动 CLI 更新路径。控制平面 `update.run` 包管理器更新会在包替换后强制执行非延迟、无冷却的更新重启，因为旧 Gateway 网关进程可能仍然在内存中保留指向新包已删除文件的 chunk。
+Gateway 网关核心自动更新器（通过配置启用时）会在实时 Gateway 网关请求处理程序之外启动 CLI 更新路径。控制平面 `update.run` 包管理器更新会在包替换后强制执行一次非延迟、无冷却的更新重启，因为旧 Gateway 网关进程内存中可能仍有指向新包已删除文件的分块。

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

-当安装了本地托管的 Gateway 网关服务并且启用了重启时，包管理器更新会在替换包树之前停止正在运行的服务，然后从更新后的安装刷新服务元数据，重启服务，并在报告成功之前验证重启后的 Gateway 网关报告预期版本。在 macOS 上，更新后检查还会验证 LaunchAgent 是否已为当前配置文件加载/运行，以及配置的 loopback 端口是否健康。如果 plist 已安装但 launchd 没有监管它，OpenClaw 会自动重新 bootstrap 并 kickstart LaunchAgent，然后重新运行健康/版本/渠道就绪检查。如果 Gateway 网关仍未变为健康状态，命令会以非零状态退出，并打印重启日志路径以及明确的重启、重新安装和包回滚说明。使用 `--no-restart` 时，包替换仍会运行，但托管服务不会停止或重启，因此正在运行的 Gateway 网关可能会继续使用旧代码，直到你手动重启它。
+当已安装本地托管的 Gateway 网关服务且启用重启时，包管理器更新会在替换包树前停止正在运行的服务，然后从更新后的安装刷新服务元数据，重启服务，并在报告成功前验证重启后的 Gateway 网关报告预期版本。在 macOS 上，更新后检查还会验证 LaunchAgent 已为当前配置文件加载/运行，并且配置的 loopback 端口健康。如果 plist 已安装但 launchd 未监管它，OpenClaw 会自动重新 bootstrap 并 kickstart LaunchAgent，然后重新运行健康/版本/渠道就绪检查。如果 Gateway 网关仍未变得健康，命令会以非零状态退出，并打印重启日志路径以及明确的重启、重新安装和包回滚说明。使用 `--no-restart` 时，包替换仍会运行，但托管服务不会被停止或重启，因此正在运行的 Gateway 网关可能会继续使用旧代码，直到你手动重启它。

 ## Git 检出流程

 ### 渠道选择

- `stable`：检出最新的非 beta tag，然后构建并运行 doctor。
- `beta`：优先使用最新的 `-beta` tag，但当 beta 缺失或更旧时回退到最新稳定版 tag。
+- `stable`：检出最新的非 beta 标签，然后构建并运行 Doctor。
+- `beta`：优先使用最新的 `-beta` 标签，但当 beta 缺失或较旧时，会回退到最新 stable 标签。
 - `dev`：检出 `main`，然后 fetch 并 rebase。

 ### 更新步骤
@ -105,52 +108,52 @@ Gateway 网关核心自动更新器（通过配置启用时）会在实时 Gatew
    要求没有未提交的更改。
  </Step>
  <Step title="切换渠道">
-    切换到所选渠道（tag 或分支）。
+    切换到所选渠道（标签或分支）。
  </Step>
-  <Step title="获取上游">
-    仅限 dev。
+  <Step title="Fetch upstream">
+    仅 dev。
  </Step>
-  <Step title="预检构建（仅限 dev）">
-    在临时工作树中运行 lint 和 TypeScript 构建。如果 tip 失败，会向前回退最多 10 个提交，以找到最新的干净构建。
+  <Step title="预检构建（仅 dev）">
+    在临时工作树中运行 lint 和 TypeScript 构建。如果 tip 失败，会最多向前回退 10 个提交，以找到最新的干净构建。
  </Step>
  <Step title="Rebase">
-    Rebase 到所选提交（仅限 dev）。
+    Rebase 到所选提交（仅 dev）。
  </Step>
  <Step title="安装依赖">
-    使用仓库包管理器。对于 pnpm 检出，更新器会按需 bootstrap `pnpm`（先通过 `corepack`，再回退到临时 `npm install pnpm@10`），而不是在 pnpm 工作区内运行 `npm run build`。
+    使用仓库包管理器。对于 pnpm 检出，更新器会按需 bootstrap `pnpm`（先通过 `corepack`，再使用临时 `npm install pnpm@10` 回退），而不是在 pnpm workspace 内运行 `npm run build`。
  </Step>
-  <Step title="构建控制 UI">
-    构建 Gateway 网关和控制 UI。
+  <Step title="构建 Control UI">
+    构建 Gateway 网关和 Control UI。
  </Step>
-  <Step title="运行 doctor">
+  <Step title="运行 Doctor">
    `openclaw doctor` 会作为最终的安全更新检查运行。
  </Step>
  <Step title="同步插件">
-    将插件同步到当前渠道。Dev 使用内置插件；stable 和 beta 使用 npm。更新被跟踪的插件安装。
+    将插件同步到当前渠道。dev 使用内置插件；stable 和 beta 使用 npm。会更新已跟踪的插件安装。
  </Step>
 </Steps>

-在 beta 更新渠道上，跟随默认/latest 线路的已跟踪 npm 和 ClawHub 插件安装会先尝试插件 `@beta` 发布。如果插件没有 beta 发布，OpenClaw 会回退到记录的默认/latest spec。精确版本和显式 tag 不会被重写。
+在 beta 更新渠道上，跟随默认/latest 线的已跟踪 npm 和 ClawHub 插件安装会先尝试插件 `@beta` 发布。如果插件没有 beta 发布，OpenClaw 会回退到记录的默认/latest spec。精确版本和显式标签不会被改写。

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

 <Note>
-更新后插件同步失败会使更新结果失败，并停止后续重启工作。修复插件安装或更新错误后，再重新运行 `openclaw update`。
+更新后插件同步失败会让更新结果失败，并停止后续重启工作。修复插件安装或更新错误，然后重新运行 `openclaw update`。

-当更新后的 Gateway 网关启动时，插件加载仅执行验证：启动不会运行包管理器，也不会改变依赖树。包管理器 `update.run` 重启会在包树被替换后绕过正常的空闲延迟和重启冷却，因此旧进程无法继续懒加载已删除的 chunk。
+更新后的 Gateway 网关启动时，插件加载仅做验证：启动不会运行包管理器，也不会修改依赖树。包管理器 `update.run` 重启会在包树替换后绕过正常的空闲延迟和重启冷却，因此旧进程无法继续 lazy-loading 已删除的分块。

-如果 pnpm bootstrap 仍然失败，更新器会提前停止并给出包管理器特定错误，而不是尝试在检出中运行 `npm run build`。
+如果 pnpm bootstrap 仍然失败，更新器会提前停止并报告包管理器特定错误，而不是尝试在检出内运行 `npm run build`。
 </Note>

 ## `--update` 简写

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

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

- `openclaw doctor`（在 git 检出上会提供先运行更新的选项）
+- `openclaw doctor`（在 git 检出中会提示先运行更新）
 - [开发渠道](/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,10 +5,10 @@ read_when:
 summary: 安全更新 OpenClaw（全局安装或源码），以及回滚策略
 title: 更新
 x-i18n:
-    generated_at: "2026-05-01T20:38:42Z"
+    generated_at: "2026-05-03T20:26:20Z"
    model: gpt-5.5
    provider: openai
-    source_hash: 84bf4462a4ee041b0d22e433d1e9f44cfd799a5c327ba94f9df96595d92bdb3c
+    source_hash: f9e26ea71748dfd1573cdca01126bf29ebc56be56eac604e2b6a009b463820d1
    source_path: install/updating.md
    workflow: 16
 ---
@ -17,7 +17,7 @@ x-i18n:

 ## 推荐：`openclaw update`

-最快的更新方式。它会检测你的安装类型（npm 或 git），获取最新版本，运行 `openclaw doctor`，并重启 Gateway 网关。
+这是最快的更新方式。它会检测你的安装类型（npm 或 git）、获取最新版本、运行 `openclaw doctor`，并重启 Gateway 网关。

 ```bash
 openclaw update
@ -32,15 +32,21 @@ openclaw update --tag main
 openclaw update --dry-run   # preview without applying
 ```

-`--channel beta` 优先使用 beta，但当 beta 标签缺失或早于最新稳定版时，
-运行时会回退到 stable/latest。如果你想为一次性包更新使用原始 npm beta dist-tag，
+`openclaw update` 不接受 `--verbose`。对于更新诊断，请使用
+`--dry-run` 预览计划执行的操作，使用 `--json` 获取结构化结果，或使用
+`openclaw update status --json` 检查渠道和可用性状态。
+安装程序有自己的 `--verbose` 标志，但该标志不属于
+`openclaw update`。
+
+`--channel beta` 会优先使用 beta，但当 beta 标签缺失或早于最新 stable 版本时，
+运行时会回退到 stable/latest。如果你想为一次性软件包更新使用原始 npm beta dist-tag，
 请使用 `--tag beta`。

-查看 [开发渠道](/zh-CN/install/development-channels) 了解渠道语义。
+参见 [开发渠道](/zh-CN/install/development-channels) 了解渠道语义。

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

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

@ -52,30 +58,30 @@ openclaw update --channel dev
 openclaw update --channel stable
 ```

-先使用 `--dry-run` 运行，以预览确切的安装模式切换：
+请先使用 `--dry-run` 运行，以预览确切的安装模式切换：

 ```bash
 openclaw update --channel dev --dry-run
 openclaw update --channel stable --dry-run
 ```

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

-## 替代方式：重新运行安装器
+## 替代方式：重新运行安装程序

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

-添加 `--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
@ -94,11 +100,10 @@ npm i -g openclaw@latest
 ```

 当 `openclaw update` 管理全局 npm 安装时，它会先把目标安装到
-临时 npm prefix，验证打包的 `dist` 清单，然后把干净的包树切换
-到真正的全局 prefix。这样可以避免 npm 将新包覆盖到旧包遗留的过期文件上。
-如果安装命令失败，OpenClaw 会使用 `--omit=optional` 重试一次。
-该重试有助于原生可选依赖无法编译的主机，同时如果回退也失败，
-仍会显示原始失败。
+临时 npm prefix 中，验证打包的 `dist` 清单，然后把干净的软件包树交换到
+真实的全局 prefix 中。这样可以避免 npm 将新软件包覆盖到旧软件包残留文件上。
+如果安装命令失败，OpenClaw 会使用 `--omit=optional` 重试一次。该重试有助于
+原生可选依赖无法编译的主机，同时如果回退也失败，仍会显示原始失败。

 ```bash
 pnpm add -g openclaw@latest
@ -111,13 +116,13 @@ bun add -g openclaw@latest
 ### 高级 npm 安装主题

 <AccordionGroup>
-  <Accordion title="只读包树">
-    OpenClaw 在运行时会将打包的全局安装视为只读，即使当前用户可以写入全局包目录。插件包安装位于用户配置目录下由 OpenClaw 拥有的 npm/git 根目录中，并且 Gateway 网关启动不会修改 OpenClaw 包树。
+  <Accordion title="只读软件包树">
+    OpenClaw 在运行时会将打包的全局安装视为只读，即使当前用户可以写入全局软件包目录。插件软件包安装位于用户配置目录下由 OpenClaw 拥有的 npm/git 根目录中，并且 Gateway 网关启动不会修改 OpenClaw 软件包树。

-    一些 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 单元">
    授予 OpenClaw 对其配置/状态根目录的写入权限，以便显式插件安装、插件更新和 Doctor 清理可以持久化其更改：

    ```ini
@ -126,13 +131,13 @@ bun add -g openclaw@latest

  </Accordion>
  <Accordion title="磁盘空间预检">
-    在包更新和显式插件安装之前，OpenClaw 会尽力对目标卷执行磁盘空间检查。空间不足会生成一条带有已检查路径的警告，但不会阻止更新，因为文件系统配额、快照和网络卷可能会在检查后发生变化。实际的包管理器安装和安装后验证仍然是权威结果。
+    在软件包更新和显式插件安装之前，OpenClaw 会尽力检查目标卷的磁盘空间。空间不足会产生包含已检查路径的警告，但不会阻止更新，因为文件系统配额、快照和网络卷可能会在检查后发生变化。实际的软件包管理器安装和安装后验证仍然是权威依据。
  </Accordion>
 </AccordionGroup>

-## 自动更新器
+## 自动更新程序

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

 ```json5
 {
@ -150,20 +155,19 @@ bun add -g openclaw@latest

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

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

-通过实时 Gateway 网关控制平面处理器请求的包管理器更新
-会在包切换后强制执行一次非延迟、无冷却的更新重启。这样可以
-避免旧的内存中进程停留过久，从已被替换的包树中延迟加载 chunks。
-对于受监管的安装，Shell `openclaw update` 仍是首选路径，因为它可以在更新前后停止并
-重启服务。
+通过实时 Gateway 网关控制平面处理程序请求的软件包管理器更新会在软件包交换后
+强制执行非延迟、无冷却时间的更新重启。这样可以避免旧的内存中进程停留过久，
+并从已被替换的软件包树中延迟加载 chunk。对于受监管的安装，shell `openclaw update`
+仍然是首选路径，因为它可以在更新前后停止并重启服务。

-## 更新后
+## 更新之后

 <Steps>

@ -173,7 +177,7 @@ Gateway 网关还会在启动时记录一条更新提示（可用 `update.checkO
 openclaw doctor
 ```

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

 ### 重启 Gateway 网关

@ -214,14 +218,14 @@ openclaw gateway restart

 要返回到最新版本：`git checkout main && git pull`。

-## 如果你遇到问题
+## 如果你卡住了

 - 再次运行 `openclaw doctor`，并仔细阅读输出。
- 对于源码 checkout 上的 `openclaw update --channel dev`，更新器会在需要时自动引导 `pnpm`。如果你看到 pnpm/corepack 引导错误，请手动安装 `pnpm`（或重新启用 `corepack`），然后重新运行更新。
- 检查：[故障排除](/zh-CN/gateway/troubleshooting)
+- 对于源码 checkout 上的 `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)：所有安装方法。
 - [Doctor](/zh-CN/gateway/doctor)：更新后的健康检查。