Skip to main content
OpenClaw は、別のエージェントシステムからのインポート、既存のインストール環境の新しいマシンへの移動、Plugin のインプレースアップグレードという 3 つの移行パスをサポートしています。

​
別のエージェントシステムからインポートする

同梱の移行プロバイダーは、指示、MCP サーバー、Skills、モデル設定、および（オプトインの）API キーを OpenClaw に取り込みます。変更を加える前にプランがプレビューされ、レポートではシークレットが秘匿されます。スタンドアロンの openclaw migrate は検証済みのバックアップによって保護されます。一方、新規オンボーディングでのインポートでは、ローカルアーティファクトをステージングして検証してから公開し、不可逆な外部アクティベーションを行う前に設定をコミットします。

Claude からの移行

CLAUDE.md、MCP サーバー、Skills、プロジェクトコマンドを含む Claude Code と Claude Desktop の状態をインポートします。

Hermes からの移行

Hermes の設定、プロバイダー、MCP サーバー、メモリ、Skills、およびサポートされている .env キーをインポートします。
CLI のエントリーポイントは openclaw migrate です。既知のソース（openclaw onboard --flow import）を検出した場合、オンボーディングでも移行を提案できます。

​
OpenClaw を新しいマシンに移動する

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

​
移行手順

1

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

古いマシンで、コピー中にファイルが変更されないように Gateway を停止してから、アーカイブを作成します。
複数のプロファイル（例: ~/.openclaw-work）を使用している場合は、それぞれを個別にアーカイブします。
2

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

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

状態ディレクトリとワークスペースをコピーする

scp、rsync -a、または外付けドライブを使用してアーカイブを転送し、展開します。
隠しディレクトリが含まれていること、およびファイルの所有者が Gateway を実行するユーザーと一致していることを確認します。
4

Doctor を実行して検証する

新しいマシンで Doctor を実行し、設定の移行とサービスの修復を行います。
Telegram または Discord がデフォルトの環境変数フォールバック（TELEGRAM_BOT_TOKEN または DISCORD_BOT_TOKEN）を使用している場合は、シークレット値を出力せずに、移行した状態ディレクトリの .env にそれらのキーが含まれていることを確認します。
有効なデフォルトの Telegram または Discord アカウントにトークンが設定されておらず、対応する環境変数を Doctor プロセスで利用できない場合、openclaw doctor も警告します。

​
よくある問題

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

​
検証チェックリスト

新しいマシンで、以下を確認します。
  • openclaw status に Gateway が実行中であると表示される。
  • チャンネルが引き続き接続されている（再ペアリングは不要）。
  • ダッシュボードが開き、既存のセッションが表示される。
  • ワークスペースファイル（メモリ、設定）が存在する。

​
Plugin をインプレースアップグレードする

Plugin のインプレースアップグレードでは、同じ Plugin ID と設定キーが維持されますが、ディスク上の状態が現在のレイアウトに移動される場合があります。Plugin 固有のアップグレードガイドは、それぞれのチャンネルとともに提供されています。
  • Matrix の移行: 暗号化された状態の復旧制限、自動スナップショットの動作、手動復旧コマンド。

​
関連項目