Claude Code / Hermes → OpenClaw 2026：使用 openclaw migrate 在 Mac mini M4 上完成遷移

OpenClaw v2026.4.26（2026年4月28日發布）帶來了許多開發者期待已久的功能：openclaw migrate——一條指令就能將你在 Claude Code 或 Hermes 中積累的 AI 程式設計智能體配置完整匯入 OpenClaw。如果你已在 Claude Code 或 Hermes 中搭建了 MCP 伺服器連線、自訂技能和工作流調校，希望無縫遷移到 OpenClaw 而無需逐件手動重建，本文將在 VpsGona Mac mini M4 節點上帶你走完完整流程——包括哪些內容自動遷移、哪些需要手動處理，以及六個最常見遷移後問題的修復方法。

2026 年開發者從 Claude Code 和 Hermes 遷移到 OpenClaw 的原因

2026 年初遷移趨勢加速，原因是具體的產品差距，而非行銷。理解這些差距，有助於你判斷遷移是否適合自己的工作流。

原因一：原生多智能體編排，無需插件變通。Claude Code 的多智能體支援需要各種變通，且僅限於 Anthropic 托管的模型路由。OpenClaw 的原生多智能體框架（ClawHub）允許編排共享 Memory-Wiki 狀態層的獨立智能體程序，支援任何模型提供商。並行運行研究、程式碼審查和測試生成智能體的團隊，普遍認為 ClawHub 架構在管理上比 Claude Code 簡單得多。

原因二：OpenClaw 的 OTEL 可觀測性達到生產級別。自 v2026.4.25 起，OpenClaw 為每次模型呼叫、工具呼叫和記憶體存取發出結構化遙測數據。Claude Code 和 Hermes 均缺乏等效的結構化可觀測性。需要 Token 成本歸因、工具迴圈偵測和記憶體壓力告警的團隊——尤其是運行無人值守的夜間自主智能體的團隊——在其他工具中找不到對標功能。

原因三：提供商中立，內建 Cerebras 支援。OpenClaw v2026.4.26 新增了 Cerebras 作為內建提供商，加入 OpenAI、Anthropic、Gemini、DeepSeek 和本地 Ollama 模型的行列。Claude Code 在結構上與 Anthropic API 深度綁定。Hermes 有提供商靈活性，但插件 SDK 的成熟度不及 OpenClaw v2026 版本。如果你運行混合提供商工作流，OpenClaw 的插件清單架構可以跨提供商處理模型 ID 規範化，無需自訂配置。

openclaw migrate 在 v2026.4.26 中實際做了什麼

openclaw migrate 指令對來源工具的配置目錄進行結構化掃描，提取相容設定，並將其轉換為 OpenClaw 的配置格式寫入。它不會複製對話歷史或工作階段日誌——只遷移配置、能力定義和連線元數據。

遷移過程分三個階段：

1. 探索階段：OpenClaw 掃描來源配置目錄（Claude Code 為 ~/.claude/，Hermes 為 ~/.hermes/），偵測已安裝的 MCP 伺服器、自訂技能/工具、API 金鑰引用和提供商配置。
2. 轉換階段：每個偵測到的項目映射到其 OpenClaw 等效項。MCP 伺服器定義以 OpenClaw 的插件清單格式重新表達，API 金鑰環境變數名稱被建立別名，自訂工具定義被包裝進 OpenClaw 的技能結構（skill schema）中。
3. 報告階段：將 JSON 遷移報告寫入 ~/.openclaw/migrate-report.json，列出每個成功遷移的項目、每個部分遷移（需要手動補全）的項目，以及每個無法遷移（格式不相容或無 OpenClaw 等效項）的項目。

配置項	從 Claude Code 遷移	從 Hermes 遷移	說明
MCP 伺服器端點定義	✓ 自動	✓ 自動	連線 URI 和認證標頭資訊保留
自訂技能/工具定義	✓ 自動	✓ 自動	包裝進 OpenClaw 技能結構；遷移後請逐一測試
API 金鑰環境變數引用	✓ 自動建立別名	✓ 自動建立別名	只讀取變數名，不讀取實際金鑰值；別名寫入 .env
系統提示自訂	⚠ 部分（需審查）	⚠ 部分（需審查）	操作者身份格式在不同工具間有差異
模型提供商配置	⚠ 部分（僅 Anthropic）	✓ 自動（多提供商）	Claude Code 中的非 Anthropic 提供商無法遷移
記憶/知識庫內容	✗ 不遷移	✗ 不遷移	需手動重新匯入 OpenClaw Memory-Wiki
對話/工作階段歷史	✗ 不遷移	✗ 不遷移	設計決策——OpenClaw 工作階段格式不相容
TaskFlow/Webhook 定義	✗ 不適用（Claude Code 無此功能）	⚠ 部分	Hermes 工作流定義需手動映射到 TaskFlows

