配置文件——让 Hermes 按你的喜好工作

設定檔——讓 Hermes 照你的喜好運作

嘿，朋友們！上一篇我們聊了聊怎麼讓 Hermes 記住你和你的專案。今天咱們來點更硬核的——設定檔。別怕，這玩意兒其實就是 Hermes 的「遙控器」，你按哪個鍵，它就做哪件事。

一切都在 `~/.hermes/` 裡

Hermes 把所有家當都放在 ~/.hermes/ 目錄下，一目了然：

~/.hermes/
├── config.yaml     # 主設定（模型、終端、TTS、壓縮等）
├── .env            # API 金鑰和機密資訊
├── auth.json       # OAuth 憑證（Nous Portal 等）
├── SOUL.md         # 智慧體人格（系統提示詞第 1 位）
├── memories/       # 長期記憶
├── skills/         # 智慧體技能
├── cron/           # 定時任務
├── sessions/       # 閘道工作階段
└── logs/           # 日誌（金鑰自動打碼）

偷懶神器：`hermes setup --portal`

不想手改 YAML？直接跑一句：

hermes setup --portal

一次 OAuth 登入，模型供應商和四個 Tool Gateway 工具全搞定。Portal 訂閱用戶還能享受 token 計費 10% 折扣，真香！

設定指令速查

hermes config              # 檢視目前設定
hermes config edit         # 用編輯器開啟 config.yaml
hermes config get model    # 檢視某個設定值
hermes config set model anthropic/claude-opus-4  # 設定模型
hermes config set terminal.backend docker        # 設定終端後端
hermes config unset terminal.backend             # 刪除某個設定
hermes config check        # 檢查缺少的設定（更新後）
hermes config migrate      # 互動式補齊缺少的設定

小技巧：hermes config set 會自動把值寫到正確的檔案——API 金鑰進 .env，其他都進 config.yaml。比如 hermes config set OPENROUTER_API_KEY sk-or-... 就直接存到 .env 了。

設定優先順序

Hermes 按這個順序解析設定（從上到下優先順序遞減）：

命令列參數——比如 hermes chat --model anthropic/claude-sonnet-4
~/.hermes/config.yaml——主設定檔
~/.hermes/.env——環境變數兜底，金鑰必須放這裡
內建預設值——啥都沒設時的安全預設

黃金法則：金鑰（API key、token、密碼）放 .env，其他（模型、終端後端、壓縮設定）放 config.yaml。兩邊都設了的話，config.yaml 說了算。

環境變數替換

你可以在 config.yaml 裡用 ${VAR_NAME} 引用環境變數：

auxiliary:
  vision:
    api_key: ${GOOGLE_API_KEY}
    base_url: ${CUSTOM_VISION_URL}

也支援 ${env:VAR_NAME} 這種 Cursor 風格寫法，從 Cursor 或 Claude 設定裡複製過來的 MCP 片段能直接用。注意：${file:...}、${vault:...} 這些外部金鑰後端不會內聯解析，得用 ${env:NAME} 引用。

更新行為

hermes update 的設定放在 config.yaml 的 updates 區塊裡：

updates:
  pre_update_backup: quick   # 更新前備份策略

小結

設定檔就是 Hermes 的「遙控器」，掌握這幾個指令，你就能隨心所欲地調教它了。記住：金鑰進 .env，其他進 config.yaml，命令列參數臨時覆蓋，內建預設值兜底。下一篇咱們聊聊更高階的玩法，敬請期待！