Hermes Agent mit OmniaKey einrichten: OpenAI-kompatible API

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

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

Dauerhafte Konfiguration in config.yaml

Für eine feste Multi-Modell-Konfiguration schreibe dieselben Werte in ~/.hermes/config.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 listet jede setzbare ID, und Preise zeigt den Tokenpreis je Modell. Derselbe Key funktioniert auch in anderen Agents; siehe die Anleitungen OpenClaw einrichten, Cline mit eigenem API-Key und Claude Code einrichten.

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 und der Konfigurationsreferenz.

/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:<modell-id>, 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
• Nous Research: Hermes Agent Konfiguration

Weitere Tools beschreibt der Guide für Coding-Agents.