OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

移行ガイド

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

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

同梱の移行プロバイダーは、手順、MCP サーバー、Skills、モデル設定、オプトインの API キーを OpenClaw に取り込みます。変更前に計画がプレビューされ、レポートではシークレットが伏せられ、適用時には検証済みのバックアップが作成されます。

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、プロンプト。

移行手順

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

    コピー中にファイルが変更されないよう、古いマシンで Gateway を停止してからアーカイブします。

    bash
    openclaw gateway stopcd ~tar -czf openclaw-state.tgz .openclaw

    複数のプロファイル（例：~/.openclaw-work）を使用している場合は、それぞれを個別にアーカイブします。

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

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

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

    scp、rsync -a、または外部ドライブを使用してアーカイブを転送し、展開します。

    bash
    cd ~tar -xzf openclaw-state.tgz

    隠しディレクトリが含まれていること、およびファイルの所有者が Gateway を実行するユーザーと一致していることを確認します。

  • doctor を実行して確認する

    新しいマシンで Doctor を実行し、設定の移行を適用してサービスを修復します。

    bash
    openclaw doctoropenclaw gateway restartopenclaw status

    • Telegram または Discord がデフォルトの環境変数フォールバック（TELEGRAM_BOT_TOKEN または DISCORD_BOT_TOKEN）を使用している場合は、シークレット値を表示せずに、移行した状態ディレクトリの .env にこれらのキーが含まれていることを確認します。

    bash
    awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env

    openclaw doctor は、有効になっているデフォルトの Telegram または Discord アカウントにトークンが設定されておらず、対応する環境変数を doctor プロセスから利用できない場合にも警告します。

    よくある問題

    プロファイルまたは状態ディレクトリの不一致

    古い Gateway が --profile または OPENCLAW_STATE_DIR を使用していて、新しい Gateway がそれを使用していない場合、チャンネルはログアウトしているように表示され、セッションは空になります。移行したものと同じプロファイルまたは状態ディレクトリを使用して Gateway を起動し、openclaw doctor を再実行します。

    openclaw.json だけをコピーしている

    設定ファイルだけでは不十分です。モデルの認証プロファイルは agents/<agentId>/agent/auth-profiles.json に、チャンネルとプロバイダーの状態は credentials/ に保存されています。必ず状態ディレクトリ全体を移行してください。

    権限と所有権

    root としてコピーした場合やユーザーを変更した場合、Gateway が認証情報を読み取れないことがあります。状態ディレクトリとワークスペースの所有者が Gateway を実行するユーザーであることを確認してください。

    リモートモード

    UI がリモートの Gateway を参照している場合、セッションとワークスペースはリモートホストが保持しています。ローカルのノートパソコンではなく、Gateway ホスト自体を移行してください。よくある質問を参照してください。

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

    状態ディレクトリには、認証プロファイル、チャンネルの認証情報、その他のプロバイダー状態が含まれています。バックアップは暗号化して保存し、安全でない転送経路を避け、漏えいした可能性がある場合はキーをローテーションしてください。

    確認チェックリスト

    新しいマシンで次を確認します。

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

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

    Plugin のインプレースアップグレードでは、同じ Plugin ID と設定キーを保持しますが、ディスク上の状態を現在のレイアウトに移動する場合があります。Plugin 固有のアップグレードガイドは、対応するチャンネルのドキュメントにあります。

    • Matrix の移行：暗号化された状態の復旧制限、自動スナップショットの動作、手動復旧コマンド。

    関連項目

    Was this useful?
    On this page

    On this page