升级步骤
1. 检查当前状态和更新
openclaw status
一键获取完整项目代码
输出中会显示 Update: available,并提示可用的最新版本。
2. 停止 Gateway 服务
直接运行 openclaw update 会遇到 EBUSY 错误,因为进程正在使用中。需要先停止服务:
openclaw gateway stop
一键获取完整项目代码
这会停止 Scheduled Task: OpenClaw Gateway。
3. 使用 npm 全局更新
OpenClaw 的内置更新命令有时会因为文件锁定而失败。推荐使用 npm 手动更新:
npm update -g openclaw
一键获取完整项目代码
注意:不是 npm update -g openclaw@latest,这样会导致参数错误。正确语法是 npm update -g <package>。
4. 重新启动 Gateway
openclaw gateway restart
一键获取完整项目代码
如果重启后仍有问题,可能需要:
关闭所有占用文件的程序
重启计算机后再试
清理临时文件(在 %APPDATA%\npm\node_modules 目录下的 .openclaw-* 文件夹)
5. 验证升级
再次检查状态:
openclaw status
一键获取完整项目代码
确认版本号已更新。
常见问题
EBUSY 错误
症状: npm error code EBUSY, EPERM: operation not permitted
原因: OpenClaw 进程正在使用其核心文件,导致无法替换。
解决方法:
先执行 openclaw gateway stop
确保没有其他 OpenClaw 相关进程运行
如仍失败,考虑重启系统后再升级
遗留文件未删除
症状: npm warn cleanup Failed to remove some directories
原因: 某些 DLL/.node 文件被系统或程序锁定。
处理:
不影响使用,只是视觉上显示警告
可手动删除或等待系统释放后删除
必要时重启系统清理
回滚方法
如需回滚到之前版本:
npm install -g openclaw@2026.3.7
一键获取完整项目代码
后续建议
升级后运行一次安全检查:
openclaw security audit
一键获取完整项目代码
根据提示修复安全问题(特别是 DingTalk 配置相关的警告)。