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

Maintenance

Claude からの移行

OpenClaw は、バンドルされた Claude 移行プロバイダーを通じてローカルの Claude 状態をインポートします。プロバイダーは状態を変更する前にすべての項目をプレビューし、計画とレポート内のシークレットを秘匿します。スタンドアロンの openclaw migrate は検証済みバックアップを作成します。新規オンボーディングのパスではインポートをステージングし、検証に成功した後でのみ公開します。

2 つのインポート方法

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

ローカルの Claude 状態を検出すると、ウィザードに Claude が表示されます。

bash
openclaw onboard --flow import

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

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

CLI

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

bash
openclaw migrate claude --dry-runopenclaw 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 設定には読み込みません。

  • 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 ホームを読み取ることはありません。

推奨フロー

  • 計画をプレビューする

    bash
    openclaw migrate claude --dry-run

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

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

    bash
    openclaw migrate apply claude --yes

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

  • doctor を実行する

    bash
    openclaw doctor

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

  • 再起動して検証する

    bash
    openclaw gateway restartopenclaw status

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

    • 競合の処理

    計画で競合（対象にファイルまたは設定値がすでに存在すること）が報告された場合、適用処理は続行を拒否します。

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

    自動化用の JSON 出力

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

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

    トラブルシューティング

    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 を編集してください。

    関連情報

    Was this useful?
    On this page

    On this page