Claude Code / Hermes → OpenClaw 2026：Mac mini M4でのopenclaw migrateを使った完全移行ガイド

2026年4月28日にリリースされたOpenClaw v2026.4.26は、多くの開発者が待ち望んでいた機能を搭載しました：openclaw migrate——Claude CodeまたはHermesで構築したAIコーディングエージェントの設定をOpenClawに一括インポートするコマンドです。MCPサーバー接続、カスタムスキル、ワークフローの調整をClaude CodeまたはHermesで積み上げてきた場合、各設定を手動で再作成することなくOpenClawに移行できます。本ガイドでは、VpsGonaのMac mini M4ノード上でのプロセスを完全に説明します——自動的に移行される内容、手動作業が必要な内容、そして最も一般的な6つの移行後エラーの修正方法を含めて。

2026年に開発者がClaude CodeとHermesからOpenClawに移行する理由

2026年初頭から移行トレンドが加速しました。理由はマーケティングではなく、具体的な製品のギャップです。これらを理解することで、移行があなたのワークフローに適しているかどうか判断できます。

理由1：プラグインハックなしのネイティブマルチエージェントオーケストレーション。Claude Codeのマルチエージェントサポートは回避策が必要で、Anthropicのホストモデルルーティングに限定されています。OpenClawのネイティブマルチエージェントフレームワーク（ClawHub）は、Memory-Wikiステートレイヤーを共有する独立したエージェントプロセスを任意のモデルプロバイダーでオーケストレーションできます。

理由2：OpenClawのOTEL可観測性は本番品質。v2026.4.25以降、OpenClawはすべてのモデル呼び出し、ツール呼び出し、メモリアクセスに対して構造化テレメトリを発行します。Claude CodeとHermesには同等の構造化可観測性がありません。トークンコスト帰属、ツールループ検出、メモリプレッシャーアラートが必要なチーム——特に無人の夜間自律エージェントを実行するチーム——は他のツールで同等の機能を見つけられません。

理由3：プロバイダー中立性とバンドルCerebrasサポート。OpenClaw v2026.4.26はCerebrasをバンドルプロバイダーとして追加し、OpenAI、Anthropic、Gemini、DeepSeek、ローカルOllamaモデルに加わりました。Claude CodeはAnthropicのAPIに構造的に縛られています。Hermesはプロバイダーの柔軟性がありますが、プラグインSDKの成熟度でOpenClaw v2026リリースに及びません。

openclaw migrateがv2026.4.26で実際に行うこと

openclaw migrateコマンドは、ソースツールの設定ディレクトリを構造化スキャンし、互換性のある設定を抽出し、OpenClawの設定フォーマットに変換して書き込みます。会話履歴やセッションログはコピーしません——設定、機能定義、接続メタデータのみを移行します。

移行プロセスは3つのフェーズに分かれています：

1. 発見フェーズ：OpenClawがソース設定ディレクトリ（Claude Codeは~/.claude/、Hermesは~/.hermes/）をスキャンして、インストール済みのMCPサーバー、カスタムスキル/ツール、APIキーの参照、プロバイダー設定を検出します。
2. 変換フェーズ：検出された各項目がOpenClawの同等項目にマッピングされます。MCPサーバー定義はOpenClawのプラグインマニフェスト形式で再表現され、APIキー環境変数名はエイリアス化され、カスタムツール定義はOpenClawのスキルスキーマでラップされます。
3. レポートフェーズ：~/.openclaw/migrate-report.jsonにJSON移行レポートが書き込まれ、正常に移行された各項目、部分的に移行された（手動完了が必要な）各項目、移行できなかった各項目がリストされます。

設定項目	Claude Codeからの移行	Hermesからの移行	備考
MCPサーバーエンドポイント定義	✓ 自動	✓ 自動	接続URIと認証ヘッダーが保持される
カスタムスキル/ツール定義	✓ 自動	✓ 自動	OpenClawスキルスキーマでラップ；移行後にテスト必要
APIキー環境変数の参照	✓ 自動エイリアス	✓ 自動エイリアス	実際のキー値は読み込まれない；.envにエイリアスが作成される
システムプロンプトのカスタマイズ	⚠ 部分（要確認）	⚠ 部分（要確認）	オペレーターID形式がツール間で異なる
モデルプロバイダー設定	⚠ 部分（Anthropicのみ）	✓ 自動（マルチプロバイダー）	Claude CodeのAnthropicでないプロバイダーは移行不可
メモリ/知識ベースのコンテンツ	✗ 移行されない	✗ 移行されない	OpenClaw Memory-Wikiに手動で再インジェストが必要
会話/セッション履歴	✗ 移行されない	✗ 移行されない	設計上——OpenClawのセッション形式は非互換
TaskFlow/Webhook定義	✗ 該当なし（Claude Codeにはない）	⚠ 部分	HermesのワークフロはTaskFlowへの手動マッピングが必要

