自游人
自游人

OpenClaw升级方法与回滚教程

辉哥 收录于 知识库图书馆
  约 600 字 预计阅读 2 分钟 

本文概览
适用于通过 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
  • 将恢复固定到特定版本或 dist‑tag：
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

官方手册

原文链接： https://www.17you.com/library/openclaw-update-npm-git/ 已复制！
知识和正确的认知铸就美好旅程

加入自游人，有空让我们一起游，打破认知的围墙！

一起 AI、一起搞钱、一起做数字游民，四海漫游。

请点击联系我

相关内容

更新于 2026-05-15 
CC BY-NC-SA 4.0
OpenClawOpenClaw大龙虾
返回 | 主页

目录