Welchen KI-Schlüssel du für Hermes Agent verwendest

Kurz gesagt. Hermes Agent bringt kein Modell mit: Er braucht ein Konto bei einem KI-Anbieter. Bei PlayNHost fügst du einen API-Schlüssel von OpenAI, Anthropic, Google Gemini, xAI oder OpenRouter ein, und ein Schlüssel reicht. Hermes Agent erkennt den Anbieter am Schlüssel, und das Modell wählst du im Chat mit /model. Wenn du viele Modelle hinter einem Schlüssel und einer Rechnung willst, nimm OpenRouter. Deine Modellnutzung rechnet dein Anbieter direkt mit dir ab; im Serverpreis ist sie nicht enthalten.

Geprüft am 7. November 2026, gültig für Hermes Agent v0.23.0.

Dieser Leitfaden nutzt die Anbieter- und Konfigurationsdokumentation von Hermes Agent, wo die Dokumentation schweigt seinen Quellcode für v0.23.0 und das PlayNHost-Panel in seinem heutigen Stand.

Die fünf Schlüssel, die das Panel annimmt

Ein API-Schlüssel wird nach Nutzung abgerechnet. Ein Verbraucher-Abo ist nicht dasselbe: Laut Dokumentation von Hermes Agent lässt sich ein Claude-Pro-Tarif nicht über seine Anmeldung nutzen, und die unterstützte Alternative ist ein Anthropic-API-Schlüssel, der pro Token abgerechnet wird.

Welchen du wählst

• Du zahlst schon bei einem Anbieter: Nimm diesen Schlüssel.
• Du willst mehrere Modelle ausprobieren: OpenRouter bündelt viele Anbieter hinter einem Schlüssel und einer Rechnung. Die eigene Dokumentation von Hermes Agent führt es als „für Flexibilität empfohlen“.
• Du denkst an ein kostenloses Kontingent: Die Dokumentation von Hermes Agent warnt, dass ein kostenloser Google-Gemini-Schlüssel schon nach wenigen Agent-Zügen aufgebraucht sein kann, weil eine Nachricht von dir mehrere Modellaufrufe auslösen kann. Andere kleine Gratiskontingente sind aus demselben Grund schnell leer.
• Das Modell braucht einen großen Kontext. Hermes Agent verlangt mindestens 64.000 Token Kontext und lehnt kleinere Fenster beim Start ab. Prüfe das Kontextfenster des Modells, das du wählst, vor allem bei einem kleinen.
• Nicht bei PlayNHost: Nous Portal und andere Anmeldungen (ein Login bei ChatGPT, Claude Max oder SuperGrok) brauchen hermes model oder hermes setup auf einer Kommandozeile, und lokale Modelle (Ollama, LM Studio) brauchen einen Modellserver, den der Tarif nicht enthält. Das Panel nimmt API-Schlüssel.

Den Schlüssel bei PlayNHost hinzufügen

1. Öffne deinen Server unter panel.playnhost.com und dann den Tab Agent.
2. Drücke unter KI-Anbieter („Ein Schlüssel reicht. Jeder Anbieter rechnet über dein eigenes Konto ab, was dein Agent nutzt.“) bei der Zeile deines Anbieters auf Setzen, füge den Schlüssel ein und drücke Speichern. Die Zeile zeigt dann nur die letzten vier Zeichen. Der Schlüssel wird verschlüsselt gespeichert und nie wieder angezeigt; mit Ersetzen und Entfernen änderst du ihn später.
3. Füge ein Telegram- oder Discord-Bot-Token hinzu, falls noch nicht geschehen (Telegram, Discord), und starte den Agent, oder starte ihn neu, wenn er schon läuft: „Änderungen gelten ab dem nächsten Start deines Agents.“

Der Schlüssel erreicht Hermes Agent über seine Umgebung, unter dem Namen aus der Tabelle. Hermes Agent speichert in auth.json einen Fingerabdruck davon, nicht den Schlüssel selbst (das haben wir auf einem Testserver geprüft).

Das Modell im Chat wählen

PlayNHost hat für Hermes Agent kein Modellfeld: Du wählst im Chat, mit dem eigenen Befehl von Hermes Agent.

• Sende /model an deinen Bot. In Telegram öffnet sich eine Auswahl: zuerst die Anbieter, für die du einen Schlüssel hast, dann deren Modelle. Das aktuelle Modell steht oben.
• Wenn du den Namen des Modells kennst, sende /model <name>. Mit --global behältst du es auch für neue Unterhaltungen.
• /model wechselt nur zwischen Anbietern, für die du einen Schlüssel hast. Für einen anderen Anbieter fügst du seinen Schlüssel auf der Seite Agent hinzu und startest neu.

Die Dokumentation von Hermes Agent nennt noch einen Kostenhinweis: Wenn du mitten in einer langen Unterhaltung das Modell wechselst, liest die nächste Nachricht die ganze Unterhaltung zum vollen Preis neu ein, weil der Prompt-Cache des Anbieters zum alten Modell gehört. Wechsle früh oder nach /new.

Mehrere Schlüssel gleichzeitig

Du kannst mehr als einen setzen. Wenn in den Einstellungen von Hermes Agent kein Anbieter gewählt wurde, nimmt sein Code in v0.23.0 zuerst einen OpenRouter-Schlüssel; ohne einen solchen nimmt er den ersten Anbieter mit Schlüssel in seiner eigenen eingebauten Liste. Um Überraschungen zu vermeiden, behalte einen Schlüssel oder wähle den Anbieter mit /model.

Die Rechnung im Griff behalten

• Dein Anbieter rechnet mit dir ab, nicht wir. PlayNHost verkauft keine Modellnutzung weiter und schlägt sie nicht auf deine Rechnung auf; der Tarif bezahlt den Server.
• Lege bei deinem Anbieter ein Ausgabenlimit oder einen Budget-Alarm fest. Hermes Agent kann geplante Jobs selbstständig ausführen, und jeder Lauf nutzt deinen Schlüssel, während du nicht hinsiehst.
• Nebenaufgaben nutzen dein Hauptmodell. Standardmäßig schickt Hermes Agent seine Nebenaufgaben (Kontextkomprimierung, Bilder lesen, Sitzungstitel, die Beurteilung, ob ein Befehl riskant ist) an dein Hauptmodell. Laut seiner Dokumentation verursachen sie bei einem teuren Modell spürbare Kosten.
• Nur du kannst ihm schreiben. Die Nutzer-ID-Listen auf der Seite Agent halten Fremde davon ab, dein Guthaben zu verbrauchen.

Auf deiner eigenen Maschine

Führe hermes model aus, um einen Anbieter und ein Modell zu wählen (es fragt nach dem Schlüssel oder startet die Anmeldung des Anbieters), oder trage den Schlüssel in ~/.hermes/.env ein:

OPENROUTER_API_KEY=sk-or-...

Starte dann das Gateway neu. Siehe Hermes Agent 24/7 betreiben: VPS oder gehostet, oder erstelle einen Server für Hermes Agent und füge deinen Schlüssel im Panel ein.

PlayNHost ist nicht mit Nous Research verbunden. Hermes Agent ist Open-Source-Software unter der MIT-Lizenz.