OpenClawを新しいマシンへ移行する方法

新しいマシンを手に入れたとき、一番面倒なのが開発環境の移行作業です。ツールをインストールし直すだけでなく、これまでの設定や認証、蓄積したデータを元通りにするのは時間がかかります。特に、何度も繰り返したオンボーディングの手順をもう一度やり直すのは避けたいものです。

OpenClawなら、必要なディレクトリをコピーするだけで、これまでの設定やエージェントの状態をそのまま新しい環境へ持ち運ぶことができます。

必要なもの

移行を始める前に、現在のマシンで以下の2つを確認してください。

• State directory: 設定、認証情報、セッション、Channelの状態が含まれるディレクトリです（デフォルト：~/.openclaw/）。
• Workspace: エージェントのファイル（memory、promptsなど）が含まれるディレクトリです（デフォルト：~/.openclaw/workspace/）。

現在の設定がデフォルトと異なる場合は、古いマシンで以下のコマンドを実行して場所を確認してください。

openclaw status

クイックスタート

最短で移行を完了させるための4つのステップです。

1. バックアップの作成（古いマシン）

まず、コピー中にファイルが変更されないよう Gateway を停止します。

openclaw gateway stop

次に、ディレクトリをアーカイブします。

cd ~
tar -czf openclaw-state.tgz .openclaw
tar -czf openclaw-workspace.tgz .openclaw/workspace

2. 新しいマシンにインストール

新しいマシンで CLI をインストールします（必要に応じて Node.js も用意してください）。

• 参照: Install

この時点で新しい ~/.openclaw/ が作成されても問題ありません。次のステップで上書きします。

3. データのコピー

アーカイブしたデータを新しいマシンの同じパスへ展開します。scp や rsync、外付けドライブなどを使用してください。コピー後、以下の点を確認します。

• 隠しディレクトリ（.openclaw/）が含まれていること
• ファイルの所有権が Gateway を実行するユーザーになっていること

4. Doctor コマンドの実行

新しいマシンで以下のコマンドを実行し、環境を整えます。

openclaw doctor
openclaw gateway restart
openclaw status

openclaw doctor は、設定のマイグレーションやサービスの修復を安全に行ってくれるコマンドです。

トラブルシューティング

プロフィールやディレクトリの不一致

古い環境で --profile や OPENCLAW_STATE_DIR を指定していた場合、新しい環境でも同じ指定をする必要があります。設定が反映されない、セッションが空に見えるといった場合は、同じプロフィールを指定して openclaw doctor を再試行してください。

openclaw.json だけをコピーした

openclaw.json だけでは不十分です。API キーや OAuth トークン、エージェントの状態などは $OPENCLAW_STATE_DIR/credentials/ や $OPENCLAW_STATE_DIR/agents/ 以下に保存されています。必ずディレクトリ全体をコピーしてください。

権限と所有権の問題

root ユーザーでコピーを行ったり、ユーザー名を変更したりすると、Gateway が認証情報やセッションを読み込めなくなることがあります。ディレクトリとファイルの所有権が正しいか確認してください。

バックアップ内のシークレット

$OPENCLAW_STATE_DIR には API キーや WhatsApp の認証情報などの機密情報が含まれています。バックアップファイルは暗号化して保存し、安全でない経路での共有は避けてください。

完了チェックリスト

新しいマシンで以下を確認できれば移行成功です。

• openclaw status で Gateway が正常に動作している
• Channel が接続されたままになっている（WhatsApp の再ペアリングが不要など）
• Dashboard に以前のセッション履歴が表示される
• Workspace 内のファイル（memory や設定）が存在する

セットアップでお困りの際は、AI Setup Assistant も活用してください。

次のステップ

• Doctor
• Gateway troubleshooting
• Where does OpenClaw store its data?