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

升級路線概覽

升級 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 服務。

步驟一：備份工作區資料

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

在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 軟體後若出現問題，可通過快照復原到升級前的完整狀態。

步驟一：建立快照

在升級前為執行個體建立快照，作為復原復原點。

在Simple Application Server控制台，找到目標伺服器，選擇快照 > 建立快照。
設定快照名稱（如openclaw-pre-upgrade），單擊建立，等待快照建立完成。

步驟二：升級 OpenClaw 軟體

遠端連線到執行個體，在Workbench 一鍵串連地區，單擊立即登入。
在終端中執行以下命令，查看目前的版本並升級 OpenClaw：
```
openclaw --version
sudo openclaw update
```
在終端執行以下命令重啟網關。
```
openclaw gateway restart
```
驗證升級是否成功。
```
openclaw --version
```

重要

使用 openclaw update 升級後，控制台可能出現以下已知問題：

網關顯示離線：控制台的「重啟」按鈕雖顯示執行成功，但實際不生效。請在終端執行 openclaw gateway restart 重啟網關。
「擷取地址」按鈕置灰：該按鈕依賴網關線上狀態。您可以在終端執行 sh /opt/.swas/run-cmd.sh get-url 擷取 WebUI 訪問地址，然後在瀏覽器中開啟。

詳細說明請參見使用 openclaw update 升級後，控制台網關顯示離線怎麼辦？

步驟三：復原快照（可選）

如果升級後 OpenClaw 運行異常，通過快照復原到升級前狀態。

僅在升級出現問題時執行此步驟。如果升級成功且運行正常，無需執行復原操作。

在Simple Application Server控制台，進入快照頁面。
找到升級前建立的快照，單擊復原，確認復原操作。
復原完成後，單擊開機，並驗證 OpenClaw 運行狀態。

僅恢複設定檔

Simple Application Server的快照不支援直接掛載或恢複單個檔案。如果您僅需從舊系統快照中恢複特定設定檔（而非完整復原），可使用快照建立臨時執行個體，從中提取所需檔案後傳輸到當前執行個體。

在Simple Application Server控制台，進入目標快照所在伺服器的快照頁面，選擇目標快照，單擊創建伺服器建立一個臨時執行個體。
待臨時執行個體建立完成後，在臨時執行個體詳情頁單擊遠程連接，在Workbench一鍵串連地區，單擊立即登入。

找到需要恢複的設定檔，例如：

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

參考通過Workbench下載檔案，將設定檔下載到本地。
在當前新系統執行個體中，參考通過Workbench上傳檔案，將設定檔上傳到對應目錄。
確認檔案路徑和許可權正確後，重啟網關使配置生效。
```
openclaw gateway restart
```
完成後及時退訂臨時執行個體，避免額外費用。

常見問題

如何關閉網關？

在終端執行openclaw gateway stop或者在WebUI介面輸入關閉網關。

為什麼使用`openclaw update`升級後，控制台鏡像仍顯示舊版本？

使用openclaw update成功升級軟體版本後，Simple Application Server控制台的鏡像資訊仍可能顯示低版本，這是正常現象。控制台顯示的是建立執行個體時所用的鏡像版本，不會影響實際的 OpenClaw 版本。以終端執行openclaw --version的輸出為準。

使用`openclaw update`升級後，控制台網關顯示離線怎麼辦？

使用 openclaw update 升級後，由於雲助手下發的指令碼與新版本不相容，控制台可能出現以下問題：

網關顯示離線：實際網關服務在伺服器上運行正常，但控制台狀態顯示為離線。
「重啟」按鈕不生效：控制台的「重啟」按鈕雖顯示執行成功，但實際未生效。
「擷取地址」按鈕置灰：該按鈕依賴網關線上狀態，網關顯示離線時無法點擊。

解決方案：

如需重啟網關，請在終端執行：
```
openclaw gateway restart
```
如需訪問 WebUI 面板，可在終端執行以下命令擷取訪問地址：
```
sh /opt/.swas/run-cmd.sh get-url
```
複製命令輸出的地址在瀏覽器中開啟即可訪問 WebUI。