第五章：設定檔解剖 — config.yaml、custom_providers.yaml、環境變數優先序

歡迎來到 Hermes Agent 的「更衣室」！如果你覺得預設的管家有點不太對你的胃口，別擔心，我們這裡備有各式各樣的衣服與裝備（設定檔），保證能把它打造成你心目中的完美模樣。😎

要掌控 Hermes，你必須學會和它的設定檔打交道。這聽起來有點宅，但相信我，一旦你掌握了這些設定，你的管家就會像穿上鋼鐵衣一樣戰鬥力爆表！

📂 三大設定法寶

Hermes 的設定系統非常貼心，主要依賴以下幾個關鍵元件：

這是 Hermes 的核心設定檔。你可以在這裡設定預設使用的模型、工具箱要開啟哪些功能、以及記憶庫的存放位置。就像是寫給管家的工作守則。

除了預設的模型供應商，如果你想外接一些奇奇怪怪、或是你自己架設的神祕模型（例如公司內部專用的 LLM），都可以在這個檔案裡設定。這就是你的私人軍火庫！

萬一你不想動設定檔，或者你想臨時改變主意怎麼辦？環境變數就是你的免死金牌！它的優先權最高。如果在環境變數裡設定了某個值，Hermes 會毫不猶豫地忽略設定檔裡的內容，直接聽環境變數的。這很適合用來存放不能寫在檔案裡的機密資訊（例如 API Key）。

💡 誰是老大？（優先序規則） 記住這個鐵律：指令列參數 > 環境變數 > yaml 設定檔 > 系統預設值。管家會先聽你當下直接下達的命令（指令參數），再看你的環境變數，最後才去翻那本厚厚的設定檔。

光說不練假把戲，我們來實際操作一下這些設定指令吧！這能幫你快速管理那些看似複雜的設定檔。

介紹指令：hermes config 相關操作

練習 1：偷看目前的總設定 想知道管家現在腦袋裡裝了什麼設定嗎？輸入以下指令把它全部印出來看看：

hermes config view

幽默小提示：跑出來的東西可能會像天書一樣長，別害怕！大部分時間你只需要關心 default_model 和 providers 這幾行就好。

練習 2：動手修改設定檔 覺得用文字編輯器找檔案太麻煩？你可以直接叫 Hermes 幫你打開設定檔：

hermes config edit

這個指令會自動用你系統預設的編輯器（比如 VS Code 或 Vim）打開 config.yaml。小心別把格式改壞啦，YAML 對縮排可是很嚴格的，多一個空白少一個空白它都會跟你生氣喔！

練習 3：透過環境變數臨時餵鑰匙 這是一個進階小技巧。假設你不想把 API Key 寫進檔案裡，只想這一次臨時使用，你可以用環境變數搭配指令：

OPENAI_API_KEY="sk-你的超機密鑰匙" hermes chat --model "openai/gpt-4o"

看！你不留痕跡地給了管家鑰匙，而且只要關掉終端機，這把鑰匙就會隨風飄散，超級安全！這就是環境變數的魔力！

太棒了！你現在已經掌握了改裝 Hermes Agent 的核心技術。下一章，我們將會面臨每個工程師都逃不掉的宿命——除錯！別怕，我們為你準備了《驗證安裝與常見錯誤》求生指南。我們第六章見！🛡️