Hermes Agent

Hermes Agent über die Option für einen eigenen OpenAI-kompatiblen Endpoint betreiben.

Hermes Agent von Nous Research

Was funktioniert

Hermes nutzt OneProvider über einen eigenen Provider im Modus Chat Completions mit einer kompatiblen Modell-ID, die Sie aus dem Katalog wählen.

Einschränkung des Clients

Lassen Sie API mode auf Chat Completions; andere Provider-Modi von Hermes nutzen diese OpenAI-kompatible Verbindung nicht.

Einrichtung

1. Modelleinrichtung von Hermes öffnen

   Starten Sie den Modell-Assistenten und wählen Sie Custom endpoint (self-hosted / VLLM / etc.).

   hermes model

2. OneProvider-Verbindung eintragen

   Verwenden Sie https://api.oneprovider.dev/v1, Ihren eigenen OneProvider-Schlüssel, eine kompatible Modell-ID aus dem Katalog und Chat Completions als API-Modus.

   Endpoint: https://api.oneprovider.dev/v1
   API key: sk-your-key-here
   Model: gpt-6.1-terra
   Mode: Chat Completions

3. Oder Hermes manuell konfigurieren

   Speichern Sie ONEPROVIDER_API_KEY=… in ~/.hermes/.env und setzen Sie dann den Block model in ~/.hermes/config.yaml.

   # ~/.hermes/.env
   ONEPROVIDER_API_KEY=sk-your-key-here
   # ~/.hermes/config.yaml
   model:
   default: gpt-6.1-terra
   provider: custom
   base_url: https://api.oneprovider.dev/v1
   key_env: ONEPROVIDER_API_KEY

Verbindung prüfen

Neue Hermes-Sitzung starten

Stellen Sie eine kurze Frage und bestätigen Sie dann im OneProvider-Dashboard die konfigurierte Modell-ID, den Token-Verbrauch und den abgebuchten Betrag.

Verbindungsdaten

Protokoll

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Schlüsselsicherheit

Nutzen Sie einen eigenen Inference-Schlüssel, beschränkt auf das benötigte Modell und mit Limits für Rate, Ausgaben und Ablaufdatum. Halten Sie den Schlüssel in ~/.hermes/.env statt in der config.yaml.

Welches Modell wählen

Setzen Sie default im Block model der config.yaml. gpt-6.1-terra ist ein guter Alltagsstandard, gpt-6.1-sol die Frontier-Stufe für schwierige Aufgaben, gpt-5.6-luna ist günstig für schnelle Arbeit oder hohes Volumen. Nutzen Sie Chat Completions als API-Modus und kopieren Sie die IDs von der Modellseite .

Häufige Fehler und Lösungen

401

Der Schlüssel wird nicht gelesen: Prüfen Sie, ob ONEPROVIDER_API_KEY=… in ~/.hermes/.env steht und ob key_env in der config.yaml dieselbe Variable nennt.

404

base_url muss https://api.oneprovider.dev/v1 mit /v1 lauten.

„Model not found“

Die ID steht nicht im Katalog oder hat einen Tippfehler. Kopieren Sie sie von der Modellseite.

429 „Insufficient balance“

Das Guthaben oder das Limit des Schlüssels ist aufgebraucht. Laden Sie das Konto auf.

Der Assistent listet OneProvider nicht auf

Wählen Sie in hermes model den Eintrag Custom endpoint: OneProvider wird als eigener OpenAI-kompatibler Endpoint hinzugefügt.

FAQ

Wo bewahre ich den Schlüssel auf?

In ~/.hermes/.env, nicht in der config.yaml.

Kann ich Claude-Modelle nutzen?

Ja, tragen Sie eine Claude-ID wie claude-sonnet-5-5 im selben eigenen Endpoint ein; die Fähigkeiten hängen vom Modell ab.

Wie prüfe ich, dass es funktioniert?

Starten Sie eine neue Sitzung, stellen Sie eine kurze Frage und suchen Sie die Anfrage unter „Verbrauch“ im Dashboard.

Kurze Antworten

Welche base URL verwende ich?

Claude Code und die Anthropic-SDKs verwenden https://api.oneprovider.dev. OpenAI-SDKs und OpenAI-kompatible Clients verwenden https://api.oneprovider.dev/v1. Ein Schlüssel funktioniert an beiden Adressen; die Modellliste finden Sie auf der Modellseite , die Preise auf der Preisseite .

Wie authentifiziere ich mich?

Senden Sie den unveränderten sk-…-Schlüssel in x-api-key oder Authorization: Bearer: nur eines von beiden, nie beide. Bewahren Sie den Schlüssel in einer Umgebungsvariable auf, nicht in einer Datei, die ins Repository committet wird. Mehr zur Authentifizierung .

Wo bekomme ich einen Schlüssel?

Öffnen Sie Ihr Konto im Telegram-Bot @oneprovider_robot oder auf app.oneprovider.dev, laden Sie das Guthaben auf und tippen Sie auf „Schlüssel ausstellen“. Jeder Schlüssel kann ein eigenes Ausgabenlimit haben. Konto & API-Schlüssel .

Was bedeuten 401, 404 und 429?

401: Der Schlüssel fehlt, ist falsch geschrieben oder steht im falschen Header; fügen Sie den ganzen Schlüssel ohne Anführungszeichen und Leerzeichen ein. 404: meist eine falsche base URL, zum Beispiel ein fehlendes oder doppeltes /v1. 429 mit „Insufficient balance“: Das Guthaben des Kontos oder das Ausgabenlimit des Schlüssels ist aufgebraucht – laden Sie auf, statt es erneut zu versuchen; jedes andere 429 ist ein Rate-Limit, warten Sie dann die Zeit aus Retry-After ab. Details: Fehlercodes und Fehlerbehebung .

Warum brechen Streams ab oder werden zurückgesetzt?

VPN- und VLESS-Proxys puffern SSE oft oder stören die HTTP/2-Aushandlung. OneProvider hat keine regionalen Beschränkungen und puffert keine Streams – schalten Sie den Proxy aus und versuchen Sie es erneut.

Wohin wende ich mich, wenn das nicht reicht?

Schreiben Sie @Oneproviderhelpbot auf Telegram oder öffnen Sie „Support“ im Web-Konto – mit HTTP-Statuscode und genauer Fehlermeldung. So arbeitet der Support .