十分钟教你如何升级openclaw

升级 OpenClaw 的核心流程是：备份 → 停止服务 → 执行升级 → 检查与重启。

以下是针对不同安装方式的详细步骤，请根据您的情况选择。

🛡️ 升级前准备 (所有方式通用)

1. 备份数据 (强烈建议)

   此操作可防止升级失败或配置不兼容导致数据丢失。

   powershell

   备份整个 .openclaw 目录

   Copy-Item -Recurse "env:USERPROFILEo˙penclaw""env:USERPROFILE.openclaw.backup-$(Get-Date -Format 'yyyyMMdd')"

2. 停止网关服务

   避免在升级过程中文件被占用或导致服务异常。

   bash

   openclaw gateway stop

3. 确认当前版本

   便于后续核对是否升级成功。

   bash

   openclaw --version

🚀 方式一：使用内置命令升级 (推荐)

这是官方推荐的方式，会自动处理更新、重启及守护进程注册。

1. 执行更新

   默认升级到stable(稳定版) 渠道的最新版本。

   bash

   openclaw update

   你也可以指定渠道，例如升级到测试版：

   bash

   openclaw update --channel beta

2. 重启并验证

   update命令通常会自动重启服务，但手动操作一次更稳妥。

   bash

   openclaw gateway restart

   openclaw --version

   openclaw doctor

📦 方式二：通过 NPM 手动升级

如果你是通过npm install -g openclaw命令安装的，可以使用此方法。

1. 升级到最新版

   bash

   npm install -g openclaw@latest

2. 升级到指定版本

   你可以先查看可用版本，然后指定一个进行安装。

   bash

   查看版本列表 (取后20个)

   npm view openclaw versions --json | python -c "import sys,json;v=json.load(sys.stdin);print('\n'.join(v[-20:]))"

   安装指定版本，例如 2026.3.13-1

   npm install -g openclaw@2026.3.13-1

3. 重启并验证

   bash

   openclaw gateway restart

   openclaw --version

   openclaw doctor

🐳 方式三：Docker / 容器升级

如果你使用 Docker 运行 OpenClaw，升级镜像即可。

1. 拉取新版本镜像

   bash

   docker pull openclaw/openclaw:latest

   或指定版本

   docker pull openclaw/openclaw:2026.3.13-1

2. 停止并删除旧容器

   bash

   docker stop openclaw

   docker rm openclaw

3. 使用新镜像启动

   注意：确保-v ~/.openclaw:/root/.openclaw卷挂载参数不变，以保证数据持久化。

   bash

   docker run -d \

   --name openclaw \

   -v ~/.openclaw:/root/.openclaw \

   -p 18789:18789 \

   openclaw/openclaw:latest

4. 验证版本

   bash

   docker exec openclaw openclaw --version

🔧 升级后检查与回滚

1. 运行健康检查

   doctor命令会自动检查配置、服务状态等，并尝试修复常见问题。

   bash

   openclaw doctor

   必要时可尝试自动修复

   openclaw doctor --fix

2. 版本回滚

   如果新版本出现问题，可以随时回滚到之前的版本。

   • NPM 安装方式：

     bash

     openclaw gateway stop

     npm install -g openclaw@2026.3.11 # 替换为上一个稳定版本

     openclaw gateway start

   • 配置回滚：

     如果问题与配置变更有关，可以恢复之前备份的.openclaw目录。

     powershell

     先停止服务

     openclaw gateway stop

     恢复备份 (注意替换日期)

     Remove-Item -Recurse -Force "$env:USERPROFILE.openclaw"

     Copy-Item -Recurse "env:USERPROFILEo˙penclaw.backup−20260315""env:USERPROFILE.openclaw"

     重启服务

     openclaw gateway start

💡 版本选择建议

根据官方信息，截至2026年3月中旬，版本选择建议如下：

• ✅ 推荐稳定版：v2026.3.13-1(修复了v2026.3.12/13的已知问题)。

• 备选稳定版：v2026.3.11(若对新版本功能不敏感，此版本非常稳定)。