# openclaw migrate

Plugin が所有する移行プロバイダーを通じて、別のエージェントシステムから状態をインポートします。バンドルされたプロバイダーは Codex CLI の状態、Claude、Hermes に対応しています。サードパーティ Plugin は追加のプロバイダーを登録できます。

# コマンド

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes
openclaw migrate apply claude --yes
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --include-secrets --yes
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw onboard --import-from hermes --import-source ~/.hermes

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> 登録済みの移行プロバイダー名。たとえば hermes です。インストール済みのプロバイダーを確認するには openclaw migrate list を実行します。

--dry-runboolean

プランを作成し、状態を変更せずに終了します。

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> ソース状態ディレクトリを上書きします。Hermes のデフォルトは ~/.hermes です。

--include-secretsboolean

サポートされている認証情報をインポートします。デフォルトではオフです。

--overwriteboolean

プランが競合を報告したときに、適用処理が既存のターゲットを置き換えることを許可します。

--yesboolean

確認プロンプトをスキップします。非対話モードでは必須です。

"--skill

--no-backupboolean

適用前のバックアップをスキップします。ローカルの OpenClaw 状態が存在する場合は --force が必要です。

--forceboolean

バックアップのスキップを通常なら拒否する適用処理で、--no-backup と併用する必要があります。

--jsonboolean

プランまたは適用結果を JSON として出力します。--json を指定し、--yes を指定しない場合、適用処理はプランを出力し、状態は変更しません。

# 安全モデル

openclaw migrate はプレビュー優先です。

# Claude プロバイダー

バンドルされた Claude プロバイダーは、デフォルトで ~/.claude にある Claude Code の状態を検出します。特定の Claude Code ホームまたはプロジェクトルートをインポートするには --from <path> を使用します。

# Claude がインポートするもの

• プロジェクトの CLAUDE.md と .claude/CLAUDE.md を OpenClaw エージェントワークスペースに取り込みます。
• ユーザーの ~/.claude/CLAUDE.md をワークスペースの USER.md に追記します。
• プロジェクトの .mcp.json、Claude Code の ~/.claude.json、Claude Desktop の claude_desktop_config.json から MCP サーバー定義を取り込みます。
• SKILL.md を含む Claude スキルディレクトリ。
• Claude コマンドの Markdown ファイルを、手動呼び出し専用の OpenClaw スキルに変換します。

# アーカイブと手動レビュー状態

Claude のフック、権限、環境デフォルト、ローカルメモリ、パススコープのルール、サブエージェント、キャッシュ、プラン、プロジェクト履歴は、移行レポートに保存されるか、手動レビュー項目として報告されます。OpenClaw はフックを実行せず、広範な許可リストをコピーせず、OAuth/Desktop 認証情報の状態を自動的にインポートしません。

# Codex プロバイダー

バンドルされた Codex プロバイダーは、デフォルトで ~/.codex にある Codex CLI の状態を検出します。また、その環境変数が設定されている場合は CODEX_HOME を使用します。特定の Codex ホームをインベントリするには --from <path> を使用します。

OpenClaw Codex ハーネスへ移行し、有用な個人用 Codex CLI アセットを意図的に昇格したい場合に、このプロバイダーを使用します。ローカルの Codex アプリサーバー起動では、エージェントごとの CODEX_HOME と HOME ディレクトリが使用されるため、デフォルトでは個人用 Codex CLI 状態は読み取られません。

対話型ターミナルで openclaw migrate codex を実行すると、完全なプランがプレビューされ、その後、最終的な適用確認の前にスキルコピー項目用のチェックボックスセレクターが開きます。一括選択には Toggle all on または Toggle all off を使用します。計画済みスキルはチェック済みで開始し、競合しているスキルは未チェックで開始し、Skip for now は適用せずにスキルを変更しないままにします。スクリプト化された実行や厳密な実行では、スキルごとに --skill <name> を 1 回渡します。例:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace

