OpenClaw を新しいマシンへ移行する¶
このガイドでは、オンボーディングをやり直すことなく、OpenClaw Gateway（ゲートウェイ）を 1 台のマシンから別のマシンへ移行します。
移行の考え方はシンプルです。
- 状態ディレクトリ（
$OPENCLAW_STATE_DIR、既定:~/.openclaw/）をコピーします。ここには設定、認証、セッション、チャンネルの状態が含まれます。 - ワークスペース（既定では
~/.openclaw/workspace/）をコピーします。ここにはエージェントのファイル（メモリ、プロンプトなど）が含まれます。
ただし、プロファイル、権限、部分的なコピーに関する典型的な落とし穴があります。
開始前に（何を移行するのか）¶
1. 状態ディレクトリを特定する¶
多くのインストールでは既定値が使われます。
- 状態ディレクトリ:
~/.openclaw/
ただし、次を使用している場合は異なることがあります。
--profile <name>（多くの場合~/.openclaw-<profile>/になります）OPENCLAW_STATE_DIR=/some/path
不明な場合は、旧マシンで次を実行してください。
openclaw status
出力内の OPENCLAW_STATE_DIR / プロファイルへの言及を確認します。複数のゲートウェイを実行している場合は、各プロファイルについて繰り返してください。 複数のゲートウェイを実行する場合は、プロファイルごとに繰り返します。
2. ワークスペースを特定する¶
一般的な既定値は次のとおりです。
~/.openclaw/workspace/（推奨ワークスペース）- 自分で作成したカスタムフォルダー
ワークスペースには、MEMORY.md、USER.md、memory/*.md などのファイルがあります。
3. 保持される内容を理解する¶
状態ディレクトリとワークスペースの両方をコピーした場合、次が保持されます。
- Gateway の設定（
openclaw.json） - 認証プロファイル／API キー／OAuth トークン
- セッション履歴＋エージェントの状態
- チャンネルの状態（例: WhatsApp のログイン／セッション）
- ワークスペースのファイル（メモリ、Skills のメモなど）
ワークスペースのみ（例: Git 経由）をコピーした場合、次は保持されません。
- セッション
- 資格情報
- チャンネルのログイン
これらは $OPENCLAW_STATE_DIR 配下に保存されています。
移行手順（推奨）¶
ステップ 0 — バックアップを作成する（旧マシン）¶
旧マシンで、コピー中にファイルが変更されないよう、まずゲートウェイを停止します。
openclaw gateway stop
（任意ですが推奨）状態ディレクトリとワークスペースをアーカイブします。
# Adjust paths if you use a profile or custom locations
cd ~
tar -czf openclaw-state.tgz .openclaw
tar -czf openclaw-workspace.tgz .openclaw/workspace
複数のプロファイル／状態ディレクトリ（例: ~/.openclaw-main、~/.openclaw-work）がある場合は、それぞれをアーカイブしてください。
ステップ 1 — 新しいマシンに OpenClaw をインストールする¶
新マシンで CLI（必要に応じて Node）をインストールします。
- 参照: Install
この段階でオンボーディングにより新しい ~/.openclaw/ が作成されても問題ありません。次のステップで上書きします。
ステップ 2 — 状態ディレクトリ＋ワークスペースを新しいマシンへコピーする¶
次の両方をコピーします。
$OPENCLAW_STATE_DIR（既定:~/.openclaw/）- ワークスペース（既定:
~/.openclaw/workspace/）
一般的な方法は次のとおりです。
scpthe tarball and extractrsync -aを使用して SSH 経由で転送- 外付けドライブ
コピー後、次を確認してください。
- 隠しディレクトリが含まれていること（例:
.openclaw/） - ゲートウェイを実行するユーザーに対してファイル所有権が正しいこと
ステップ 3 — Doctor を実行する（移行＋サービス修復）¶
新マシンで次を実行します。
openclaw doctor
医師は「安全な退屈」コマンドです。 それはサービスを修復し、設定の移行を適用し、不一致について警告します。
その後、次を実行します。
openclaw gateway restart
openclaw status
一般的なフットガン（および回避方法）¶
落とし穴: プロファイル／状態ディレクトリの不一致¶
旧ゲートウェイをプロファイル（または OPENCLAW_STATE_DIR）付きで実行しており、新ゲートウェイが別のものを使用している場合、次のような症状が出ます。
- 設定変更が反映されない
- チャンネルが消える／ログアウトされる
- セッション履歴が空になる
対処: 移行した同じプロファイル／状態ディレクトリを使用してゲートウェイ／サービスを実行し、次を再実行します。
openclaw doctor
落とし穴: openclaw.json だけをコピーしている¶
openclaw.json だけでは不十分です。多くのプロバイダーは次の配下に状態を保存します。 多くのプロバイダーは以下の条件でストアします:
$OPENCLAW_STATE_DIR/credentials/$OPENCLAW_STATE_DIR/agents/<agentId>/...
必ず $OPENCLAW_STATE_DIR フォルダー全体を移行してください。
落とし穴: 権限／所有権¶
root でコピーした、またはユーザーを変更した場合、ゲートウェイが資格情報／セッションを読み取れないことがあります。
対処: 状態ディレクトリとワークスペースが、ゲートウェイを実行するユーザーの所有になっていることを確認します。
落とし穴: リモート／ローカルモード間の移行¶
- UI（WebUI/TUI）がリモートのゲートウェイを指している場合、セッションストアとワークスペースはリモートホストが所有します。
- ノートパソコンを移行しても、リモートゲートウェイの状態は移行されません。
リモートモードの場合は、Gateway ホストを移行してください。
落とし穴: バックアップ内のシークレット¶
$OPENCLAW_STATE_DIR にはシークレット（API キー、OAuth トークン、WhatsApp の認証情報）が含まれます。バックアップは本番シークレットと同様に扱ってください。 バックアップを本番用の秘密情報のように扱う:
- 暗号化して保管する
- 安全でないチャンネルで共有しない
- 漏えいの可能性がある場合はキーをローテーションする
検証チェックリスト¶
新しいマシンで次を確認してください。
openclaw statusでゲートウェイが稼働している- チャンネルが引き続き接続されている（例: WhatsApp が再ペアリングを要求しない）
- ダッシュボードが開き、既存のセッションが表示される
- ワークスペースのファイル（メモリ、設定）が存在する