實戰：從 OpenClaw 遷移過來

這篇教學將手把手教你如何把 OpenClaw（或舊版 Clawdbot/Moldbot）的設定、記憶、技能和聊天平台設定，一鍵遷移到 Hermes Agent，就像搬家時請了個專業搬家公司，幫你把傢俱、書本和雜物分門別類地打包好。

---

第1步：先看看要搬什麼（預覽）

遷移前，Hermes 會先給你看一份「搬家清單」，列出所有將被匯入的內容，確認無誤後才動手。執行以下指令：

# 預覽並遷移（先顯示清單，再詢問是否繼續）
hermes claw migrate

# 只預覽，不做任何更改
hermes claw migrate --dry-run

小貼士：如果你之前用的是 Claude Code 或 OpenAI Codex CLI，請改用 hermes import-agent 指令。

---

第2步：選擇搬家方式（預設）

Hermes 提供兩種「搬家套餐」：

• full：遷移所有相容設定（但不含 API 金鑰）
• user-data：只遷移個人資料，跳過基礎設施設定

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

注意：無論選哪個套餐，預設都不會匯入 API 金鑰。需要明確加上 --migrate-secrets 參數，就像搬家時特別叮嚀「別忘了保險櫃裡的鑰匙」。

---

第3步：檢查關鍵設定的「新家」

遷移後，你的設定會對應到 Hermes 的新位置。以下是幾個重要對照：

原 OpenClaw 設定	Hermes 新位置	說明
workspace/SOUL.md（人設）	~/.hermes/SOUL.md	直接複製
workspace/MEMORY.md（長期記憶）	~/.hermes/memories/MEMORY.md	自動解析、去重、合併
agents.defaults.model（預設模型）	config.yaml 的 model 欄位	支援字串或 {primary, fallbacks} 物件
agents.defaults.timeoutSeconds	agent.max_turns	除以 10，上限 200
mcp.servers.*（MCP 伺服器）	mcp_servers.*	欄位一一對應

技能檔案（相當於你的「工具箱」）會統一搬到 ~/.hermes/skills/openclaw-imports/。如果新舊技能重名，可用 --skill-conflict 參數選擇：skip（保留舊的）、overwrite（覆蓋）、rename（重新命名加 -imported 後綴）。

---

第4步：遷移聊天平台（Telegram/Discord 等）

你的聊天機器人帳號（Telegram、Discord、Slack 等）的令牌和允許使用者清單，會寫入 Hermes 的 .env 檔案。例如：

• Telegram 機器人令牌 → TELEGRAM_BOT_TOKEN
• Discord 令牌 → DISCORD_BOT_TOKEN
• 允許的使用者清單 → TELEGRAM_ALLOWED_USERS（逗號分隔）

注意：這些令牌屬於敏感資訊，同樣需要 --migrate-secrets 參數才會遷移。

---

第5步：遷移後檢查

遷移完成後，建議檢查以下幾點：

1. 人設和記憶：確認 ~/.hermes/SOUL.md 和 ~/.hermes/memories/MEMORY.md 內容完整
2. 模型設定：開啟 ~/.hermes/config.yaml，確認模型、推理強度、壓縮等設定正確
3. 技能檔案：查看 ~/.hermes/skills/openclaw-imports/ 是否包含所有技能
4. 聊天平台：檢查 .env 中的令牌是否正確

小提示：遷移前 Hermes 會自動備份目前設定（~/.hermes/backups/pre-migration-*.zip），萬一出錯可用 hermes import 還原。

---

總結

從 OpenClaw 遷移到 Hermes 就像換新家：先看清單（預覽）、選套餐（預設）、搬傢俱（設定對應）、裝鑰匙（API 金鑰）、最後檢查水電（驗證）。整個過程安全可逆，預設不碰你的 API 金鑰，技能衝突也有三種處理方式。

下篇預告：遷移完成後，如何用 Hermes 的 Nous Portal 一個登入搞定 300+ 模型？下一篇我們聊聊「多模型自由切換」的實戰技巧。

---