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就成功回去了。
夜雨聆风