在 Windows 系统下升级 OpenClaw，推荐采用以下标准流程，以确保升级过程稳定可靠。

🚀 升级操作步骤

1. 备份重要数据
   在进行任何升级操作前，强烈建议先备份你的配置和数据，以防万一。

   • 你的配置文件通常位于 C:\Users\<你的用户名>\.openclaw 目录下。
   • 你可以直接复制整个 .openclaw 文件夹到一个安全的位置作为备份。

2. 检查当前状态
   打开命令行工具（如 PowerShell 或 CMD），输入以下命令查看当前版本和运行状态：

   1openclaw --version
   2openclaw gateway status

3. 停止网关服务
   升级前必须先停止 OpenClaw 的网关服务，否则可能会因为文件被占用而导致升级失败（出现 EBUSY 或 EPERM 错误）。

4. 执行升级
   推荐使用以下两种方法之一进行升级：

   • 方法一：使用内置更新命令（推荐）
     这是最简单、最安全的方式，它会自动处理更新流程。

     升级完成后，该命令通常会自动重启网关服务。

   • 方法二：使用 npm 命令更新
     如果内置命令遇到问题，可以直接使用 npm 进行更新。

     1npm install -g openclaw@latest

5. 验证升级结果
   升级完成后，再次检查版本号和服务状态，确认升级是否成功。

   1openclaw --version
   2openclaw gateway status

💡 补充建议与常见问题

• 升级前运行健康检查
  官方建议在升级前运行 openclaw doctor 命令，它可以检查当前环境的健康状况并给出修复建议，使升级过程更安全。

• 处理升级失败
  如果在升级过程中遇到 EBUSY 或 EPERM 错误，请确保已执行第3步（停止网关服务）。如果问题依旧，可以尝试重启电脑后再进行升级。

• 版本回滚
  如果升级后遇到问题，可以使用以下命令回退到指定的旧版本。请将 2026.3.7 替换为你之前记录的稳定版本号。

  1npm install -g openclaw@2026.3.7