乐于分享
好东西不私藏

Openclaw的升级方法

Openclaw的升级方法

Openclaw升级首先可以在网页看官方更新日志,如下:

1. 官方发布页(中文版,含所有版本)

https://open-claw.me/zh/releases能看到:

1)所有稳定版 / 测试版列表

2)发布时间

3)版本号(如2026.4.23

2. 完整更新日志(Changelog)

https://openclaw-s.com/changelog每个版本的:

1)新功能

2)Bug 修复

3)breaking change(需注意的兼容问题)

3. GitHub 原始日志

https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md权威、最详细的提交记录。

Openclaw的标准升级方法一般可以采用CLI模式,可以全程保留配置和数据,升级后使用doctor工具可以检查错误。

方法一一键升级

openclaw的安装目录下,执行下面的命令:

# 查看当前版本

openclaw –version

会显示如下的内容OpenClaw 2026.4.25 (aa36ee6)

可以再检查一下更新状态,是否有新版本:

openclaw update status

会显示例如下面的内容:

可以一键升级了:

# 1. 停止网关(避免文件占用) 

openclaw gateway stop 

# 2. 执行升级(默认 stable 通道) 

openclaw update 

# 3. 升级后检查+修复 

openclaw doctor –fix 

# 4. 重启网关 

openclaw gateway restart 

# 5. 验证

openclaw health 

openclaw –version

方法二pnpm安装

# 全局安装指定版本(比如要升级4.25版本

pnpm add -g openclaw@2026.4.25 

# 全局卸载 

pnpm remove -g openclaw 

# 查看全局已装包 

pnpm ls -g

方法三git源码升级

# 1. 进入源码目录 

cd /path/to/openclaw 

# 2. 暂存/提交本地修改 

git status git stash # 暂存临时修改 

# 3. 拉取最新代码 

git fetch origin 

git checkout main 

git pull origin main 

# 4. 安装依赖+构建 

pnpm install pnpm build 

# 5. 全局链接 

pnpm install -g . 

# 6. 重启服务 

openclaw gateway restart

如果升级后版本有问题,需要回退版本,则执行下述命令:

# 1. 停止服务

node openclaw.mjs gateway stop 

# 2. 强制切回 2026.4.25 稳定版(最关键)

git checkout v2026.4.25

# 3. 重新安装依赖(必须)

pnpm install pnpm build 

# 4. 修复配置,不删数据 

node openclaw.mjs doctor –fix 

# 5. 重启 

node openclaw.mjs gateway restart

最后验证一下版本:

node openclaw.mjs –version

如果显示2026.4.25就成功回去了