遷移前檢查清單：執行指令前必須核查的 7 項

在沒有充分準備的情況下執行 openclaw migrate，是大多數遷移後問題的根源。在執行遷移指令前，請完成以下所有七項核查。

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. 記錄你的自訂系統提示修改。如果你修改了操作者身份、角色指令或安全覆蓋，將這些內容複製到一個純文字檔案中。這些是遷移後最有可能需要手動審查的項目。
5. 確認 Mac mini M4 節點上 Node.js ≥ 20。migrate 使用 Node 原生 fetch API，需要 Node 20+。執行 node --version 驗證。
6. 記錄當前使用的 API 提供商。如果 Hermes 配置了多個提供商（如 OpenAI + Gemini + Cerebras），遷移前確認它們都在 OpenClaw 的內建提供商清單中。缺少的提供商會在報告中顯示為 "manual-required"。
7. 確保 Mac mini M4 節點有足夠磁碟空間。遷移過程將報告和轉換後的配置檔案寫入 ~/.openclaw/。對大多數配置來說，500MB 可用空間綽綽有餘。

逐步操作：在 Mac mini M4 上從 Claude Code 遷移

以下步驟假設你已有一個活躍的 VpsGona Mac mini M4 工作階段，且 Claude Code 和 OpenClaw v2026.4.26+ 均已安裝。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 即時列印每個發現的項目。前綴 ✓ 表示遷移成功，⚠ 表示需要審查，✗ 表示無法遷移。典型的 Claude Code 遷移輸出如下：

   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 (only Anthropic models available in source) ✗ 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/，使用 YAML 配置格式，OpenClaw 的遷移工具可以直接讀取。

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 或系統環境變數中
系統提示操作者身份	⚠ 部分	按 OpenClaw 的操作者格式審查和重寫
模型提供商配置	⚠ 部分	Claude Code 遷移時手動新增非 Anthropic 提供商
Hermes 工作流條件	⚠ 部分	手動將條件分支轉換為 TaskFlow 結構
記憶/知識庫內容	✗ 否	透過 /learn 或批次匯入指令重新匯入所有文件
對話歷史	✗ 否	無需操作——歷史記錄是工具特有的，不可移植
Matrix E2EE 配置（v2026.4.26 新功能）	✗ 不適用（全新功能）	從零開始配置：openclaw security matrix --setup

遷移後常見問題排查：6 個錯誤及修復方法

以下是首次執行 openclaw migrate 後 OpenClaw 社群中頻繁出現的報錯及解決方案。

問題一：遷移後 MCP 伺服器顯示「未連線」。最常見原因是認證憑證過期。使用 OAuth 或 Bearer Token 的 MCP 伺服器存儲的是憑證的引用而非憑證值本身——憑證會過期。解決方案：在 OpenClaw 控制面板中開啟該 MCP 伺服器的認證設定，重新進行認證。

問題二：openclaw migrate: source directory not found。如果你使用了非標準安裝方式，Claude Code 可能不在預設位置。執行 find ~ -name ".claude" -type d 2>/dev/null 定位配置目錄，然後用 --source 參數明確指定路徑。

問題三：呼叫自訂工具時出現 schema validation error。遷移工具將工具包裝進 OpenClaw 技能結構，但某些工具的參數類型沒有精確對應項。檢查 ~/.openclaw/skills/ 中該工具的參數定義，將類型宣告與 OpenClaw 的結構對齊（string、number、boolean、array、object）。

問題四：遷移後啟動掛起（v2026.4.26 已知問題）。部分用戶在更新到 v2026.4.26 後回報啟動延遲，尤其是配置了大量 MCP 伺服器時。這是已知問題，連線初始化是同步的。臨時解決方案：在 openclaw.config.js 中暫時停用非必要 MCP 伺服器，等啟動完成後再逐步重新啟用。

