Skip to main content
OpenClaw は、バンドルされた Claude 移行プロバイダーを通じてローカルの Claude 状態をインポートします。プロバイダーは状態を変更する前にすべての項目をプレビューし、計画とレポート内のシークレットを秘匿します。スタンドアロンの openclaw migrate は検証済みバックアップを作成します。新規オンボーディングのパスではインポートをステージングし、検証に成功した後でのみ公開します。
オンボーディングによるインポートには、新規の OpenClaw セットアップが必要です。ローカルに OpenClaw の状態がすでに存在する場合は、まず設定、認証情報、セッション、ワークスペースをリセットするか、計画を確認した後に --overwrite を指定して openclaw migrate を直接使用してください。

​
2 つのインポート方法

ローカルの Claude 状態を検出すると、ウィザードに Claude が表示されます。
または、特定のソースを指定します。

​
インポートされるもの

  • プロジェクトの CLAUDE.md と .claude/CLAUDE.md の内容は、OpenClaw エージェントワークスペースの AGENTS.md にコピーまたは追記されます。
  • ユーザーの ~/.claude/CLAUDE.md の内容は、ワークスペースの USER.md に追記されます。
MCP サーバー定義が存在する場合、プロジェクトの .mcp.json、Claude Code の ~/.claude.json、Claude Desktop の claude_desktop_config.json からインポートされます。
  • SKILL.md ファイルを持つ Claude Skills は、OpenClaw ワークスペースの Skills ディレクトリにコピーされます。
  • .claude/commands/ または ~/.claude/commands/ 配下の Claude コマンド Markdown ファイルは、disable-model-invocation: true を持つ OpenClaw Skills に変換されます。

​
アーカイブのみに保持されるもの

プロバイダーは手動確認用として以下を移行レポートにコピーしますが、稼働中の OpenClaw 設定には読み込みません。
  • Claude フック
  • Claude の権限と広範なツール許可リスト
  • Claude の環境デフォルト
  • CLAUDE.local.md
  • .claude/rules/
  • .claude/agents/ または ~/.claude/agents/ 配下の Claude サブエージェント
  • Claude Code のキャッシュ、計画、プロジェクト履歴ディレクトリ
  • Claude Desktop の拡張機能と OS に保存された認証情報
OpenClaw は、フックの実行、権限許可リストの信頼、不透明な OAuth および Desktop の認証情報状態の自動デコードを拒否します。アーカイブを確認した後、必要なものを手動で移動してください。

​
ソースの選択

--from を指定しない場合、OpenClaw は ~/.claude にあるデフォルトの Claude Code ホーム、サンプリングされた Claude Code の ~/.claude.json 状態ファイル、および macOS 上の Claude Desktop MCP 設定を調べます。 --from がプロジェクトルートを指している場合、OpenClaw は CLAUDE.md、.claude/settings.json、.claude/commands/、.claude/skills/、.mcp.json など、そのプロジェクトの Claude ファイルのみをインポートします。プロジェクトルートのインポート中にグローバルな Claude ホームを読み取ることはありません。

​
推奨フロー

1

計画をプレビューする

計画には、競合、スキップされる項目、ネストされた MCP の env または headers フィールドから秘匿された機密値を含め、変更されるすべての内容が一覧表示されます。
2

バックアップを作成して適用する

OpenClaw は適用前にバックアップを作成して検証します。
3

doctor を実行する

Doctor はインポート後に設定または状態の問題がないか確認します。
4

再起動して検証する

Gateway が正常であり、インポートした指示、MCP サーバー、Skills が読み込まれていることを確認します。

​
競合の処理

計画で競合（対象にファイルまたは設定値がすでに存在すること）が報告された場合、適用処理は続行を拒否します。
既存の対象を意図的に置き換える場合にのみ、--overwrite を指定して再実行してください。上書きされるファイルについては、プロバイダーが移行レポートディレクトリに項目単位のバックアップを作成する場合があります。
新規の OpenClaw インストールでは、競合はほとんど発生しません。通常は、ユーザーによる編集がすでに存在するセットアップでインポートを再実行した場合に発生します。

​
自動化用の JSON 出力

対話型ターミナル外で migrate apply を使用するには、--yes が必要です。これを指定しない場合、OpenClaw は適用せずにエラーになるため、スクリプトと CI は --yes を明示的に渡す必要があります。まず --dry-run --json でプレビューし、計画に問題がないことを確認してから --json --yes で適用してください。

​
トラブルシューティング

--from /actual/path（CLI）または --import-source /actual/path（オンボーディング）を渡します。
オンボーディングによるインポートには、新規セットアップが必要です。状態をリセットしてオンボーディングをやり直すか、--overwrite と明示的なバックアップ制御をサポートする openclaw migrate apply claude を直接使用してください。
Claude Desktop は、プラットフォーム固有のパスから claude_desktop_config.json を読み取ります。OpenClaw が自動的に検出しなかった場合は、--from でそのファイルのディレクトリを指定してください。
これは仕様です。Claude コマンドはユーザーが起動するため、OpenClaw は disable-model-invocation: true を持つ Skills としてインポートします。エージェントから自動的に呼び出せるようにする場合は、各 Skill の frontmatter を編集してください。

​
関連情報