---
title: "在 Hermes Agent 使用 RunAPI — 自訂 Endpoint 設定指南"
url: "https://runapi.ai/zh-TW/hermes-agent.md"
canonical: "https://runapi.ai/zh-TW/hermes-agent"
locale: "zh-TW"
---

# RunAPI in Hermes Agent

Hermes Agent 可以將自訂的 OpenAI 相容 endpoint 用於聊天模型。把提示詞複製到 Hermes Agent，讓它建立自訂 provider，只有在你需要精確 YAML 時才使用 config 分頁。

## Install prompt

Copy this prompt into Hermes Agent:

```text
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.5.
- 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.
```

## Configuration

```yaml
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.5
```

## Steps

1. **貼上設定提示詞** — 把第一個分頁中的提示詞複製到 Hermes Agent。它會指示 Hermes Agent 讀取 RUNAPI_API_KEY，並將 RunAPI 新增為具名的自訂 provider。
2. **檢查產生的設定** — Hermes Agent 應將 provider 設為 custom:runapi，預設為 gpt-5.2，並將 key_env 指向 RUNAPI_API_KEY。
3. **執行診斷** — 編輯設定後先執行 hermes doctor，然後開啟 Hermes Agent 並送出一段簡短測試提示詞，再用於較大型的任務。

## FAQ

### Hermes Agent 可以把 RunAPI 當作自訂 endpoint 使用嗎？

可以。Hermes Agent 支援模型選擇與自訂 endpoint。請用 RunAPI /v1 base URL 設定具名的自訂 provider，將 API key 保存在 RUNAPI_API_KEY，並選擇像 gpt-5.2 這類 RunAPI 模型。

### 我應該使用 hermes model 還是直接編輯設定檔？

當你想使用引導式選單時，請用 hermes model。當你需要伺服器或共享環境的可重複設定時，請編輯設定檔。無論哪種方式，之後都要用 hermes doctor 驗證。

### Hermes Agent 的 RUNAPI_API_KEY 應該設定在哪裡？

請在啟動 Hermes Agent 的同一個 shell、service unit 或 gateway 環境中設定 RUNAPI_API_KEY。GUI 或 daemon 啟動時，不一定會繼承你的互動式 shell 變數。

### 新增 RunAPI 之後，Hermes Agent 還能使用其他 provider 嗎？

可以。將 RunAPI 新增為 custom:runapi 不會移除其他 Hermes Agent 模型選項。當你想在已設定的模型之間切換時，請使用 hermes model 或 /model 指令。


## Links

- [Model catalog](https://runapi.ai/zh-TW/models)
- [CLI](https://runapi.ai/zh-TW/cli)
- [MCP Server](https://runapi.ai/zh-TW/mcp)
- [Pricing](https://runapi.ai/zh-TW/pricing)
- [API docs](https://runapi.ai/zh-TW/docs)
- [OpenClaw setup](https://runapi.ai/zh-TW/openclaw)