OpenClaw源码安装的升级与回滚策略

升级前准备确保可回滚1. 备份当前安装# 找到您的源码安装位置# 如果是在默认位置通常是 ~/.openclaw 或全局node_modules中的某个位置# 创建完整备份cp-r~/.openclaw ~/.openclaw-backup-$(date%Y%m%d_%H%M%S)# 或者如果是本地克隆的仓库cd/path/to/openclaw/sourcegitstatus# 查看当前状态gitbranch backup-pre-upgrade-$(date%Y%m%d)2. 记录当前版本# 记录当前的commit hash和版本信息cd/path/to/openclaw/sourcegitlog--oneline-1# 显示当前commitopenclaw--version# 记录当前版本升级策略方案一Git源码升级推荐如果您是从GitHub克隆的源码# 1. 进入源码目录cd/path/to/openclaw/source# 2. 确保所有更改都已提交或暂存gitstatus# 如有未提交更改可暂存或提交它们# 3. 获取最新代码gitfetch origingitcheckout main# 或者您当前使用的分支gitpull origin main# 4. 安装依赖pnpminstall# 或 npm install# 5. 重新构建pnpmbuild# 或 npm run build# 6. 重新安装到全局pnpminstall-g.# 或 npm install -g .方案二全新克隆更安全# 1. 备份当前源码目录mv/path/to/current/openclaw /path/to/current/openclaw-old# 2. 克隆最新版本gitclone https://github.com/openclaw/openclaw.git /path/to/new/openclaw# 3. 进入目录并安装cd/path/to/new/openclawpnpminstallpnpmbuildpnpminstall-g.# 4. 迁移配置文件cp-r~/.openclaw-backup/* ~/.openclaw/回滚策略如果升级失败立即回滚# 方法1如果是git方式升级使用git回滚cd/path/to/openclaw/sourcegitcheckoutupgrade-before-commit-hashpnpminstallpnpmbuildpnpminstall-g.# 方法2恢复备份的源码目录rm-rf/path/to/openclaw/sourcecp-r/path/to/openclaw/backup /path/to/openclaw/sourcecd/path/to/openclaw/sourcepnpminstallpnpmbuildpnpminstall-g.# 方法3重新安装特定版本npminstall-gopenclawprevious-version-number最佳实践步骤1. 准备阶段# 创建工作目录mkdir-p~/openclaw-upgrade-backupcd~/openclaw-upgrade-backup# 记录当前状态openclaw--versioncurrent_version.txtnpmlist-gopenclawcurrent_packages.txt21# 备份配置cp-r~/.openclaw ./openclaw_config_backup_$(date%Y%m%d_%H%M%S)2. 测试环境验证# 在临时目录测试新版本mkdir-p~/temp-openclaw-testcd~/temp-openclaw-test# 克隆最新代码gitclone https://github.com/openclaw/openclaw.git.pnpminstallpnpmbuild# 测试基本功能npx openclaw--versionnpx openclaw gateway--help3. 正式升级# 进入原源码目录cd/path/to/original/openclaw# 拉取最新代码gitfetch origingitstash savepre-upgrade-backup-$(date%Y%m%d_%H%M%S)# 保存任何本地修改gitreset--hardHEAD# 清理任何本地更改gitmerge origin/main# 合并最新代码# 更新依赖和重新构建pnpminstallpnpmbuildpnpminstall-g.4. 验证和监控# 验证版本openclaw--version# 检查基本功能openclaw gateway status openclaw doctor# 如果一切正常删除备份几天后确认无问题再删除应急回滚脚本创建一个应急回滚脚本以便快速恢复#!/bin/bash# rollback-openclaw.shechoStarting OpenClaw rollback...# 如果有备份源码恢复它if[-d/path/to/openclaw/backup];thenechoRestoring from source backup...cd/path/to/openclaw/backuppnpminstallpnpmbuildpnpminstall-g.else# 尝试从npm安装之前的版本PREVIOUS_VERSION$(cat~/openclaw-upgrade-backup/current_version.txt)echoInstalling previous version:$PREVIOUS_VERSIONnpminstall-gopenclaw$PREVIOUS_VERSIONfiechoRollback completed. Please verify functionality.注意事项保留备份在确认新版本稳定运行至少24小时后再删除备份配置兼容性新版本可能需要更新配置文件格式请检查CHANGELOG插件兼容性如果有自定义插件确认它们与新版本兼容逐步验证升级后逐步验证各项功能而非一次性投入生产使用