移行前チェックリスト：コマンド実行前に確認すべき7項目

準備なしにopenclaw migrateを実行すると、ほとんどの移行後問題の原因になります。移行コマンドを実行する前に、以下の7つの項目をすべて確認してください。

1. OpenClawのバージョンが≥ 2026.4.26であることを確認。migrateサブコマンドは以前のバージョンには存在しません。openclaw --versionで確認し、npx openclaw@latest updateまたはエージェント内の/updateで更新してください。
2. ソースツールの設定ディレクトリをバックアップ。cp -r ~/.claude/ ~/claude-backup-$(date +%Y%m%d)/（Claude Code）またはHermesの同等コマンドを実行してください。移行コマンドは読み取り専用ですが、日付付きバックアップがあれば問題が発生しても安心です。
3. アクティブなMCPサーバーをリストアップ。Claude Code内で/mcpを実行して、接続されているMCPサーバーの名前と接続タイプをメモしてください。後で移行レポートのカバレッジを確認するためにこのリストを使用します。
4. カスタムシステムプロンプトのカスタマイズを記録。オペレーターID、ペルソナ指示、セーフティの上書きを変更した場合、それらをプレーンテキストファイルにコピーしてください。移行後に手動で確認が必要になる可能性が最も高い項目です。
5. Mac mini M4ノードでNode.js ≥ 20を確認。migrateはNode 20+が必要なNode.jsのネイティブfetch APIを使用します。node --versionで確認してください。
6. 現在使用しているAPIプロバイダーを確認。Hermesで複数のプロバイダー（OpenAI + Gemini + Cerebrasなど）を設定している場合、移行前にそれらがOpenClawのバンドルプロバイダーリストにすべてあることを確認してください。見つからないプロバイダーはレポートで「manual-required」と表示されます。
7. Mac mini M4ノードに十分なディスク容量があることを確認。移行プロセスは~/.openclaw/にレポートと変換された設定ファイルを書き込みます。ほとんどの設定で500MBの空き容量で十分です。

ステップバイステップ：Mac mini M4でClaude Codeから移行する

以下の手順は、Claude CodeとOpenClaw v2026.4.26+の両方がインストールされたアクティブなVpsGona Mac mini M4セッションがあることを前提とします。ノードにSSH接続して、以下を実行してください：

1. 両方のツールが正しいバージョンで存在することを確認：

   openclaw --version # ≥ 2026.4.26でなければならない claude --version # Claude Codeのインストールを確認

2. Claude Codeを指定して移行コマンドを実行：

   openclaw migrate --from claude-code

   OpenClawは自動的に~/.claude/を検出します。Claude Codeの設定が非標準の場所にある場合は、--sourceで明示的に指定：

   openclaw migrate --from claude-code --source /カスタムパス/.claude/

3. 移行の出力を確認。CLIはリアルタイムで各検出項目を出力します。✓プレフィックスは正常移行、⚠は確認が必要、✗は移行できないことを示します：

   Discovered: 8 MCP servers, 12 custom tools, 3 system prompt blocks, 1 provider config ✓ MCP server: filesystem-mcp → migrated ✓ MCP server: github-mcp → migrated ⚠ System prompt block 'persona' → manual-required (format differs) ⚠ Provider: anthropic → partial ✗ Memory content → not migrated (re-ingest manually) Migration complete. Report: ~/.openclaw/migrate-report.json

4. 完全な移行レポートを確認：

   cat ~/.openclaw/migrate-report.json | python3 -m json.tool | head -80

5. OpenClawを起動してMCP接続を確認：

   openclaw start /mcp status

   移行された各MCPサーバーは緑色の接続状態を示すはずです。接続されていないものがある場合は、以下のトラブルシューティングセクションを参照してください。

