Hermes Agent

透過互動式自訂端點設定，將 Hermes Agent 接入 CoffeeRouter。

接入前準備

  • 在 CoffeeRouter 控制台建立可用令牌，並確認令牌允許使用目標聊天模型。
  • 記下模型 ID；Hermes 要求所選模型至少支援 64K 上下文。
  • 準備 CoffeeRouter API 地址 https://www.coffeerouter.ai/v1。

設定步驟

1. 安裝 Hermes Agent

macOS、Linux、WSL2 或 Termux 使用官方安裝腳本：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows PowerShell 可以原生安裝：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

依照安裝器提示重新開啟終端，或重新載入 Shell 設定，然後檢查版本：

hermes --version

2. 新增 CoffeeRouter 自訂端點

執行模型設定精靈：

hermes model

選擇 Custom endpoint (self-hosted / VLLM / etc.)，然後填寫：

設定項填寫內容
API Base URLhttps://www.coffeerouter.ai/v1
API Keysk-your-api-key
ModelCoffeeRouter 中顯示的模型 ID

3. 檢查或手動編輯設定

精靈會儲存 Hermes 設定。如需檢查，可開啟 ~/.hermes/config.yaml，核心內容如下：

model:
    default: your-model-id
    provider: custom
    base_url: https://www.coffeerouter.ai/v1
    api_key: sk-your-api-key

模型 ID 必須與 CoffeeRouter 令牌可用模型清單中的名稱完全一致。建議優先使用 hermes model 精靈，避免破壞檔案中的其他設定。

驗證接入

啟動 Hermes 並傳送一則測試訊息：

hermes

也可以啟動終端介面：

hermes --tui

若能正常收到回覆，且 /model 顯示剛設定的模型，即表示接入成功。

常見問題

為什麼模型設定後無法使用？

請確認模型 ID 與 CoffeeRouter 顯示的名稱一致，並確認該模型至少支援 64K 上下文。Hermes 會拒絕上下文視窗過小的模型。

為什麼請求回傳 401？

請重新複製完整令牌，確認令牌已啟用、未過期且仍有額度。請勿在 API Key 前後加入空格或引號。

Windows 是否必須使用 WSL2？

不必須。Hermes 目前提供原生 PowerShell 安裝腳本；如需 Linux 環境，也可以選擇 WSL2。

為什麼 Base URL 要帶 /v1？

Hermes 的自訂端點需要填寫 OpenAI 相容 API 基礎地址，CoffeeRouter 對應地址為 https://www.coffeerouter.ai/v1。

安全提示

CoffeeRouter 令牌等同於帳戶呼叫憑證。請勿分享設定檔、終端截圖或包含令牌的日誌；建議為 Hermes 單獨建立令牌，以便獨立限制模型、額度和 IP，並在裝置遺失或停用時及時撤銷。

官方資料