本文概览
适用于通过 npm 或 git 安装 OpenClaw 的用户，介绍两种升级方式、升级后检查与重启步骤，以及回滚方法。关键步骤包括：
- 使用
openclaw update 进行快速升级 - 若升级失败，使用官方安装脚本重新安装
- 完成后运行
openclaw doctor、重启网关并验证健康状态 - 需要时回滚到指定版本
推荐
最快的更新方式。它会检测你的安装类型（npm 或 git）、获取最新版本、运行 openclaw doctor，并重启 Gateway 网关。
1
2
3
4
5
6
7
8
9
| # 推荐升级方式
# 检测安装类型、拉取最新版本、执行健康检测并重启网关
openclaw update
# 指定更新渠道或标签
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag main
openclaw update --dry-run # 预览而不实际应用
|
替代方式
通过重新运行安装脚本完成升级或恢复。
1
2
| # 基本安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash
|
- 添加
--no-onboard 可跳过新手引导。 - 强制指定安装类型：
1
2
| curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --no-onboard
|
1
| curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>
|
若 openclaw update 在 npm 软件包安装阶段后失败，重新运行上述安装器即可。安装器不会调用旧的更新器，而是直接执行全局软件包安装，能够恢复部分更新的 npm 安装。
更新后
执行健康检查、重启网关并验证系统状态。
1
2
3
4
5
6
7
8
9
| # 运行 Doctor
openclaw doctor
openclaw doctor --fix
# 重启 Gateway
openclaw gateway restart
# 验证健康状态
openclaw health
|
回滚
固定到特定版本（npm）时使用以下命令：
1
2
3
| npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart
|
官方手册
