Skip to main content
Hermes Agent 是由 Nous Research 出品的開源終端 AI Agent，在你的終端中提供強大的工具調用、檔案讀寫和代碼執行能力。透過內建的 Custom Endpoint 能力，Hermes 可以無縫接入任何 OpenAI 兼容 API — 包括 Mixroute，全程無需寫任何代碼或插件。

​
核心功能

智能代理

原生支援工具調用、檔案讀寫和代碼執行，支援後台常駐運行和長期記憶

多渠道整合

透過訊息閘道統一管理 Telegram、Discord、Slack、WhatsApp 等平台

開放模型生態

內建 Custom Endpoint 支援，可接入任何 OpenAI 兼容 API

​
接入前準備

1

準備 Mixroute 地址

獲取一個可用的 Mixroute 地址，例如：https://api.mixroute.ai/v1
如若需要使用原生端口，需要根據 API 手冊中的端點進行設定，建議保持指南中的設定，避免因端點不同導致的錯誤和故障。
2

獲取 API Key

在 Mixroute 控制台生成 API Key
3

選擇模型

確定要使用的模型名稱，需與 Mixroute 控制台中的模型 ID 完全一致（如 gpt-5.5）
Hermes Agent 要求所使用的模型至少支援 64K tokens 的上下文視窗。選擇模型時請確認它滿足此要求，否則可能出現 context 不足的報錯。

​
安裝 Hermes Agent

在終端中運行官方一鍵安裝腳本：
安裝完成後，重新載入終端環境變數：
運行 hermes --version，如果顯示版本號，說明安裝成功。

​
設定 Mixroute 接入

這是整個接入流程中最關鍵的一步。Hermes Agent 提供了互動式選單，用戶無需寫任何代碼或手動編輯設定檔案，只需根據提示填入 Mixroute 的 URL、Key 和模型名即可。
設定完成之後想要更換、或未成功在互動式引導下完成供應商設定，可以 Hermes Agent 部署後隨時運行 hermes model 來覆蓋之前的設定，重新填入新的 URL、Key 或模型名。
1

選擇 Provider

用方向鍵滾動到 Custom Endpoint（或類似的「自定義端點」選項），按回車確認。
多供應商場景建議在平台上配置多個 SK 做區分管理。
2

填寫 Base URL

輸入你的 Mixroute 地址，例如：
這是最常見的配置錯誤來源，需使用模型原生能力，請參考 API 手冊和模型廣場信息，修訂 Base URL。不匹配的端點或會造成 Hermes 無法工作或額外費用。
3

填寫 API Key

輸入你在 Mixroute 控制台生成的 API Key，例如：
4

填寫模型名稱

輸入你想使用的模型，例如：
模型名稱必須與 Mixroute 模型廣場中的 ID 完全一致，否則會報模型不存在的錯誤。
5

選擇 API 的模式

hermes 有下列四種兼容的模式，根據使用的模型進行選擇，Hermes 默認為 Auto-detect。
  1. Auto-detect [current] 使用 Hermes 自動兼容，適用於標準的 OpenAI-compatible 端點。
  2. Chat Completions 使用 /chat/completions 標準的 OpenAI-compatible 端點或服務。
  3. Responses / Codex 使用與 Codex 兼容的端點 /responses。
  4. Anthropic Messages 使用與 Anthropic 端點 /v1/messages。

​
智能路由方式接入（可選）

Smart Routing 是一項智能模型路由能力，能夠根據輸入任務的複雜程度，自動將請求分配至最合適的模型，通過智能分配起到降本增效的作用。參考下列配置項添加供應商資訊即可完成接入，相關約束和指南見此處。

​
關鍵設定說明

​
驗證接入

設定完成後，直接啟動 Hermes 開始對話：
或使用更現代的 TUI 模式（終端圖形界面）：
隨便輸入一條測試訊息，例如：
如果模型正常回覆，說明接入成功。

​
查看和切換模型

在對話中直接輸入以下指令，可以查看當前使用的模型，並快速切換：

​
常見問題

檢查 Base URL 是否以 /v1 結尾
確認模型名稱與 Mixroute 控制台中的模型 ID 完全一致
在 Mixroute 控制台重新生成一個 Key，然後再次運行 hermes model
在終端輸入 hermes model 並回車
重新運行 hermes model，或在對話中輸入 /model
再次運行 hermes model，會覆蓋之前的設定
Hermes 不原生支援 Windows，請先安裝 WSL2，在 WSL2 終端中執行安裝指令
接入 Mixroute 後，所有 Hermes Agent 的後續能力（訊息閘道、技能調用、後台常駐等）都會透過 Mixroute 調用你選擇的模型，無需再為每個功能單獨設定模型提供商。