Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw update
安全更新 OpenClaw，并在 stable/beta/dev 渠道之间切换。
如果你是通过 npm/pnpm/bun 安装的（全局安装，没有 git 元数据），更新会通过 更新 中的包管理器流程进行。
用法
选项
--no-restart：成功更新后跳过重启 Gateway 网关服务。会重启 Gateway 网关的包管理器更新会先验证重启后的服务报告预期的已更新版本，然后命令才会成功。--channel <stable|beta|dev>：设置更新渠道（git + npm；持久化到配置中）。--tag <dist-tag|version|spec>：仅为本次更新覆盖包目标。对于包安装，main映射到github:openclaw/openclaw#main。--dry-run：预览计划的更新操作（渠道/标签/目标/重启流程），不写入配置、不安装、不同步插件，也不重启。--json：打印机器可读的UpdateRunResultJSON，包括在更新后插件同步期间检测到 npm 插件构件漂移时的postUpdate.plugins.integrityDrifts。--timeout <seconds>：每个步骤的超时时间（默认是 1800 秒）。--yes：跳过确认提示（例如降级确认）。
openclaw update 没有 --verbose 标志。使用 --dry-run 预览计划的渠道/标签/安装/重启操作，使用 --json 获取机器可读结果；当你只需要渠道和可用性详情时，使用 openclaw update status --json。如果你在调试更新期间的 Gateway 网关日志，控制台详细程度和文件日志级别是分开的：Gateway 网关 --verbose 会影响终端/WebSocket 输出，而文件日志需要在配置中设置 logging.level: "debug" 或 "trace"。参见 Gateway 网关日志。
update status
显示当前更新渠道 + git 标签/分支/SHA（针对源码检出），以及更新可用性。
--json：打印机器可读的状态 JSON。--timeout <seconds>：检查超时时间（默认是 3 秒）。
update wizard
用于选择更新渠道并确认更新后是否重启 Gateway 网关的交互式流程（默认会重启）。如果你在没有 git 检出的情况下选择 dev，它会提示创建一个检出。
选项：
--timeout <seconds>：每个更新步骤的超时时间（默认1800）
它会做什么
当你显式切换渠道（--channel ...）时，OpenClaw 也会保持安装方式一致：
dev→ 确保存在 git 检出（默认：~/openclaw，可用OPENCLAW_GIT_DIR覆盖），更新它，并从该检出安装全局 CLI。stable→ 使用latest从 npm 安装。beta→ 优先使用 npm dist-tagbeta，但当 beta 缺失或比当前稳定版本更旧时，会回退到latest。
update.run 包管理器更新会在包替换后强制执行一次非延迟、无冷却的更新重启，因为旧 Gateway 网关进程内存中可能仍有指向新包已移除文件的分块。
对于包管理器安装，openclaw update 会在调用包管理器之前解析目标包版本。npm 全局安装使用分阶段安装：OpenClaw 会把新包安装到临时 npm 前缀中，在那里验证打包的 dist 清单，然后将这个干净的包树替换到真正的全局前缀中。如果验证失败，更新后 Doctor、插件同步和重启工作都不会从可疑的包树运行。即使已安装版本已经匹配目标版本，该命令也会刷新全局包安装，然后运行插件同步、核心命令补全刷新以及重启工作。这会让打包的 sidecar 和渠道拥有的插件记录与已安装的 OpenClaw 构建保持一致，同时把完整插件命令补全重建留给显式的 openclaw completion --write-state 运行。
当本地托管的 Gateway 网关服务已安装且启用重启时，包管理器更新会先停止正在运行的服务，然后替换包树，再从更新后的安装刷新服务元数据，重启服务，并在报告成功前验证重启后的 Gateway 网关报告预期版本。在 macOS 上，更新后检查还会验证活动配置文件的 LaunchAgent 已加载/正在运行，并且配置的 loopback 端口健康。如果 plist 已安装但 launchd 没有监管它，OpenClaw 会自动重新 bootstrap LaunchAgent，然后重新运行健康/版本/渠道就绪检查。全新 bootstrap 会直接加载 RunAtLoad 作业，因此更新恢复不会立即对新生成的 Gateway 网关执行 kickstart -k。如果 Gateway 网关仍未变为健康，命令会以非零状态退出，并打印重启日志路径以及明确的重启、重装和包回滚说明。使用 --no-restart 时，包替换仍会运行，但托管服务不会被停止或重启，因此正在运行的 Gateway 网关可能会继续使用旧代码，直到你手动重启它。
Git 检出流程
渠道选择
stable：检出最新的非 beta 标签，然后构建并运行 Doctor。beta：优先使用最新的-beta标签，但当 beta 缺失或更旧时，回退到最新稳定标签。dev：检出main，然后 fetch 并 rebase。
更新步骤
安装依赖
使用仓库包管理器。对于 pnpm 检出，更新器会按需 bootstrap
pnpm（先通过 corepack，然后回退到临时 npm install pnpm@10），而不是在 pnpm 工作区内运行 npm run build。@beta 版本。如果插件没有 beta 版本，OpenClaw 会回退到记录的默认/latest spec。对于 npm 插件，当 beta 包存在但安装验证失败时，OpenClaw 也会回退。精确版本和显式标签不会被重写。
更新后插件同步失败会使更新结果失败，并停止后续重启工作。修复插件安装或更新错误，然后重新运行
openclaw update。更新后的 Gateway 网关启动时，插件加载仅做验证：启动不会运行包管理器，也不会修改依赖树。包管理器 update.run 重启会在包树已替换后绕过正常的空闲延迟和重启冷却，因此旧进程不能继续惰性加载已移除的分块。如果 pnpm bootstrap 仍然失败，更新器会提前停止并给出包管理器特定错误，而不是尝试在检出内运行 npm run build。--update 简写
openclaw --update 会重写为 openclaw update（对 shell 和启动器脚本有用）。