阿里云国际代理商：轻量应用服务器最佳实践-升级OpenClaw版本的数据备份与恢复

步骤一：备份工作区数据

将工作区目录打包并下载到本地保存。

1. 在轻量应用服务器控制台，选择对应服务器单击远程连接，在Workbench一键连接区域，单击立即登录。

2. 打包工作区数据。

   cd /home/admin
   tar -zcvf workspace.tar.gz -C /home/admin/.openclaw/ workspace

3. 参考通过Workbench下载文件，将压缩包下载到本地。

   Workbench限制下载的单个文件小于1200M，如果压缩包超过1200M可以参考通过scp/rsync/sftp向Linux实例传输文件。

步骤二：重置系统升级镜像版本

1. 在轻量应用服务器控制台，在对应服务器选择更多操作 > 重置系统

2. 选择重置为其他镜像中最新版本的OpenClaw镜像，单击确定重置。

3. 重置完成后，按部署OpenClaw应用镜像中的步骤二重新配置。

步骤三：恢复备份数据

将备份数据上传到重置后的实例并恢复到工作区目录。

1. 参考通过Workbench上传文件，上传备份文件到实例的/home/admin目录下。

   Workbench限制上传的单个文件小于1200M，如果压缩包超过1200M可以参考通过scp/rsync/sftp向Linux实例传输文件。

2. 远程连接到实例，解压并恢复工作区数据。

   cd  /home/admin
   tar -xzvf workspace.tar.gz
   mv /home/admin/.openclaw/workspace /home/admin/.openclaw/workspace.bak # 将旧的 workspace 目录重命名进行备份，以防更新失败后可以恢复。
   mv workspace /home/admin/.openclaw/ # 将新解压的 workspace 目录移动到程序指定位置，以完成备份恢复。

3. 重启网关使数据生效。

   openclaw gateway restart

4. 打开WebUI，输入/new命令后，向AI助理确认记忆和身份配置已恢复。

   方案二：快照回滚升级

   升级前先创建实例快照作为恢复点，升级 OpenClaw 软件后若出现问题，可通过快照回滚到升级前的完整状态。

   步骤一：创建快照

   在升级前为实例创建快照，作为回滚恢复点。

   1. 在轻量应用服务器控制台，找到目标服务器，选择快照 > 创建快照。

   2. 设置快照名称（如openclaw-pre-upgrade），单击创建，等待快照创建完成。

   步骤二：升级 OpenClaw 软件

   1. 远程连接到实例，在Workbench 一键连接区域，单击立即登录。

   2. 在终端中执行以下命令，查看当前版本并升级 OpenClaw：

      openclaw --version
      sudo openclaw update

   3. 在终端执行以下命令重启网关。

      openclaw gateway restart

   4. 验证升级是否成功。

      openclaw --version

   重要

   使用 openclaw update 升级后，控制台可能出现以下已知问题：

   • 网关显示离线：控制台的「重启」按钮虽显示执行成功，但实际不生效。请在终端执行 openclaw gateway restart 重启网关。

   • 「获取地址」按钮置灰：该按钮依赖网关在线状态。您可以在终端执行 sh /opt/.swas/run-cmd.sh get-url 获取 WebUI 访问地址，然后在浏览器中打开。

   详细说明请参见使用 openclaw update 升级后，控制台网关显示离线怎么办？

   步骤三：回滚快照（可选）

   如果升级后 OpenClaw 运行异常，通过快照回滚到升级前状态。

   仅在升级出现问题时执行此步骤。如果升级成功且运行正常，无需执行回滚操作。

   1. 在轻量应用服务器控制台，进入快照页面。

   2. 找到升级前创建的快照，单击回滚，确认回滚操作。

   3. 回滚完成后，单击开机，并验证 OpenClaw 运行状态。

仅恢复配置文件

轻量应用服务器的快照不支持直接挂载或恢复单个文件。如果您仅需从旧系统快照中恢复特定配置文件（而非完整回滚），可使用快照创建临时实例，从中提取所需文件后传输到当前实例。

1. 在轻量应用服务器控制台，进入目标快照所在服务器的快照页面，选择目标快照，单击创建服务器创建一个临时实例。

2. 待临时实例创建完成后，在临时实例详情页单击远程连接，在Workbench一键连接区域，单击立即登录。

3. 找到需要恢复的配置文件，例如：

   ls /home/admin/.openclaw/workspace/
   ls /home/admin/.openclaw/openclaw.json

4. 参考通过Workbench下载文件，将配置文件下载到本地。

5. 在当前新系统实例中，参考通过Workbench上传文件，将配置文件上传到对应目录。

6. 确认文件路径和权限正确后，重启网关使配置生效。

   openclaw gateway restart

7. 完成后及时退订临时实例，避免额外费用。

常见问题