升级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，可按需保存。

操作步骤

步骤一：备份工作区数据

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

在轻量应用服务器控制台，选择对应服务器单击远程连接，在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 gateway stop或者在WebUI界面输入关闭网关。