OpenClaw 搬家到 Hermes Agent 完整教學（官方 hermes claw migrate）

Hermes 官方內建 OpenClaw 遷移指令：hermes claw migrate 會把 ~/.openclaw 的記憶、SOUL.md、command allowlist、skills 與相容設定搬進 Hermes，先用 --dry-run 預覽再執行。

這頁適合誰：正在從 OpenClaw 轉移到 Hermes Agent、想保留既有記憶與自訂內容的使用者。

步驟

先預覽會搬什麼

dry-run 只報告不動手，會列出可搬、不可搬與會封存的項目。
```
hermes claw migrate --dry-run
```
執行互動式完整遷移

官方會搬：SOUL.md、MEMORY.md 與 USER.md（轉成 Hermes 記憶）、command allowlist、TELEGRAM_ALLOWED_USERS 等相容訊息設定、OpenClaw skills（放進 ~/.hermes/skills/openclaw-imports/）。
```
hermes claw migrate
```
不想搬機密就用 preset

user-data preset 會跳過 secrets；帶 --migrate-secrets 才會搬入允許清單內的機密（目前是 TELEGRAM_BOT_TOKEN）。
```
hermes claw migrate --preset user-data
```
衝突與自訂來源

既有檔案衝突可用 --overwrite 覆蓋；OpenClaw 目錄不在預設位置用 --source 指定。
```
hermes claw migrate --overwrite
hermes claw migrate --source /custom/path/.openclaw
```
第一次安裝的人不用手動跑

官方說明：hermes setup 精靈會自動偵測 ~/.openclaw 並在設定前主動詢問是否遷移。
```
hermes setup
```

完成後怎麼驗證

遷移結束會產出結構化報告：搬了什麼、衝突、跳過原因
Hermes 對話中能取用原本 OpenClaw 的記憶內容

常見問題

會不會搬我的 API key？

預設不搬 secrets。帶 --migrate-secrets 只會搬允許清單內的項目，官方目前清單是 TELEGRAM_BOT_TOKEN。

搬不過去的東西會消失嗎？

不會，官方流程會把沒有對應 Hermes 位置的非機密文件封存，並在報告裡列出跳過原因。

OpenClaw 的 skills 能直接用嗎？

會被複製到 ~/.hermes/skills/openclaw-imports/，之後可逐一檢視啟用；不是每個都保證相容。

相關頁