你之前一直在跑 OpenClaw 的話,Hermes Agent 是它的繼任者。專案血統是一脈的,維護者也是同一批人,只是改了名又重新設計了一遍。Hermes 的安裝器是認得出這件事的——v0.14.0 自帶一條一等公民的 hermes claw migrate 指令,一把把你已有的 OpenClaw 狀態全搬過來,支援 dry-run,也有現成的 preset。
這篇是實操指南:會遷什麼、有哪些 flag、以及「先 dry-run 一遍」那條不會翻車的流程。
1. 裝 Hermes Agent
Hermes 的安裝精靈會自動識別 ~/.openclaw,在開始設定之前先問你要不要遷。最快的一條路:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup
精靈發現你的 OpenClaw 主目錄之後會問你要不要遷。說 yes 就行——但要是你想先確切看到它要遷哪些東西,先退出精靈,直接跑 migrate 指令。
2. 用 --dry-run 預覽一遍
這一步永遠先跑。它會把遷移器準備要匯入的東西全列一遍,但不寫盤:
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:
hermes claw migrate --preset user-data
同一台機器升級、想保持連續性?
hermes claw migrate
4. 具體遷什麼
照 README 那份對照表:
| OpenClaw | Hermes 這邊的目的地 |
|---|---|
SOUL.md(人格) | 原樣匯入 |
MEMORY.md 和 USER.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. 驗一下
hermes doctor
它會跑裝好之後的健康檢查。memories、skills、白名單、平台設定如果有哪裡不到位,doctor 會給你具體報錯。改完,重跑,往下走。
備選方案:讓 agent 帶你走一遍
不想碰 CLI flag 的話,Hermes 自帶一個 openclaw-migration skill:
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 裡都有連結。