問題五：ENOENT: no such file or directory, open '~/.openclaw/.env'。遷移工具假設 .env 檔案已存在。手動建立並填入你的實際金鑰：

touch ~/.openclaw/.env echo "ANTHROPIC_API_KEY=你的金鑰" >> ~/.openclaw/.env echo "OPENAI_API_KEY=你的金鑰" >> ~/.openclaw/.env

問題六：遷移後 Ollama 連線失敗。OpenClaw v2026.4.26 專門改進了 Qwen 和 Gemma 4 模型的 Ollama 可靠性。如果 Ollama 在 Hermes 中能正常運作但在 OpenClaw 中失敗，檢查你執行的是否是 Ollama 0.22.0 或更高版本——社群回報確認這個版本解決了與更新檢索路徑的相容性問題：

ollama --version # 應為 ≥ 0.22.0 ollama serve # 確認 Ollama 在 OpenClaw 啟動前已執行

在 Mac mini M4 上最佳化已遷移的 OpenClaw 配置

遷移穩定、所有 MCP 伺服器正常連線後，以下四項最佳化對 Mac mini M4 部署特別有價值：

• 根據實際使用的模型設定 maxContextTokens。遷移後的配置繼承了通用的情境視窗大小。在擁有 16GB 統一記憶體的 Mac mini M4 上，Claude 3.7 Sonnet 的 200K 情境視窗記憶體消耗較大。對於典型的編碼任務，在 openclaw.config.js 中將 maxContextTokens 設定為 32768，可顯著降低記憶體壓力，同時涵蓋幾乎所有真實編碼工作階段。
• 啟用新的 JSON5 待定變更差異面板。這是 v2026.4.26 的新功能，在智能體提交檔案變更前展示結構化差異。在透過 SSH 遠端管理 Mac mini M4 節點、無法即時可視化檢查工作目錄的場景下，這個面板特別有價值：

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

• 為速度敏感型任務配置 Cerebras 提供商。Cerebras 現在是 v2026.4.26 的內建提供商。對於回應延遲比輸出長度更重要的任務——快速程式碼解釋、類型注解建議、測試案例生成——Cerebras 模型在相似品質水準上提供比 Anthropic 或 OpenAI 明顯更低的首 Token 到達時間。
• 為安全的遠端工作階段配置 Matrix E2EE。這是 Claude Code 和 Hermes 均不具備的全新功能。在 VpsGona 節點上執行 OpenClaw 時，所有數據已透過 SSH 傳輸，但新增 Matrix E2EE 在應用層增加了端到端加密——特別適合智能體處理含敏感憑據程式碼的場景：

  openclaw security matrix --setup

為何 VpsGona Mac mini M4 是 OpenClaw 遷移的理想目標環境

遷移到 OpenClaw 是一次配置變更；在哪裡執行 OpenClaw，決定了遷移能否發揮完整價值。對於原本在個人筆記型電腦或桌上型電腦上執行 Claude Code 或 Hermes 的開發者，遷移到 VpsGona Mac mini M4 節點上的 OpenClaw，在幾個具體方面改變了局面。

首先，Mac mini M4 的 Apple Silicon 架構與 Claude Code 用戶積累的每一個 macOS 專用 MCP 伺服器和工具天然相容。檔案系統存取、Xcode 整合、透過 AppleScript 或 Shortcuts 實現的 macOS 自動化，以及基於 CoreML 的本地模型推理，全部在 M4 晶片上如預期執行——沒有 x86 仿真的相容層負擔。當你遷移 MCP 伺服器配置時，它們落入的是與設計目標完全相同的 OS 和晶片架構環境。

其次，VpsGona 無最低承諾的租用模式與 OpenClaw 的使用模式天然契合。OpenClaw 最強大的功能——透過 ClawHub 的多智能體編排、OTEL 可觀測性、無人值守的夜間自主智能體——在專屬節點上持續執行時最有價值，而不是在個人電腦上間歇使用。按專案週期租用專門執行 OpenClaw 工作負載的 Mac mini M4 節點，成本是獨立伺服器方案的一小部分，同時提供原生 Apple Silicon 效能。新的 OTEL 整合還意味著你可以將每小時的運算成本歸因到具體的智能體任務，把 VpsGona 的帳單變成 AI 運算實際投入的可稽核記錄。查看當前節點配置詳情，請訪問 VpsGona 定價頁；OpenClaw 環境配置說明，請參見 說明文件。