升级OpenClaw应用镜像版本时，通过备份和恢复工作区数据，保留AI助理的记忆、身份配置和Skills等个性化数据。-轻量应用服务器(SAS)-阿里云帮助中心

对已部署OpenClaw应用镜像的轻量应用服务器，可通过本地备份恢复或快照回滚两种方式升级OpenClaw版本，同时保留应用的工作区数据（如记忆、身份配置、Skills等）。

升级路线概览

升级 OpenClaw 版本可通过以下两种路线实现：

路线	流程
方案一：本地备份恢复升级	备份到本地 → 重置系统 → 恢复备份
方案二：快照回滚升级	创建快照 → 升级软件 → 有问题则快照回滚

背景信息

OpenClaw的默认工作区目录/home/admin/.openclaw/workspace中保存了AI助理的核心个性化数据，包括：

IDENTITY.md：身份定义。
SOUL.md：价值观定义。
AGENTS.md：工作方式定义。
memory/：对话记忆与工作记录。
skills/：已安装的扩展技能。

重要

本文基于默认工作区目录/home/admin/.openclaw/workspace，如果更改了OpenClaw的默认工作空间，请按照实际的工作空间为准。
关于OpenClaw相关配置文件的路径是/home/admin/.openclaw/openclaw.json，可按需保存。

操作步骤

方案一：本地备份恢复升级

警告

重置系统会清空系统盘内的所有数据（包括配置、日志和数据库）并停止业务，操作前请务必备份重要数据。为确保备份数据完整，建议在执行备份时关闭网关并暂停 OpenClaw 服务。

步骤一：备份工作区数据

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

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

打包工作区数据。

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

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

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

在轻量应用服务器控制台，在对应服务器选择更多操作 > 重置系统
选择重置为其他镜像中最新版本的OpenClaw镜像，单击确定重置。
重置完成后，按部署OpenClaw应用镜像中的步骤二重新配置。

步骤三：恢复备份数据

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

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

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

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 目录移动到程序指定位置，以完成备份恢复。

重启网关使数据生效。
```
openclaw gateway restart
```
打开WebUI，输入/new命令后，向AI助理确认记忆和身份配置已恢复。

方案二：快照回滚升级

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

步骤一：创建快照

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

在轻量应用服务器控制台，找到目标服务器，选择快照 > 创建快照。
设置快照名称（如openclaw-pre-upgrade），单击创建，等待快照创建完成。

步骤二：升级 OpenClaw 软件

远程连接到实例，在Workbench 一键连接区域，单击立即登录。
在终端中执行以下命令，查看当前版本并升级 OpenClaw：
```
openclaw --version
sudo openclaw update
```
在终端执行以下命令重启网关。
```
openclaw gateway restart
```
验证升级是否成功。
```
openclaw --version
```

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

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

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

在轻量应用服务器控制台，进入快照页面。
找到升级前创建的快照，单击回滚，确认回滚操作。
回滚完成后，单击开机，并验证 OpenClaw 运行状态。

常见问题

如何关闭网关？

在终端执行openclaw gateway stop或者在WebUI界面输入关闭网关。

为什么使用`openclaw update`升级后，控制台镜像仍显示旧版本？

使用openclaw update成功升级软件版本后，轻量应用服务器控制台的镜像信息仍可能显示低版本，这是正常现象。控制台显示的是创建实例时所用的镜像版本，不会影响实际的 OpenClaw 版本。以终端执行openclaw --version的输出为准。