update
openclaw update
Section titled “openclaw update”安全地更新 OpenClaw 并在 stable/beta/dev 频道之间切换。
如果你是通过 npm/pnpm 安装的（全局安装，没有 git 元数据），更新将通过包管理器流程进行，详见 更新。
openclaw updateopenclaw update statusopenclaw update wizardopenclaw update --channel betaopenclaw update --channel devopenclaw update --tag betaopenclaw update --no-restartopenclaw update --jsonopenclaw --update--no-restart：在成功更新后跳过重启网关服务。--channel <stable|beta|dev>：设置更新频道（git + npm；持久化在配置中）。--tag <dist-tag|version>：仅为此次更新覆盖 npm dist-tag 或版本。--json：打印机器可读的UpdateRunResultJSON。--timeout <seconds>：每步超时（默认为 1200秒）。
注意：降级需要确认，因为旧版本可能会破坏配置。
update status
Section titled “update status”显示活动的更新频道 + git tag/branch/SHA（对于源代码检出），以及更新可用性。
openclaw update statusopenclaw update status --jsonopenclaw update status --timeout 10选项：
--json：打印机器可读的状态 JSON。--timeout <seconds>：检查超时（默认为 3秒）。
update wizard
Section titled “update wizard”交互式流程，用于选择更新频道并确认更新后是否重启网关（默认为重启）。如果你选择 dev 但没有 git 检出，它会提供创建一个。
当你显式切换频道（--channel ...）时，OpenClaw 也会保持安装方法一致：
dev→ 确保 git 检出（默认：~/openclaw，可用OPENCLAW_GIT_DIR覆盖），更新它，并从该检出安装全局 CLI。stable/beta→ 使用匹配的 dist-tag 从 npm 安装。
Git 检出流程
Section titled “Git 检出流程”频道：
stable：检出最新的非 beta 标签，然后 build + doctor。beta：检出最新的-beta标签，然后 build + doctor。dev：检出main，然后 fetch + rebase。
高层级流程：
- 需要干净的工作树（没有未提交的更改）。
- 切换到选定的频道（标签或分支）。
- 获取上游（仅限 dev）。
- 仅限 dev：在临时工作树中进行预检 lint + TypeScript 构建；如果 tip 失败，则最多回溯 10 个提交以找到最新的干净构建。
- 变基到选定的提交（仅限 dev）。
- 安装依赖（首选 pnpm；npm 回退）。
- 构建 + 构建控制 UI。
- 运行
openclaw doctor作为最终的“安全更新”检查。 - 将插件同步到活动频道（dev 使用捆绑的扩展；stable/beta 使用 npm）并更新 npm 安装的插件。
--update 简写
Section titled “--update 简写”openclaw --update 重写为 openclaw update（对于 shell 和启动器脚本很有用）。