升級OpenClaw應用鏡像版本時，通過備份和恢複工作區資料，保留AI助理的記憶、身份配置和Skills等個人化資料。 - Simple Application Server

對已部署OpenClaw應用鏡像的Simple Application Server，若需通過重設系統升級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，可按需儲存。

操作步驟

步驟一：備份工作區資料

將工作區目錄打包並下載到本地儲存。

在Simple Application Server控制台，選擇對應伺服器單擊遠端連線，在Workbench一鍵串連地區，單擊立即登入。

打包工作區資料。

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

參考通過Workbench下載檔案，將壓縮包下載到本地。
Workbench限制下載的單個檔案小於1200M，如果壓縮包超過1200M可以參考通過scp/rsync/sftp向Linux執行個體傳輸檔案。

步驟二：重設系統升級鏡像版本

在Simple Application Server控制台，在對應伺服器選擇更多操作 > 重設系統
選擇重設為其他鏡像中最新版本的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介面輸入關閉網關。