在 Hermes Agent 使用 RunAPI。
Hermes Agent 可以將自訂的 OpenAI 相容 endpoint 用於聊天模型。把提示詞複製到 Hermes Agent，讓它建立自訂 provider，只有在你需要精確 YAML 時才使用 config 分頁。
Configure this Hermes Agent install to use RunAPI.
Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a custom provider named runapi.
- Use base_url "https://runapi.ai/v1".
- Use key_env RUNAPI_API_KEY.
- Use api_mode chat_completions.
- Set model.provider to custom:runapi.
- Set the default model to gpt-5.2.
- Run `hermes doctor` and report any config problems before starting a session.
- If RUNAPI_API_KEY is missing, ask me to set it before starting Hermes Agent.custom_providers:
- name: runapi
base_url: "https://runapi.ai/v1"
key_env: RUNAPI_API_KEY
api_mode: chat_completions
model:
provider: custom:runapi
default: gpt-5.2export RUNAPI_API_KEY="runapi_xxx"
hermes model
hermes doctor
hermes用提示詞在 Hermes Agent 中安裝 RunAPI
貼上設定提示詞
把第一個分頁中的提示詞複製到 Hermes Agent。它會指示 Hermes Agent 讀取 RUNAPI_API_KEY，並將 RunAPI 新增為具名的自訂 provider。
Copy prompt
檢查產生的設定
Hermes Agent 應將 provider 設為 custom:runapi，預設為 gpt-5.2，並將 key_env 指向 RUNAPI_API_KEY。
provider: custom:runapi
執行診斷
編輯設定後先執行 hermes doctor，然後開啟 Hermes Agent 並送出一段簡短測試提示詞，再用於較大型的任務。
hermes doctor
設定欄位
| 欄位 | 值 | 用途 |
|---|---|---|
custom_providers.name |
runapi |
建立一個具名的自訂 endpoint，讓 Hermes Agent 可選為 custom:runapi。 |
base_url |
https://runapi.ai/v1 |
將 Hermes Agent 指向 RunAPI 的 OpenAI 相容 API 介面。 |
key_env |
RUNAPI_API_KEY |
從環境變數讀取 RunAPI 金鑰，而不是硬編碼。 |
api_mode |
chat_completions |
使用 OpenAI 相容的聊天請求格式。 |
Hermes Agent 設定常見問題
可以。Hermes Agent 支援模型選擇與自訂 endpoint。請用 RunAPI /v1 base URL 設定具名的自訂 provider，將 API key 保存在 RUNAPI_API_KEY，並選擇像 gpt-5.2 這類 RunAPI 模型。
當你想使用引導式選單時，請用 hermes model。當你需要伺服器或共享環境的可重複設定時，請編輯設定檔。無論哪種方式，之後都要用 hermes doctor 驗證。
請在啟動 Hermes Agent 的同一個 shell、service unit 或 gateway 環境中設定 RUNAPI_API_KEY。GUI 或 daemon 啟動時，不一定會繼承你的互動式 shell 變數。
可以。將 RunAPI 新增為 custom:runapi 不會移除其他 Hermes Agent 模型選項。當你想在已設定的模型之間切換時，請使用 hermes model 或 /model 指令。