chore(i18n): refresh zh-CN translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-27 07:28:32 +00:00
parent 5f2d66ba75
commit 3d6d5ed846

View File

@ -1,14 +1,14 @@
---
read_when:
- 你想安全地更新源代码检出副本
- 你需要了解 `--update` 简写行为
- 你想安全地更新源代码检出副本
- 你需要理解 `--update`简写行为
summary: '`openclaw update` 的 CLI 参考(相对安全的源更新 + Gateway 网关自动重启)'
title: 更新
x-i18n:
generated_at: "2026-04-27T06:03:25Z"
generated_at: "2026-04-27T07:27:58Z"
model: gpt-5.4
provider: openai
source_hash: 3089126cb245ed6011fa4829018f67e3a16c983bc7a4dfbe80371ef53e2db47b
source_hash: e4a8fe1ed5a699bbdbd4a6784bb910f41f8e85c4904643f8fd23a8d0da4413a6
source_path: cli/update.md
workflow: 15
---
@ -17,8 +17,7 @@ x-i18n:
安全地更新 OpenClaw并在 stable/beta/dev 渠道之间切换。
如果你通过 **npm/pnpm/bun** 安装(全局安装,无 git 元数据),
更新会通过 [更新](/zh-CN/install/updating) 中的软件包管理器流程进行。
如果你通过 **npm/pnpm/bun** 安装(全局安装,没有 git 元数据),更新将通过 [Updating](/zh-CN/install/updating) 中的软件包管理器流程进行。
## 用法
@ -41,10 +40,10 @@ openclaw --update
- `--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>
@ -53,7 +52,7 @@ openclaw --update
## `update status`
显示当前更新渠道 + git 标签/分支/SHA适用于源代码检出以及是否有可用更新
显示当前生效的更新渠道,以及 git 标签/分支/SHA对于源代码检出副本并显示更新可用性
```bash
openclaw update status
@ -63,14 +62,12 @@ openclaw update status --timeout 10
选项:
- `--json`打印机器可读的状态 JSON。
- `--json`输出机器可读的状态 JSON。
- `--timeout <seconds>`:检查超时时间(默认 3 秒)。
## `update wizard`
交互式流程,用于选择更新渠道并确认更新后是否重启 Gateway 网关
(默认会重启)。如果你选择 `dev` 但没有 git 检出,
它会提供创建检出的选项。
用于选择更新渠道并确认更新后是否重启 Gateway 网关的交互式流程(默认会重启)。如果你在没有 git 检出副本的情况下选择 `dev`,它会提供创建检出副本的选项。
选项:
@ -78,31 +75,23 @@ openclaw update status --timeout 10
## 它会做什么
当你显式切换渠道时(`--channel ...`OpenClaw 也会保持
安装方式一致:
当你显式切换渠道(`--channel ...`OpenClaw 还会保持安装方式与之对齐:
- `dev` → 确保存在 git 检出(默认:`~/openclaw`,可用 `OPENCLAW_GIT_DIR` 覆盖),
更新该检出,并从该检出安装全局 CLI。
- `dev` → 确保存在一个 git 检出副本(默认:`~/openclaw`,可通过 `OPENCLAW_GIT_DIR` 覆盖),更新它,并从该检出副本安装全局 CLI。
- `stable` → 使用 `latest` 从 npm 安装。
- `beta` → 优先使用 npm dist-tag `beta`,但当 beta 不存在
或比当前 stable 版本更旧时,会回退到 `latest`
- `beta` → 优先使用 npm 的 `beta` dist-tag但当 beta 缺失或比当前 stable 发布版本更旧时,会回退到 `latest`
Gateway 网关核心自动更新器(通过配置启用时)会复用同一更新路径。
Gateway 网关核心自动更新器(在配置中启用时)会复用这条相同的更新路径。
对于软件包管理器安装,`openclaw update` 会先解析目标软件包
版本,然后再调用软件包管理器。即使已安装版本
已经与目标一致,该命令仍会刷新全局软件包安装,
随后运行插件同步、补全刷新和重启流程。这样可以保持打包的
sidecar 和渠道拥有的插件记录与已安装的 OpenClaw
构建版本一致。
对于软件包管理器安装,`openclaw update` 会在调用软件包管理器之前解析目标软件包版本。即使已安装版本已经与目标一致,该命令仍会刷新全局软件包安装,然后执行插件同步、核心命令补全刷新以及重启相关工作。这样可以让打包的 sidecar 和渠道所拥有的插件记录与已安装的 OpenClaw 构建保持一致,同时将完整的插件命令补全重建留给显式的 `openclaw completion --write-state` 运行来完成。
## Git 检出流程
## git 检出副本流程
### 渠道选择
- `stable`:检出最新的非 beta 标签,然后执行构建和 doctor。
- `beta`:优先使用最新的 `-beta` 标签,但当 beta 不存在或更旧时回退到最新 stable 标签。
- `dev`:检出 `main`,然后执行 fetch 和 rebase。
- `stable`:检出最新的非 beta 标签,然后构建并运行 doctor。
- `beta`:优先选择最新的 `-beta` 标签,但如果 beta 缺失或更旧,则回退到最新的 stable 标签。
- `dev`:检出 `main`,然后获取并 rebase。
### 更新步骤
@ -117,44 +106,44 @@ sidecar 和渠道拥有的插件记录与已安装的 OpenClaw
仅适用于 dev。
</Step>
<Step title="预检构建(仅 dev">
在临时 worktree 中运行 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">
构建 Gateway 网关和 Control UI。
构建网关和 Control UI。
</Step>
<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 检出中会先提供运行 update 的选项)
- [开发渠道](/zh-CN/install/development-channels)
- [更新](/zh-CN/install/updating)
- [CLI 参考](/zh-CN/cli)
- `openclaw doctor`(在 git 检出副本上会先提供运行更新的选项)
- [Development channels](/zh-CN/install/development-channels)
- [Updating](/zh-CN/install/updating)
- [CLI reference](/zh-CN/cli)