メインコンテンツへスキップ

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

このガイドでは、オンボーディングをやり直さずにOpenClaw gatewayを新しいマシンへ移行します。

​
何が移行されるか

state directory（デフォルトでは ~/.openclaw/）とworkspace をコピーすると、次のものが保持されます:
  • 設定 — openclaw.json とすべてのgateway設定
  • 認証 — agentごとの auth-profiles.json（APIキー + OAuth）、および credentials/ 配下のチャネル/プロバイダー状態
  • セッション — 会話履歴とagent状態
  • チャネル状態 — WhatsAppログイン、Telegramセッションなど
  • ワークスペースファイル — MEMORY.md、USER.md、Skills、およびプロンプト
古いマシンで openclaw status を実行して、state directoryのパスを確認してください。 カスタムprofileでは ~/.openclaw-<profile>/ または OPENCLAW_STATE_DIR で設定したパスを使用します。

​
移行手順

1

gatewayを停止してバックアップする

古いマシンで、コピー中にファイルが変化しないようgatewayを停止し、その後アーカイブします:
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
複数のprofile（例: ~/.openclaw-work）を使っている場合は、それぞれを個別にアーカイブしてください。
2

新しいマシンにOpenClawをインストールする

新しいマシンでCLI（必要ならNodeも）をインストールしてください。 オンボーディングによって新しい ~/.openclaw/ が作成されても問題ありません。次の手順で上書きします。
3

state directoryとworkspaceをコピーする

scp、rsync -a、または外部ドライブでアーカイブを転送し、その後展開します:
cd ~
tar -xzf openclaw-state.tgz
隠しディレクトリが含まれていること、およびファイル所有権がgatewayを実行するユーザーと一致していることを確認してください。
4

doctorを実行して確認する

新しいマシンで Doctor を実行し、設定移行の適用とサービス修復を行います:
openclaw doctor
openclaw gateway restart
openclaw status

​
よくある落とし穴

古いgatewayが --profile または OPENCLAW_STATE_DIR を使っていて、新しい環境で使っていない場合、 チャネルはログアウト状態に見え、セッションは空になります。 移行した同じprofileまたはstate-dirでgatewayを起動し、その後で openclaw doctor を再実行してください。
設定ファイルだけでは不十分です。モデル認証プロファイルは agents/<agentId>/agent/auth-profiles.json 配下にあり、チャネル/プロバイダー状態は依然として credentials/ 配下にあります。必ずstate directory 全体を移行してください。
rootとしてコピーした、またはユーザーを切り替えた場合、gatewayが認証情報を読めないことがあります。 state directoryとworkspaceがgatewayを実行するユーザーによって所有されていることを確認してください。
UIがリモートgatewayを指している場合、セッションとworkspaceを所有しているのはリモートホストです。 ローカルノートPCではなく、gatewayホスト自体を移行してください。FAQ を参照してください。
state directoryには認証プロファイル、チャネル認証情報、そのほかの プロバイダー状態が含まれます。 バックアップは暗号化して保存し、安全でない転送経路は避け、漏えいの疑いがある場合はキーをローテーションしてください。

​
確認チェックリスト

新しいマシンで次を確認してください:
  • openclaw status でgatewayが動作中と表示される
  • チャネルが引き続き接続されている（再ペアリング不要）
  • ダッシュボードが開き、既存セッションが表示される
  • ワークスペースファイル（メモリ、設定）が存在する