Tutorial Migration

從 OpenClaw 遷到 Hermes Agent:一份步驟化的實操指南

Hermes Agent

Hermes Agent

@hermesagents

May 19, 2026

8 分鐘閱讀

你之前一直在跑 OpenClaw 的話,Hermes Agent 是它的繼任者。專案血統是一脈的,維護者也是同一批人,只是改了名又重新設計了一遍。Hermes 的安裝器是認得出這件事的——v0.14.0 自帶一條一等公民的 hermes claw migrate 指令,一把把你已有的 OpenClaw 狀態全搬過來,支援 dry-run,也有現成的 preset。

這篇是實操指南:會遷什麼、有哪些 flag、以及「先 dry-run 一遍」那條不會翻車的流程。

1. 裝 Hermes Agent

Hermes 的安裝精靈會自動識別 ~/.openclaw,在開始設定之前先問你要不要遷。最快的一條路:

bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup

精靈發現你的 OpenClaw 主目錄之後會問你要不要遷。說 yes 就行——但要是你想先確切看到它要遷哪些東西,先退出精靈,直接跑 migrate 指令。

2. 用 --dry-run 預覽一遍

這一步永遠先跑。它會把遷移器準備要匯入的東西全列一遍,但不寫盤:

bash
hermes claw migrate --dry-run

輸出按類別分組——SOUL.md、memories、skills、白名單、聊天平台設定、API key、TTS 資源。讀一遍。如果看著有不對的(一個你不想遷過來的舊 API key、一份你已經不想再用的人格檔案),跳過對應那一段——用 preset 來跳。

3. 挑一個 preset

預設帶兩個 preset:

  • full(預設)——什麼都遷,包括 secret
  • user-data——除了 API key 別的都遷;secret 你自己手動重填

要換台機器、想跟舊 secret 乾乾淨淨分家?用 user-data

bash
hermes claw migrate --preset user-data

同一台機器升級、想保持連續性?

bash
hermes claw migrate

4. 具體遷什麼

照 README 那份對照表:

OpenClawHermes 這邊的目的地
SOUL.md(人格)原樣匯入
MEMORY.mdUSER.md 裡的條目進 Hermes memory
你自己寫的 skill複製到 ~/.hermes/skills/openclaw-imports/
指令白名單(審批模式)匯入
聊天設定(平台設定、放行使用者、工作目錄)匯入
API key(Telegram、OpenRouter、OpenAI、Anthropic、ElevenLabs)preset full 下匯入
TTS 資源(工作區音訊檔案)匯入
工作區 AGENTS.md--workspace-target 匯入

agentskills.io 上來的 skill 會自動重裝——Hermes 的假設是你會重新去 hub 上挑一遍,透過 hermes skills 裝你真想要的。這是故意的:OpenClaw → Hermes 這次改名順帶把 skills hub 也重做了一遍(v0.14.0 把 huggingface/skills 提到了信任預設源),重新挑一遍比一鍋端過來乾淨。

5. 處理衝突

如果 Hermes 在這台機器上已經有設定了(比如你忘了 OpenClaw 還在,先跑過 hermes setup),migrate 指令預設拒絕覆蓋。兩條出路:

  • --overwrite——拿 OpenClaw 的值把 Hermes 已有的設定蓋掉
  • 跳過衝突那一類——衝突在 secret 上的話用 --preset user-data

--overwrite 只在 --dry-run 已經確認過 OpenClaw 那邊的值確實是你想要的之後才用。

6. 驗一下

bash
hermes doctor

它會跑裝好之後的健康檢查。memories、skills、白名單、平台設定如果有哪裡不到位,doctor 會給你具體報錯。改完,重跑,往下走。

備選方案:讓 agent 帶你走一遍

不想碰 CLI flag 的話,Hermes 自帶一個 openclaw-migration skill:

bash
hermes
> /openclaw-migration

這個 skill 會以互動的方式帶你過同一套遷移流程,每一步都先 --dry-run 預覽。

常見問題

OpenClaw 的資料會丟嗎? 不會。遷移器是複製,不是移動。你的 ~/.openclaw 完整保留。萬一出問題,刪掉 ~/.hermes 就能回退,繼續用 OpenClaw。

兩個能一起跑嗎? 短期可以。它們對 HOME 的假設有重疊,不應該讓兩邊同時擁有同一份 memory。要長期雙開,社群那個 HermesClaw 橋接專門處理同一個微信帳號上 OpenClaw 和 Hermes 共存。

我的 skill 會壞嗎? 你自己寫的 skill 會被複製到 ~/.hermes/skills/openclaw-imports/,搬過去之後還能用。來自 agentskills.io 的 skill 是綁在 hub 上的、不是綁在你本地裝的——透過 hermes skills 重新裝一下。

出問題去哪求助?hermes doctor。然後是 Nous Research Discord 或者 GitHub Issues——README 裡都有連結。

延伸閱讀

訂閱更新

Hermes Agent 社群的第一手消息——新版本、新 skill、新整合。不寄垃圾信,隨時可以退訂。