# Codex がインポートするもの

• $CODEX_HOME/skills 配下の Codex CLI スキルディレクトリ。ただし Codex の .system キャッシュは除外されます。
• $HOME/.agents/skills 配下の個人用 AgentSkills。エージェントごとの所有にしたい場合、現在の OpenClaw エージェントワークスペースにコピーされます。

# 手動レビューの Codex 状態

Codex ネイティブ Plugin、config.toml、ネイティブの hooks/hooks.json は自動的には有効化されません。Plugin は MCP サーバー、アプリ、フック、その他の実行可能な動作を公開する場合があるため、プロバイダーはそれらを OpenClaw に読み込む代わりにレビュー対象として報告します。設定ファイルとフックファイルは、手動レビュー用に移行レポートへコピーされます。

# Hermes プロバイダー

バンドルされた Hermes プロバイダーは、デフォルトで ~/.hermes にある状態を検出します。Hermes が別の場所にある場合は --from <path> を使用します。

# Hermes がインポートするもの

• config.yaml からのデフォルトモデル設定。
• providers と custom_providers からの設定済みモデルプロバイダーとカスタム OpenAI 互換エンドポイント。
• mcp_servers または mcp.servers からの MCP サーバー定義。
• SOUL.md と AGENTS.md を OpenClaw エージェントワークスペースに取り込みます。
• memories/MEMORY.md と memories/USER.md をワークスペースのメモリファイルに追記します。
• OpenClaw ファイルメモリ用のメモリ設定デフォルト、および Honcho などの外部メモリプロバイダー向けのアーカイブ項目または手動レビュー項目。
• skills/<name>/ 配下に SKILL.md ファイルを含む Skills。
• skills.config からのスキルごとの設定値。
• .env からのサポート対象 API キー。ただし --include-secrets を指定した場合のみ。

# サポート対象の .env キー

OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY.

# アーカイブ専用状態

OpenClaw が安全に解釈できない Hermes の状態は、手動レビュー用に移行レポートへコピーされますが、ライブの OpenClaw 設定や認証情報には読み込まれません。これにより、OpenClaw が自動的に実行または信頼できると見なすことなく、不透明または安全でない状態を保持できます。

• plugins/
• sessions/
• logs/
• cron/
• mcp-tokens/
• auth.json
• state.db

# 適用後

openclaw doctor

# Plugin 契約

移行ソースは Plugin です。Plugin は openclaw.plugin.json でプロバイダー ID を宣言します。

{
  "contracts": {
    "migrationProviders": ["hermes"]
  }
}

実行時に Plugin は api.registerMigrationProvider(...) を呼び出します。プロバイダーは detect、plan、apply を実装します。コアは CLI のオーケストレーション、バックアップポリシー、プロンプト、JSON 出力、競合の事前確認を所有します。コアはレビュー済みのプランを apply(ctx, plan) に渡します。プロバイダーは互換性のため、その引数が存在しない場合にのみプランを再構築できます。

プロバイダー Plugin は、項目の構築とサマリー件数に openclaw/plugin-sdk/migration を使用でき、競合を考慮したファイルコピー、アーカイブ専用のレポートコピー、キャッシュ済み config-runtime ラッパー、移行レポートには openclaw/plugin-sdk/migration-runtime を使用できます。

# オンボーディング統合

オンボーディングでは、プロバイダーが既知のソースを検出したときに移行を提示できます。openclaw onboard --flow import と openclaw setup --wizard --import-from hermes はどちらも同じ Plugin 移行プロバイダーを使用し、適用前には引き続きプレビューを表示します。

# 関連

• Hermes からの移行: ユーザー向け手順。
• Claude からの移行: ユーザー向け手順。
• 移行: OpenClaw を新しいマシンへ移動します。
• Doctor: 移行適用後のヘルスチェック。
• Plugins: Plugin のインストールと登録。