# Hermes Agent mit OmniaKey einrichten: OpenAI-kompatible API > Verbinden Sie Hermes Agent mit einem benutzerdefinierten OpenAI-kompatiblen OmniaKey-Endpoint. Mit hermes model, config.yaml, Modellwechsel und 404-Fehlerbehebung. - Canonical HTML: https://omniakey.com/de/blog/hermes-setup - Markdown: https://omniakey.com/de/blog/hermes-setup.md - Published: 2026-05-24 (updated 2026-10-30) - Author: Kiki, COO at OmniaKey - Language: de - Category: Guide - Reading time: 4 min - All posts: https://omniakey.com/blog/llms.txt --- Aktualisiert am 30. Oktober 2026: Vier häufige Einrichtungsfehler bei Hermes zeigen jetzt Symptom, Ursache und Lösung, entnommen aus der offiziellen Dokumentation von Hermes Agent. Bei der Suche nach **Hermes Agent API einrichten Anleitung** genügt normalerweise ein benutzerdefinierter OpenAI-kompatibler Endpoint. Hermes Agent von Nous Research kann über die Modell-ID zwischen Claude, GPT, Gemini und Grok wechseln. ## Schnellstart mit `hermes model` ```bash hermes model ``` Wähle **Custom endpoint (self-hosted / VLLM / etc.)** und trage ein: - **Base URL:** `https://api.omniakey.com/v1` - **API key:** dein OmniaKey-Key - **Model:** zum Beispiel `claude-opus-4-8` > Die Base-URL endet bei `/v1`. Hermes ergänzt `/chat/completions`; ein vollständiger Pfad oder ein abschließender Slash führt häufig zu 404. ## Dauerhafte Konfiguration in `config.yaml` Für eine feste Multi-Modell-Konfiguration schreibe dieselben Werte in `~/.hermes/config.yaml`: ```yaml model: provider: custom base_url: https://api.omniakey.com/v1 api_key: your-omniakey-api-key default: claude-opus-4-8 models: - claude-opus-4-8 - gpt-5.5 - gemini-3.1-pro-preview - grok-4.5 ``` `provider: custom` weist Hermes an, den Endpoint direkt zu verwenden. Die Liste `models:` füllt den `/model`-Picker; nach dem Ändern Hermes einmal neu starten, dann wechselst du in der Sitzung zwischen `claude-opus-4-8`, `gpt-5.5`, `gemini-3.1-pro-preview` und `grok-4.5`. ## Ein Key für vier Familien OmniaKey wählt das Modell über die Modell-ID am OpenAI-kompatiblen Endpoint. Ein zweiter Provider-Block ist nicht nötig. Abgerechnet wird pro Token aus einem Prepaid-Guthaben; die gesetzte Modell-ID wird ausgeführt, ohne stillen Fallback auf ein günstigeres Äquivalent. Der [Modellkatalog](https://omniakey.com/de/models) listet jede setzbare ID, und [Preise](https://omniakey.com/de/pricing) zeigt den Tokenpreis je Modell. Derselbe Key funktioniert auch in anderen Agents; siehe die Anleitungen [OpenClaw einrichten](https://omniakey.com/de/blog/openclaw-setup), [Cline mit eigenem API-Key](https://omniakey.com/de/blog/cline-custom-api-key) und [Claude Code einrichten](https://omniakey.com/de/blog/claude-code-setup). - **OpenAI-compatible**: - **Anthropic-native**: - **Gemini-native**: ## Häufige Einrichtungsfehler Diese vier treten oft auf, wenn Hermes auf einen benutzerdefinierten Endpoint zeigt. Ursache und Lösung stammen aus der [Provider-Dokumentation von Hermes](https://hermes-agent.nousresearch.com/docs/integrations/providers) und der [Konfigurationsreferenz](https://hermes-agent.nousresearch.com/docs/user-guide/configuration). ### `/model` bietet den benutzerdefinierten Endpoint nicht an Symptom: du tippst `/model` in einer laufenden Sitzung, und OmniaKey fehlt in der Liste. Ursache: `/model` wechselt in einer Sitzung nur zwischen Providern, die du schon eingerichtet hast. Es kann keinen Provider hinzufügen, kein OAuth starten und keinen API-Key abfragen. Lösung: beende die Sitzung, führe `hermes model` im Terminal aus, richte dort den Endpoint ein und starte eine neue Sitzung. ### Ein Key in `.env` wird ignoriert und Anfragen gehen an einen anderen Provider Symptom: du legst Base-URL oder Key in `~/.hermes/.env` ab, und Hermes ruft weiter einen eingebauten Provider auf. Ursache: `LLM_MODEL` in `.env` wurde entfernt, `config.yaml` ist die einzige Quelle für Modell und Endpoint, und `OPENAI_BASE_URL` gilt nur für den Provider `openai-api`. Lösung: schreibe `base_url` und `api_key` in den Block `model:` in `~/.hermes/config.yaml` oder verweise mit `key_env` auf die Variable, die den Key enthält. Ist `base_url` gesetzt, ruft Hermes diesen Endpoint direkt auf und authentifiziert sich mit `api_key` oder `OPENAI_API_KEY`. ### Hermes startet mit `provider: main` nicht Symptom: der Start schlägt fehl oder die Modellauswahl bleibt leer, nachdem du `provider: main` im obersten Block `model:` gesetzt hast. Ursache: `main` bedeutet „nutze den Provider meines Haupt-Agenten“ und gilt nur in `auxiliary:`, `compression:` oder einem Fallback-Eintrag. Lösung: setze `provider: custom` in `model:`, neben `base_url` und Key von OmniaKey. ### `/model custom` landet beim falschen Modell Symptom: `/model custom` wählt ein Modell, das du nicht wolltest, oder meldet einen Fehler. Ursache: `/model custom` ohne Modellname fragt die `/models`-API des Endpoints und wählt nur dann automatisch, wenn genau ein Modell geladen ist; OmniaKey bietet mehrere. Lösung: nenne das Modell, etwa `/model custom:claude-opus-4-8`. ## Häufige Fragen ### Wie verbinde ich Hermes Agent mit OmniaKey? Führe `hermes model` aus, wähle Custom endpoint (self-hosted / VLLM / etc.) und trage `https://api.omniakey.com/v1` als Base-URL, deinen OmniaKey-Key und eine Modell-ID wie `claude-opus-4-8` ein. Dieselben drei Werte in `~/.hermes/config.yaml` tun es auch, wenn du die Datei lieber selbst bearbeitest. ### Warum liefert Hermes mit meiner OmniaKey-Base-URL einen 404? Die Base-URL muss bei `/v1` enden. Hermes hängt `/chat/completions` selbst an, deshalb ist eine URL mit diesem Pfad oder mit einem abschließenden Slash die übliche Ursache für den 404. ### Reicht ein OmniaKey-Key für Claude, GPT, Gemini und Grok? Ja. OmniaKey wählt das Modell über die ID am OpenAI-kompatiblen Endpoint, ein Endpoint erreicht also alle vier Familien: du änderst die ID, nicht den Provider-Block. Trage die IDs in die Liste `models:` ein, dann erscheinen sie im Picker von `/model`. ### Wie wechsle ich mitten in der Sitzung das Modell? Tippe `/model custom:`, zum Beispiel `/model custom:gpt-5.5`. Starte Hermes nach dem Bearbeiten der Liste `models:` einmal neu, dann sehen Picker und `/model` die neuen IDs. ## Geprüfte Quellen - [Nous Research: LLM- und Modell-Provider](https://hermes-agent.nousresearch.com/docs/integrations/providers) - [Nous Research: Hermes Agent Konfiguration](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) Weitere Tools beschreibt der [Guide für Coding-Agents](https://docs.omniakey.com/en/coding).