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 に取り込みます。変更を加える前にプランがプレビューされ、レポートではシークレットが秘匿されます。スタンドアロンの 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、プロンプト。

移行手順

  • 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

    有効なデフォルトの Telegram または Discord アカウントにトークンが設定されておらず、対応する環境変数を Doctor プロセスで利用できない場合、openclaw 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 ホスト自体を移行してください。FAQ を参照してください。

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

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

    検証チェックリスト

    新しいマシンで、以下を確認します。

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

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

    Plugin のインプレースアップグレードでは、同じ Plugin ID と設定キーが維持されますが、ディスク上の状態が現在のレイアウトに移動される場合があります。Plugin 固有のアップグレードガイドは、それぞれのチャンネルとともに提供されています。

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

    関連項目

    Was this useful?
    On this page

    On this page