English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Maintenance

Claude からの移行

OpenClaw は、同梱の Claude 移行プロバイダーを通じてローカルの Claude 状態をインポートします。このプロバイダーは状態を変更する前にすべての項目をプレビューし、計画とレポート内のシークレットを秘匿し、適用前に検証済みバックアップを作成します。

インポートする2つの方法

オンボーディングウィザード

ウィザードはローカルの Claude 状態を検出すると Claude を提示します。

openclaw onboard --flow import

または、特定のソースを指定します。

openclaw onboard --import-from claude --import-source ~/.claude

CLI

スクリプト化された実行や反復可能な実行には openclaw migrate を使用します。完全なリファレンスは openclaw migrate を参照してください。

openclaw migrate claude --dry-run
openclaw migrate apply claude --yes

特定の Claude Code ホームまたはプロジェクトルートをインポートするには、--from <path> を追加します。

インポートされるもの

指示とメモリ
  • プロジェクトの CLAUDE.md と .claude/CLAUDE.md の内容は、OpenClaw エージェントワークスペースの AGENTS.md にコピーまたは追記されます。
  • ユーザーの ~/.claude/CLAUDE.md の内容は、ワークスペースの USER.md に追記されます。
MCP サーバー

MCP サーバー定義は、存在する場合、プロジェクトの .mcp.json、Claude Code の ~/.claude.json、Claude Desktop の claude_desktop_config.json からインポートされます。

Skills とコマンド
  • SKILL.md ファイルを持つ Claude skills は、OpenClaw ワークスペースの skills ディレクトリにコピーされます。
  • .claude/commands/ または ~/.claude/commands/ 配下の Claude コマンド Markdown ファイルは、disable-model-invocation: true を持つ OpenClaw skills に変換されます。

アーカイブ専用として残るもの

プロバイダーは手動確認用にこれらを移行レポートへコピーしますが、ライブの OpenClaw config にはロードしません。

  • Claude hooks
  • Claude 権限と広範なツール許可リスト
  • Claude 環境デフォルト
  • CLAUDE.local.md
  • .claude/rules/
  • .claude/agents/ または ~/.claude/agents/ 配下の Claude サブエージェント
  • Claude Code のキャッシュ、計画、プロジェクト履歴ディレクトリ
  • Claude Desktop 拡張機能と OS に保存された認証情報

OpenClaw は、hooks の実行、権限許可リストの信頼、不透明な OAuth と Desktop 認証情報状態の自動デコードを拒否します。アーカイブを確認した後、必要なものを手動で移動してください。

ソースの選択

--from がない場合、OpenClaw はデフォルトの Claude Code ホームである ~/.claude、サンプリングされた Claude Code の ~/.claude.json 状態ファイル、macOS 上の Claude Desktop MCP config を検査します。

--from がプロジェクトルートを指す場合、OpenClaw は CLAUDE.md、.claude/settings.json、.claude/commands/、.claude/skills/、.mcp.json など、そのプロジェクトの Claude ファイルのみをインポートします。プロジェクトルートのインポート中に、グローバルな Claude ホームは読み取りません。

推奨フロー

  • 計画をプレビューする

    openclaw migrate claude --dry-run

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

  • バックアップ付きで適用する

    openclaw migrate apply claude --yes

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

  • doctor を実行する

    openclaw doctor

    Doctor は、インポート後の config または状態の問題を確認します。

  • 再起動して確認する

    openclaw gateway restart
openclaw status

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

    • 競合の処理

    計画が競合を報告する場合、適用は続行を拒否します（ファイルまたは config 値がターゲットにすでに存在します）。

    新規の OpenClaw インストールでは、競合はまれです。通常は、すでにユーザー編集があるセットアップでインポートを再実行した場合に発生します。

    自動化向けの JSON 出力

    openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes

    --json を指定し、--yes を指定しない場合、apply は計画を出力し、状態を変更しません。これは CI と共有スクリプトにとって最も安全なモードです。

    トラブルシューティング

    Claude 状態が ~/.claude の外にある

    --from /actual/path（CLI）または --import-source /actual/path（オンボーディング）を渡します。

    オンボーディングが既存セットアップへのインポートを拒否する

    オンボーディングでのインポートには新規セットアップが必要です。状態をリセットして再オンボーディングするか、--overwrite と明示的なバックアップ制御をサポートする openclaw migrate apply claude を直接使用してください。

    Claude Desktop の MCP サーバーがインポートされなかった

    Claude Desktop はプラットフォーム固有のパスから claude_desktop_config.json を読み取ります。OpenClaw が自動検出しなかった場合は、そのファイルのディレクトリを --from に指定してください。

    Claude コマンドがモデル呼び出し無効の skills になった

    これは設計どおりです。Claude コマンドはユーザーがトリガーするため、OpenClaw はそれらを disable-model-invocation: true を持つ skills としてインポートします。エージェントに自動で呼び出させたい場合は、各 skill の frontmatter を編集してください。

    関連