在 Hermes Agent 使用 RunAPI。
Hermes Agent 可使用自訂 OpenAI 相容 endpoint 來處理 chat models。將 prompt 複製到 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以 prompt 在 Hermes Agent 安裝 RunAPI
貼上設定 prompt
將第一個分頁的 prompt 複製到 Hermes Agent。它會指示 Hermes Agent 讀取 RUNAPI_API_KEY，並將 RunAPI 加入為具名的自訂 provider。
Copy prompt
檢視生成的 config
Hermes Agent 應將 provider 設為 custom:runapi，並預設為 gpt-5.2，同時將 key_env 指向 RUNAPI_API_KEY。
provider: custom:runapi
執行診斷
編輯 config 後先執行 hermes doctor，然後開啟 Hermes Agent，送出一個簡短測試 prompt，之後再用於較大型任務。
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 key，而不是硬編碼。 |
api_mode |
chat_completions |
使用 OpenAI 相容的 chat request 格式。 |
Hermes Agent 設定常見問題
可以。Hermes Agent 支援模型選擇和自訂 endpoint。請將具名的自訂 provider 設定為使用 RunAPI /v1 base URL，將 API key 保留在 RUNAPI_API_KEY，並選擇例如 gpt-5.2 的 RunAPI model。
當你想用引導式選擇器時，請使用 hermes model。當你需要可重複套用到 server 或共享環境的設定時，請編輯 config file。無論哪種方式，之後都應以 hermes doctor 驗證。
請在啟動 Hermes Agent 的同一個 shell、service unit 或 gateway 環境中設定 RUNAPI_API_KEY。GUI 或 daemon 啟動方式不一定會繼承你互動式 shell 的變數。
可以。將 RunAPI 加入為 custom:runapi 不會移除其他 Hermes Agent 模型選項。當你要在已設定的模型之間切換時，請使用 hermes model 或 /model 指令。