從 OpenClaw 搬到 Hermes Agent

📅 2026年7月23日適用版本 >=2026.5 ✅ 最後驗證 2026年7月4日 ✍️ HermesAgent.download Contributors

換工具最怕的不是學新介面,是累積的東西搬不過來——你調教了幾個月的 SOUL.md、agent 對你的記憶、自己寫的 skills。

好消息:Hermes 內建了官方的 OpenClaw 遷移指令,這些東西大部分能直接搬¹。

先看它打算搬什麼(不要跳過這步)

hermes claw migrate --dry-run

--dry-run 只報告、不動手¹。它會列出三類項目:可以搬的、搬不動的、以及會被封存的。

為什麼一定要先跑:遷移會動到你的 Hermes 設定。先看清楚清單,等一下結果不如預期時你才知道問題出在哪。

📝 這一段缺實際輸出:--dry-run 的報告長什麼樣、分類怎麼呈現,我們手上沒有實機畫面。幫我們補上。

hermes claw migrate

互動式流程。官方會搬這些¹:

項目	搬到哪
`SOUL.md`、`MEMORY.md`、`USER.md`	轉換成 Hermes 的記憶系統
command allowlist	Hermes 對應設定
`TELEGRAM_ALLOWED_USERS` 等相容的訊息設定	Hermes 對應設定
OpenClaw skills	`~/.hermes/skills/openclaw-imports/`

成功判準:跑完後啟動 hermes,問它一件只有舊環境才知道的事(例如你的專案慣例、你之前告訴過它的偏好)。答得出來,記憶就是搬成功了。

預設不會搬機密。想明確跳過所有 secrets:

hermes claw migrate --preset user-data

要搬的話得明確指定:

hermes claw migrate --migrate-secrets

即使加了這個參數,也只會搬允許清單內的機密——目前是 TELEGRAM_BOT_TOKEN¹。其他 API key 需要你自己重新設定。

這個設計是刻意的:機密跨工具複製是風險行為,官方選擇讓你明確表態。

已經有同名檔案時覆蓋:

hermes claw migrate --overwrite

OpenClaw 不在預設位置(預設會找 ~/.openclaw):

hermes claw migrate --source /custom/path/.openclaw

重新設定 API key——除了 Telegram token,其他機密不會跟著搬。見模型供應商與 API key 設定
檢查 skills 有沒有正常運作——OpenClaw skills 被放進 ~/.hermes/skills/openclaw-imports/,格式相容不代表行為完全一致
有接 Telegram 的話,確認允許名單有搬過來,見 Telegram 常見坑

安裝時若偵測到 OpenClaw 環境,安裝流程通常會提示遷移,不一定要手動執行。

可以。遷移是複製不是移動,~/.openclaw 不會被刪掉。建議先留著,確認 Hermes 一切正常再處理。

官方遷移指令會做格式轉換¹。但兩個系統的記憶模型不同,轉換後的呈現方式可能有差異。

📝 待補實際經驗:轉換後記憶的完整度如何、有沒有明顯遺漏,只有真的搬過的人才知道。歡迎補上。