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 状態をインポートします。プロバイダーは状態を変更する前にすべての項目をプレビューし、計画とレポート内のシークレットを墨消しし、適用前に検証済みのバックアップを作成します。

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 Code ホームである ~/.claude、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