ステップバイステップ：HermesからOpenClawへの移行

Hermesの移行は同じパターンに従いますが、異なる--fromフラグとHermes固有の考慮事項があります。Hermesはデフォルトで~/.hermes/に設定を保存し、OpenClawの移行ツールが直接読み込めるYAML形式を使用します。

1. Hermesの移行を実行：

   openclaw migrate --from hermes

   Hermesワークスペース（プロジェクトスコープの設定）の場合は、ワークスペースディレクトリを指定：

   openclaw migrate --from hermes --source /path/to/hermes-workspace/

2. Hermesのワークフロー定義を手動で処理。Hermesの「ワークフロー」構造はOpenClawのTaskFlowsに部分的にマッピングされます。移行ツールはトリガーとステップ構造を変換しますが、条件分岐ロジックを自動的に複製できません。移行後、OpenClawのTaskFlowエディターで各フラグされたワークフローを開き、分岐条件が正しく表現されているか確認してください。
3. マルチプロバイダー設定を再設定。Hermesで複数のモデルプロバイダーを使用していた場合、各プロバイダーがOpenClawの設定でアクティブであることを確認：

   openclaw config list-providers

   不足しているプロバイダーを追加：

   openclaw config add-provider cerebras --api-key $CEREBRAS_API_KEY

4. Memory-Wikiコンテンツを再インジェスト。HermesのメモリコンテンツはOpenClawのMemory-Wikiに再インジェストする必要があります。小さなナレッジベース（50ドキュメント未満）には/learnコマンドを対話的に使用。より大きなベースにはバッチインジェストAPIを使用：

   openclaw memory ingest --dir /path/to/hermes/knowledge/ --format markdown

移行範囲：自動移行 vs 手動設定が必要なもの

項目カテゴリ	自動移行？	必要な手動作業
MCPサーバーエンドポイントと認証	✓ はい	接続成功なら不要；トークン期限切れなら再認証
カスタムツール/スキル定義	✓ はい	スキーマ変換後に各ツールを手動で実行して動作確認
APIキー環境変数エイリアス	✓ はい（エイリアスのみ）	実際のキーが~/.openclaw/.envまたはシステム環境にあることを確認
システムプロンプトのオペレーターID	⚠ 部分	OpenClawのオペレーター形式に合わせて確認・書き直し
モデルプロバイダー設定	⚠ 部分	Claude Code移行時はAnthropicでないプロバイダーを手動追加
Hermesワークフロー条件	⚠ 部分	条件分岐をTaskFlowスキーマに手動変換
メモリ/知識ベースのコンテンツ	✗ なし	/learnまたはバッチインジェストで全ドキュメントを再インジェスト
会話履歴	✗ なし	不要——履歴はツール固有で移植不可
Matrix E2EE設定（v2026.4.26の新機能）	✗ 該当なし（新機能）	最初から設定：openclaw security matrix --setup

移行後のトラブルシューティング：6つの一般的なエラーと修正方法

エラー1：移行後にMCPサーバーが「切断」と表示される。最も一般的な原因は認証トークンの期限切れです。MCPサーバーはトークンの参照を保存しますが、実際のトークン値は保存しません——トークンは期限切れになります。解決策：OpenClawのコントロールパネルでMCPサーバーの認証設定を開き、再認証してください。

エラー2：openclaw migrate: source directory not found。Claude Codeが非標準の場所にインストールされている場合があります。find ~ -name ".claude" -type d 2>/dev/nullで見つけ、--sourceで明示的に指定してください。

エラー3：カスタムツール呼び出し時にschema validation errorが発生。移行ツールはOpenClawのスキルスキーマでツールをラップしますが、一部のツールのパラメータタイプに正確な同等物がありません。~/.openclaw/skills/のツールのパラメータ定義を確認し、型宣言をOpenClawのスキーマ（string、number、boolean、array、object）に合わせてください。

エラー4：移行後の起動ハング（v2026.4.26の既知問題）。多くのMCPサーバーが設定されている場合、v2026.4.26への更新後に起動遅延を報告するユーザーがいます。接続の初期化が同期的であることが原因の既知問題です。回避策：openclaw.config.jsで必須でないMCPサーバーを一時的に無効にし、起動完了後に段階的に再有効化してください。

