Hermes Agent 模型供應商與 API key 設定教學

Hermes Agent 支援任何 OpenAI 相容 API：輸入 hermes model 進互動式選單選供應商並填 API key；要用本地模型就選 Custom endpoint 填 Ollama 位址。

這頁適合誰：剛裝好 Hermes、卡在「要選哪個模型供應商」與「API key 怎麼填」的人。

步驟

  1. 打開供應商選單

    官方支援 OpenRouter、OpenAI、Anthropic Claude、Google Gemini，以及 Ollama / vLLM 等本地模型。

    hermes model

  2. 或用官方 Portal

    hermes setup --portal 可透過 Nous Portal 使用 300+ 模型。

    hermes setup --portal

  3. 直接設定 key（進階）

    也可以用 config 指令直接寫入。

    hermes config set OPENROUTER_API_KEY your_key

  4. 本地模型（Ollama 範例）

    跑 hermes model 選 Custom endpoint，填入本地位址，並把 context length 設成伺服器實際能力。

    http://localhost:11434/v1

  5. 指定特定模型

    hermes config set HERMES_MODEL anthropic/claude-opus-4.7

完成後怎麼驗證

常見問題

API key 填了還是報錯？

官方 FAQ：先 hermes config show 確認設定，再跑 hermes model 重新設定。注意 key 要對應供應商：OpenAI 的 key 不能用在 OpenRouter。

跑 Hermes 到底要花多少錢？

Hermes Agent 本體免費開源（MIT），你只付所選供應商的 LLM API 費用。社群實測換供應商可以差一個數量級（見高手經驗頁的成本案例）。

可以讓子代理用便宜模型嗎？

可以，官方 FAQ：在 config.yaml 的 delegation 區塊設定，例如 model: google/gemini-3-flash-preview 配 provider: openrouter，subagent 會自動用該模型。

出現 context length exceeded？

用 /compress 壓縮 session，用 /usage 看用量；也可在 config.yaml 的 model.context_length 明確設定（如 131072）。

相關頁