<!-- Source: https://hermesbible.com/docs/guides/migrate-from-openclaw -->

hermes claw migrate 將你的 OpenClaw（或舊版 Clawdbot/Moldbot）設定匯入 Hermes。本指南涵蓋確切遷移的內容、設定鍵對應，以及遷移後需要驗證的事項。

提示

如果你的 OpenClaw 設定是多供應商的，hermes setup --portal 會將其壓縮為一個 OAuth — 300 多個模型加上 Tool Gateway 在一個登入中。參見 Nous Portal。

快速開始

# 預覽然後遷移（總是先顯示預覽，然後要求確認）
hermes claw migrate

# 僅預覽，不做任何變更
hermes claw migrate --dry-run

# 完整遷移包括 API 金鑰，跳過確認
hermes claw migrate --preset full --migrate-secrets --yes

遷移總是先顯示將匯入內容的完整預覽，然後才進行任何變更。檢視清單，然後確認繼續。

預設從 ~/.openclaw/ 讀取。舊版 ~/.clawdbot/ 或 ~/.moltbot/ 目錄會被自動偵測。舊版設定檔名稱（clawdbot.json、moltbot.json）也是如此。

選項

遷移內容

人物、記憶和指令

工作區檔案也會在 workspace.default/ 和 workspace-main/ 作為備用路徑被檢查（OpenClaw 在最近版本中將 workspace/ 重新命名為 workspace-main/，並使用 workspace-{agentId} 用於多代理設定）。

技能（4 個來源）

技能衝突由 --skill-conflict 處理：skip 保留現有的 Hermes 技能，overwrite 替換它，rename 建立 -imported 副本。

模型和供應商設定

代理程式行為

工作階段重設策略

注意：OpenClaw 還有 session.resetTriggers（像 ["daily", "idle"] 這樣的簡單字串陣列）。如果結構化的 session.reset 不存在，遷移會從 resetTriggers 退回推斷。

MCP 伺服器

TTS（文字轉語音）

TTS 設定從兩個 OpenClaw 設定位置讀取，優先順序如下：

1. messages.tts.providers.{provider}.*（規範位置）
2. 頂層 talk.providers.{provider}.*（備用）
3. 舊版扁平鍵 messages.tts.{provider}.*（最舊格式）

訊息平台

其他設定

已封存（無直接 Hermes 對應）

這些會儲存到 ~/.hermes/migration/openclaw/<timestamp>/archive/ 供手動檢視：

API 金鑰解析

當 --migrate-secrets 啟用時，API 金鑰按優先順序從四個來源收集：

1. 設定值 — openclaw.json 中的 models.providers.*.apiKey 和 TTS 供應商金鑰
2. 環境檔案 — ~/.openclaw/.env（如 OPENROUTER_API_KEY、ANTHROPIC_API_KEY 等金鑰）
3. 設定 env 子物件 — openclaw.json → "env" 或 "env"."vars"（某些設定將金鑰儲存在這裡而非獨立的 .env 檔案）
4. 認證設定檔 — ~/.openclaw/agents/main/agent/auth-profiles.json（每個代理程式的憑證）

設定值優先。每個後續來源填補剩餘的空白。

支援的金鑰目標

OPENROUTER_API_KEY、OPENAI_API_KEY、ANTHROPIC_API_KEY、DEEPSEEK_API_KEY、GEMINI_API_KEY、ZAI_API_KEY、MINIMAX_API_KEY、ELEVENLABS_API_KEY、TELEGRAM_BOT_TOKEN、VOICE_TOOLS_OPENAI_KEY

不在此允許清單中的金鑰不會被複製。

SecretRef 處理

OpenClaw 的代碼和 API 金鑰設定值可以是三種格式之一：

// 純字串
"channels": { "telegram": { "botToken": "123456:ABC-DEF..." } }

// 環境模板
"channels": { "telegram": { "botToken": "${TELEGRAM_BOT_TOKEN}" } }

// SecretRef 物件
"channels": { "telegram": { "botToken": { "source": "env", "id": "TELEGRAM_BOT_TOKEN" } } }

遷移解析所有三種格式。對於環境模板和 source: "env" 的 SecretRef 物件，它在 ~/.openclaw/.env 和 openclaw.json env 子物件中查找值。source: "file" 或 source: "exec" 的 SecretRef 物件無法自動解析 — 遷移會發出警告，這些值必須透過 hermes config set 手動新增到 Hermes。

遷移後

1. 檢查遷移報告 — 完成時列印，包含遷移、跳過和衝突項目的計數。

2. 檢視封存檔案 — ~/.hermes/migration/openclaw/<timestamp>/archive/ 中的任何內容都需要手動處理。

3. 開始新的工作階段 — 匯入的技能和記憶條目在新工作階段中生效，而非當前工作階段。

4. 驗證 API 金鑰 — 執行 hermes status 檢查供應商認證。

5. 測試訊息 — 如果你遷移了平台代碼，重啟閘道：systemctl --user restart hermes-gateway

6. 檢查工作階段策略 — 執行 hermes config show 並驗證 session_reset 值符合你的預期。

7. 重新配對 WhatsApp — WhatsApp 使用 QR 碼配對（Baileys），而非代碼遷移。執行 hermes whatsapp 進行配對。

8. 封存清理 — 確認一切正常後，執行 hermes claw cleanup 將殘留的 OpenClaw 目錄重新命名為 .pre-migration/（防止狀態混淆）。

疑難排解

「OpenClaw directory not found」

遷移檢查 ~/.openclaw/，然後 ~/.clawdbot/，然後 ~/.moltbot/。如果你的安裝在其他地方，使用 --source /path/to/your/openclaw。

「No provider API keys found」

根據你的 OpenClaw 版本，金鑰可能儲存在多個位置：openclaw.json 中 models.providers.*.apiKey 下的內聯值、~/.openclaw/.env 中、openclaw.json 的 "env" 子物件中，或 agents/main/agent/auth-profiles.json 中。遷移檢查所有四個位置。如果金鑰使用 source: "file" 或 source: "exec" SecretRef，它們無法自動解析 — 透過 hermes config set 新增它們。

遷移後技能未出現

匯入的技能存放在 ~/.hermes/skills/openclaw-imports/ 中。開始新的工作階段以使它們生效，或執行 /skills 驗證它們已載入。

TTS 語音未遷移

OpenClaw 在兩個位置儲存 TTS 設定：messages.tts.providers.* 和頂層 talk 設定。遷移檢查兩者。如果你的語音 ID 是透過 OpenClaw UI 設定的（儲存在不同路徑），你可能需要手動設定：hermes config set tts.elevenlabs.voice_id YOUR_VOICE_ID。

---

---

MiniMax OAuth