OpenClaw アプリケーションイメージをアップグレードする際に、AI アシスタントのメモリ、ID 構成、スキルなどのパーソナライズされた情報を保持するために、ワークスペースデータをバックアップおよび復元できます。 - Simple Application Server

OpenClaw を実行中の Simple Application Server インスタンスでは、ローカルでのバックアップと復元、またはスナップショットロールバックのいずれかの方法でアプリケーションをアップグレードできます。どちらの方法でも、メモリ、ID 構成、スキルなどのアプリケーションのワークスペースデータを保持できます。

アップグレード方法の概要

以下のいずれかの方法で OpenClaw をアップグレードできます。

方法	手順
方法 1：ローカルバックアップと復元によるアップグレード	ローカルコンピューターにバックアップ → システムをリセット → バックアップから復元
方法 2：スナップショットロールバックによるアップグレード	スナップショットを作成 → ソフトウェアをアップグレード → 問題が発生した場合はスナップショットをロールバック

背景情報

デフォルトの OpenClaw ワークスペースディレクトリ /home/admin/.openclaw/workspace には、ご利用の AI アシスタントのコアとなるパーソナライズデータが保存されています。具体的には以下のとおりです。

IDENTITY.md：ID 定義
SOUL.md：価値観定義
AGENTS.md：作業スタイル定義
memory/：会話履歴および作業記録
skills/：インストール済みの拡張スキル

重要

本トピックでは、デフォルトのワークスペースディレクトリを /home/admin/.openclaw/workspace と仮定しています。デフォルトのワークスペースパスを変更している場合は、実際のパスを使用してください。
OpenClaw の設定ファイルは /home/admin/.openclaw/openclaw.json にあります。必要に応じてこのファイルもバックアップできます。

操作手順

方法 1：ローカルバックアップと復元

警告

システムをリセットすると、構成、ログ、データベースなどシステムディスク上のすべてのデータが削除され、サービスが停止します。操作を進める前に、重要なデータを必ずバックアップしてください。データ整合性を確保するため、バックアップを作成する前に、ゲートウェイを停止し、OpenClaw サービスを一時停止することを推奨します。

ステップ 1：ワークスペースデータのバックアップ

ワークスペースディレクトリをアーカイブし、ローカルコンピューターにダウンロードします。

Simple Application Server コンソールでご利用のインスタンスを見つけ、リモート接続 をクリックします。ワークベンチワンクリック接続 セクションで、今すぐログイン をクリックします。

ワークスペースデータをアーカイブします。

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

圧縮アーカイブをローカルコンピューターにダウンロードします。手順については、「ワークベンチを使用してファイルをダウンロードする」をご参照ください。
ワークベンチでは、単一ファイルのダウンロードサイズが 1,200 MB に制限されています。アーカイブファイルが 1,200 MB を超える場合は、「scp、rsync、または sftp を使用して Linux インスタンスにファイルを転送する」をご参照ください。

ステップ 2：システムをリセットしてイメージをアップグレード

Simple Application Server コンソールでご利用のインスタンスを見つけ、その他の操作 > システムのリセット を選択します。
他のイメージにリセット の下で、最新バージョンの OpenClaw イメージを選択し、リセットを確定 をクリックします。
システムのリセット後、「OpenClaw アプリケーションイメージのデプロイ」のステップ 2 に従って、インスタンスを再構成します。

ステップ 3：バックアップデータの復元

バックアップファイルをリセット後のインスタンスにアップロードし、ワークスペースディレクトリにデータを復元します。

バックアップファイルをインスタンス上の /home/admin ディレクトリにアップロードします。手順については、「ワークベンチを使用してファイルをアップロードする」をご参照ください。
ワークベンチでは、単一ファイルのアップロードサイズが 1,200 MB に制限されています。アーカイブが 1,200 MB を超える場合は、「scp/rsync/sftp を使用して Linux インスタンスにファイルを転送する」をご参照ください。

インスタンスに接続し、アーカイブを展開してワークスペースデータを復元します。

cd  /home/admin
tar -xzvf workspace.tar.gz
mv /home/admin/.openclaw/workspace /home/admin/.openclaw/workspace.bak # 復元失敗時に備えて、現在のワークスペースディレクトリをバックアップとしてリネームします。
mv workspace /home/admin/.openclaw/ # 展開されたワークスペースディレクトリをアプリケーションパスに移動して、復元を完了します。

変更を適用するためにゲートウェイを再起動します。
```
openclaw gateway restart
```
WebUI を開き、/new コマンドを実行し、AI アシスタントと対話してメモリおよび ID 構成が復元されていることを確認します。

方法 2：スナップショットロールバック

アップグレード前にインスタンスのスナップショットを作成し、リカバリポイントとして使用します。OpenClaw ソフトウェアのアップグレード後に問題が発生した場合は、スナップショットを使用してインスタンスをアップグレード前の状態にロールバックできます。

ステップ 1：スナップショットの作成

Simple Application Server コンソールでターゲットインスタンスを見つけ、スナップショット > スナップショットの作成 を選択します。
スナップショットの名前（例：openclaw-pre-upgrade）を入力し、作成をクリックします。スナップショットの作成が完了するまで待ちます。

ステップ 2：OpenClaw ソフトウェアのアップグレード

インスタンスへのリモート接続を確立します。ワークベンチワンクリック接続 セクションで、今すぐログイン をクリックします。
ターミナルで以下のコマンドを実行して現在のバージョンを確認し、OpenClaw をアップグレードします。
```
openclaw --version
sudo openclaw update
```
ターミナルで以下のコマンドを実行してゲートウェイを再起動します。
```
openclaw gateway restart
```
アップグレードが成功したことを確認します。
```
openclaw --version
```

ステップ 3：スナップショットのロールバック（オプション）

アップグレード後に OpenClaw が期待どおりに動作しない場合は、スナップショットを使用してインスタンスをアップグレード前の状態にロールバックします。

このステップは、アップグレード後に問題が発生した場合にのみ実行してください。

Simple Application Server コンソールで スナップショット ページを開きます。
アップグレード前に作成したスナップショットを見つけ、ロールバック をクリックして、ロールバック操作を確定します。
ロールバックが完了したら、開始をクリックし、OpenClaw が期待どおりに動作することを確認します。

よくある質問

ゲートウェイを停止するにはどうすればよいですか？

ターミナルで openclaw gateway stop を実行するか、WebUI で「stop the gateway」と入力します。

`openclaw update` を使用した後も、コンソールに古いイメージバージョンが表示されるのはなぜですか？

これは想定される動作です。Simple Application Server コンソールでは、openclaw update コマンドでソフトウェアをアップグレードした後でも、古いバージョンが表示される場合があります。これは、コンソールがインスタンス作成時に使用されたイメージのバージョンを表示しており、現在の OpenClaw ソフトウェアのバージョンを表示していないためです。現在のバージョンを確認するには、openclaw --version コマンドを実行してください。