エラー5：ENOENT: no such file or directory, open '~/.openclaw/.env'。移行ツールは.envが存在することを前提とします。手動で作成し、実際のキーを入力してください：

touch ~/.openclaw/.env echo "ANTHROPIC_API_KEY=your-key-here" >> ~/.openclaw/.env echo "OPENAI_API_KEY=your-key-here" >> ~/.openclaw/.env

エラー6：移行後にOllama接続が失敗する。OpenClaw v2026.4.26はQwenとGemma 4モデルのOllamaの信頼性を特に改善しました。Hermesでは動作していたOllama接続がOpenClawで失敗する場合、Ollama 0.22.0以降を実行しているか確認してください：

ollama --version # ≥ 0.22.0であるべき ollama serve # OpenClaw起動前にOllamaが実行中であることを確認

Mac mini M4上での移行済みOpenClaw設定の最適化

移行が安定してすべてのMCPサーバーが接続されたら、Mac mini M4のデプロイメントに特に有益な4つの最適化を実施できます：

• 実際に使用するモデルに基づいてmaxContextTokensを設定。移行された設定は汎用的なコンテキストウィンドウサイズを継承します。16GB統合メモリのMac mini M4では、Claude 3.7 Sonnetの200Kコンテキストウィンドウはメモリ集約的です。典型的なコーディングタスクでは、openclaw.config.jsでmaxContextTokens: 32768を設定することでメモリプレッシャーを大幅に削減しながら、ほぼすべての実際のコーディングセッションをカバーできます。
• 新しいJSON5保留中変更差分パネルを有効化。v2026.4.26の新機能で、エージェントがファイル変更をコミットする前に構造化差分を表示します。リモートMac mini M4セッションでリアルタイムに作業ディレクトリを確認できない場合に特に有用です：

  // openclaw.config.jsで ui: { pendingChangesDiff: true, diffFormat: 'json5' }

• 速度重視のタスクにCerebrasプロバイダーを設定。Cerebrasはv2026.4.26でバンドルプロバイダーとなりました。応答速度が出力長より重要なタスク——クイックコード説明、型アノテーション提案、テストケース生成——では、Cerebrasモデルが同様の品質レベルでAnthropicやOpenAIより大幅に低い最初のトークン到達時間を提供します。
• 安全なリモートセッションのためにMatrix E2EEを設定。Claude CodeとHermesの両方にはない新機能です。VpsGonaノード上でOpenClawを実行する場合、すべてのデータはすでにSSH経由で送信されますが、Matrix E2EEを追加するとアプリケーション層でのエンドツーエンド暗号化が加わります：

  openclaw security matrix --setup

VpsGonaのMac mini M4がOpenClaw移行の理想的なターゲット環境である理由

OpenClawへの移行は設定の変更です；OpenClawをどこで実行するかが、移行が完全な価値を発揮するかどうかを決定します。個人のノートPCまたはデスクトップでClaude CodeまたはHermesを実行していた開発者にとって、VpsGonaのMac mini M4ノード上のOpenClawへの移行はいくつかの具体的な点で状況を変えます。

まず、Mac mini M4のApple Siliconアーキテクチャは、Claude Codeユーザーが構築したすべてのmacOS専用MCPサーバーとツールとネイティブに互換性があります。ファイルシステムアクセス、Xcode統合、AppleScriptまたはショートカットによるmacOSオートメーション、CoreMLベースのローカルモデル推論——すべてがM4チップ上で設計通りに動作します。MCPサーバー設定を移行すると、設計された環境とまったく同じOSとチップアーキテクチャの環境に落ちます。

次に、VpsGonaの最低コミットメントなしのレンタルモデルは、OpenClawの使用パターンと自然に一致します。OpenClawの最も強力な機能——ClawHubを通じたマルチエージェントオーケストレーション、OTEL可観測性、無人夜間エージェント——は個人のマシンで断続的に使用するのではなく、専用ノードで継続的に実行するときに最も価値があります。OpenClawワークロード専用のMac mini M4ノードをプロジェクトサイクルごとにレンタルすることで、専用サーバーの代替手段のコストのほんの一部でネイティブApple Siliconパフォーマンスを実現できます。現在のノード設定についてはVpsGonaの料金ページを、OpenClaw環境のセットアップについてはデプロイメントドキュメントを参照してください。