---
title: "RunAPI in Hermes Agent nutzen - Anleitung für eigene Endpoints"
url: "https://runapi.ai/de/hermes-agent.md"
canonical: "https://runapi.ai/de/hermes-agent"
locale: "de"
---

# RunAPI in Hermes Agent

Hermes Agent kann einen eigenen OpenAI-kompatiblen Endpoint für Chat-Modelle nutzen. Kopiere den Prompt in Hermes Agent, lasse den Custom Provider anlegen und nutze den Config-Tab nur, wenn du das exakte YAML brauchst.

## 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. **Setup-Prompt einfügen** — Kopiere den Prompt aus dem ersten Tab in Hermes Agent. Er weist Hermes Agent an, RUNAPI_API_KEY zu lesen und RunAPI als benannten Custom Provider hinzuzufügen.
2. **Generierte Konfiguration prüfen** — Hermes Agent sollte provider auf custom:runapi setzen, standardmäßig gpt-5.2 verwenden und key_env auf RUNAPI_API_KEY zeigen lassen.
3. **Diagnose ausführen** — Führe nach der Konfigurationsänderung hermes doctor aus, öffne dann Hermes Agent und sende einen kurzen Test-Prompt, bevor du es für größere Aufgaben nutzt.

## FAQ

### Kann Hermes Agent RunAPI als Custom Endpoint nutzen?

Ja. Hermes Agent unterstützt Modellauswahl und Custom Endpoints. Konfiguriere den benannten Custom Provider mit der RunAPI /v1 Base URL, halte den API Key in RUNAPI_API_KEY und wähle ein RunAPI-Modell wie gpt-5.2.

### Soll ich hermes model nutzen oder die Konfigurationsdatei bearbeiten?

Nutze hermes model, wenn du den geführten Picker willst. Bearbeite die Konfigurationsdatei, wenn du ein wiederholbares Setup für Server oder geteilte Umgebungen brauchst. Prüfe danach in beiden Fällen mit hermes doctor.

### Wo sollte RUNAPI_API_KEY für Hermes Agent gesetzt werden?

Setze RUNAPI_API_KEY in derselben Shell, Service Unit oder Gateway-Umgebung, die Hermes Agent startet. GUI- oder Daemon-Starts übernehmen Variablen aus deiner interaktiven Shell nicht immer.

### Kann Hermes Agent nach dem Hinzufügen von RunAPI weiter andere Provider nutzen?

Ja. RunAPI als custom:runapi hinzuzufügen entfernt keine anderen Hermes-Agent-Modelloptionen. Nutze hermes model oder den /model Befehl, wenn du zwischen konfigurierten Modellen wechseln willst.


## Links

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