RealRelay.ai
程式碼代理

Hermes Agent 設定指南

把 RealRelay.ai 設為 Nous Research Hermes Agent 的自訂端點:安裝、以 hermes model 或 config.yaml 加入 RealRelay.ai、設定上下文視窗、檢查連線並切換模型。

建立 API 密鑰瀏覽模型目錄
協定
OpenAI Chat Completions
基礎位址
https://www.realrelay.ai/v1
官方文件
github.com
已對照工具官方文件核對
2026-10

概覽

Hermes Agent 是 Nous Research 推出的開源代理,在你自己的電腦上執行。你可以從終端機、它的桌面應用程式或聊天應用程式使用它,而且它會在工作階段之間保留記憶與技能。RealRelay.ai 不是它內建的供應商,所以要把 RealRelay.ai 加為使用 OpenAI Chat Completions API(/v1/chat/completions)的自訂端點。

  • 一組 API 金鑰,在主控台的 API 金鑰頁面取得。

  • 結尾要含 /v1 的基礎位址。Hermes 會在後面加上 /chat/completions。

  • 一個模型 ID,完全依照 GET /v1/models 列出的寫法,例如 z-ai/glm-5.2。請挑選支援工具呼叫的模型。

Hermes 需要至少 64,000 token 的上下文視窗,低於這個值就會拒絕啟動。它通常會從端點的模型清單讀取視窗大小,但 RealRelay.ai 的清單不含這項資訊,所以請依「設定」一節的說明,為每個模型自行設定視窗大小。

安裝

命令列版本請使用 Nous Research 的安裝程式。它會自行準備所需的 Python 與工具;Windows 既可原生執行,也可透過 WSL2 執行。Hermes 網站另提供適用於 Apple Silicon Mac 與 Windows 的桌面應用程式。

macOS · Linux · WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashsource ~/.zshrc   # or: source ~/.bashrc
Windows PowerShell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安裝程式會把 Hermes 放在 %LOCALAPPDATA%\hermes,並加入你使用者的 PATH。執行 hermes 前,請開啟新的 PowerShell 視窗。

安裝程式完成時可能會啟動設定精靈。你可以略過其中的供應商步驟,改依下方「設定」一節操作。

設定

Hermes 把設定存在 config.yaml,把機密存在 .env,兩者都位於 ~/.hermes/;原生 Windows 上則位於 %LOCALAPPDATA%\hermes\。你可以用精靈,也可以直接編輯檔案;兩種方式最後都會寫入 config.yaml。

  1. 1

    啟動精靈

    請在終端機中執行,不要在聊天工作階段內執行,然後選擇 Custom endpoint。

  2. 2

    回答提示問題

    被問到時輸入以下數值。提示文字的措辭可能因版本而異。請使用模型目錄頁面上的實際上下文視窗;這裡顯示的值是安全的下限。

    Terminal
    hermes model
    hermes model → Custom endpoint
    1API base URL:    https://www.realrelay.ai/v12API key:         sk-***3Model name:      z-ai/glm-5.24API mode:        chat_completions5Context length:  200000
  1. 1

    儲存金鑰

    這會把金鑰寫進 Hermes 的 .env 檔案,而不是 config.yaml。

    Terminal
    hermes config set REALRELAY_API_KEY sk-***
  2. 2

    把 RealRelay.ai 加為供應商

    以 hermes config edit 開啟檔案,並合併以下區塊。若已有 model: 區塊,請將其取代。

    ~/.hermes/config.yaml
    1providers:2  realrelay:3    name: RealRelay.ai4    api: https://www.realrelay.ai/v15    key_env: REALRELAY_API_KEY6    transport: chat_completions7    models:8      "z-ai/glm-5.2":9        context_length: 2000001011model:12  default: "z-ai/glm-5.2"13  provider: custom:realrelay

  • api 是基礎位址。key_env 指定存放金鑰的變數名稱;Hermes 會在你的 shell 或它的 .env 檔案中尋找。

  • transport: chat_completions 是自訂端點的預設值。明確寫出來,Hermes 就不會依 URL 去猜測。

  • models.<id>.context_length 是該模型的總視窗大小,輸入與輸出合計。Hermes 依此決定何時壓縮對話。

  • provider: custom:realrelay 讓預設模型指向 realrelay 項目。模型 ID 含有斜線與句點,所以要加上引號。

  • .env 中的 OPENAI_BASE_URL 不會影響自訂端點。Hermes 只會從 config.yaml 讀取 URL。

驗證

  1. 1

    直接呼叫端點

    用你的金鑰執行這段指令。若收到含 choices 陣列的 JSON 回覆,就代表位址、金鑰與模型都沒問題。

    Terminal
    1curl -sS "https://www.realrelay.ai/v1/chat/completions" \2  -H "Authorization: Bearer sk-***" \3  -H "content-type: application/json" \4  -d '{"model": "z-ai/glm-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'
  2. 2

    檢查 Hermes 的設定並送出一則訊息

    hermes doctor 會回報設定問題。hermes config get model 應顯示模型 ID 與 custom:realrelay 供應商。最後一個指令會送出一則訊息後結束。

    Terminal
    hermes doctorhermes config get modelhermes chat -q "Reply with OK"
  3. 3

    啟動工作階段

    執行 hermes。歡迎橫幅會顯示模型與其上下文視窗。第一則訊息收到回覆,即確認整條路徑暢通,而該請求也會出現在主控台的用量日誌中。

模型

在工作階段中,以 /model 加上供應商名稱與模型 ID,即可切換到其他 RealRelay.ai 模型。Hermes 會儲存這個選擇,重新啟動後仍維持選取。

Hermes session
/model custom:realrelay:z-ai/glm-5.2

請為每個要切換的模型,在 models 底下建立各自的項目並設定上下文視窗,以免 Hermes 退回用猜的:

~/.hermes/config.yaml → providers.realrelay.models
1"z-ai/glm-5.2":2  context_length: 2000003"<another-model-id>":4  context_length: 200000

/model 只能在你已設定好的供應商之間切換。要新增供應商,請離開工作階段並執行 hermes model。摘要、讀圖等附帶任務,除非另外設定,否則都使用你的主要模型。適合程式碼代理的模型,列於選擇模型。

疑難排解

  • Hermes 因上下文太小而拒絕啟動。模型的視窗低於 64,000 token,或是 Hermes 找不到視窗大小而用猜的。請為該模型設定 context_length,或改選視窗較大的模型。

  • 401。Hermes 找不到金鑰。請確認 key_env 中的名稱,與你用 hermes config set 儲存的變數相同,且金鑰中沒有空格。

  • 404。基礎位址缺少 /v1。請補上。

  • 找不到模型。模型 ID 與 GET /v1/models 傳回的不完全相同。請保留斜線前的前綴。

  • /model 中沒有 RealRelay.ai。它還沒有設定好。請離開工作階段並執行 hermes model,或檢查 config.yaml 中的 providers 區塊。

  • 切換模型後上下文視窗不正確。最上層的 model.context_length 會在切換時被捨棄。請改把視窗設定放在 providers.realrelay.models 底下,每個模型一個項目。

  • .env 中的設定似乎被忽略。Hermes 只會從 config.yaml 讀取模型與 URL。.env 是用來放金鑰的。