Hermes Agent antwortet nicht

Ein Test, der das Problem halbiert

Öffne das Hermes Dashboard und frage den Agent etwas Triviales, das keine Tools braucht. Was dann passiert, teilt die fünf Ursachen in zwei Gruppen und erspart dir, die falsche Hälfte zu debuggen.

• Du bekommst eine Antwort. Die Instanz läuft und der Modellanbieter nimmt Anfragen an. Dein Problem liegt beim Tool-Calling oder in der konkreten Aufgabe, nicht im Setup.
• Du bekommst einen Fehler. Der Anbieter lehnt dich ab: wegen eines ungültigen Schlüssels, eines leeren Guthabens, eines Rate-Limits oder eines eingestellten Modellnamens.
• Es passiert gar nichts, oder die Seite lädt nicht. Entweder ist die Instanz down oder dein Weg zu ihr. Das sind verschiedene Fehler mit verschiedenen Lösungen, die unten behandelt werden.

Läuft die Instanz überhaupt?

Prüfe die Instanz in deinem Flux Dashboard, statt nach der Agent-Oberfläche zu urteilen, denn ein Container in einer Neustartschleife wirkt zeitweise lebendig. Die üblichen Ursachen sind der Speicher und eine lang laufende Aufgabe, die nie beendet wurde.

Der Speicher ist das Erste, was du prüfen solltest, wenn du über leichte Nutzung hinausgewachsen bist. Die Stufe mit 4 GB ist bequem für einen persönlichen Agent mit geplanter und Ad-hoc-Arbeit, aber Gleichzeitigkeit verbraucht RAM: mehrere Aufgaben auf einmal, ein langer mehrstufiger Recherche-Lauf mit großer Arbeitsmenge oder eine Aufgabe, die Dateien herunterlädt und verarbeitet. Wenn sich deine Nutzung verändert hat und der Agent anfing abzustürzen, zeigt dir die Stufe mit 8 GB, dass sie gebraucht wird, und es ist kein Defekt.

Ein verwandtes Muster ist ein Agent, der hängt, statt abzustürzen. Eine Agent-Schleife, die auf ein Tool wartet, das nie zurückkehrt, etwa ein Netzwerkaufruf an einen ausgefallenen Dienst, bleibt unbegrenzt stehen und sieht genauso aus wie ein toter Agent. Ein Neustart der Instanz behebt das, und der Ausführungsverlauf zeigt meist, bei welchem Schritt er stehen geblieben ist.

Der Anbieter-Schlüssel, das Guthaben und der Modellname

Hermes ist Bring-your-own-key, daher entsteht die häufigste Stille bei deinem KI-Anbieter und nicht im Agent. Vier Fehler führen zum selben Symptom, und alle vier behebst du auf Anbieterseite:

Füge den Schlüssel neu ein, statt ihn nur anzusehen und für korrekt zu halten. Ein Leerzeichen am Ende übersteht die Sichtprüfung und lässt jede Anfrage fehlschlagen.

Rate-Limits treffen Agents härter als Chatbots

Das verdient einen eigenen Abschnitt, denn Agents stoßen ungewöhnlich oft an Limits. Ein Chat-Assistent stellt eine Anfrage pro Nachricht eines Menschen. Ein Agent stellt eine Anfrage pro Schritt seiner Denkschleife, und eine mehrstufige Aufgabe kann in einer Minute Dutzende Aufrufe erzeugen, ohne dass du irgendetwas tust.

OpenRouter ist eine gängige Wahl für Hermes, und sein kostenloser Tarif macht den Effekt greifbar. Kostenlose Modellvarianten, deren Kennung auf :free endet, sind auf 20 Anfragen pro Minute begrenzt, und das Tageskontingent beträgt 50 Anfragen, wenn du in der gesamten Lebensdauer des Kontos weniger als $10 an Guthaben gekauft hast, und steigt auf 1000 pro Tag, sobald du es getan hast. Ein Agent, der eine Recherche abarbeitet, kann 50 tägliche Anfragen in einem einzigen Lauf aufbrauchen, woraufhin er mitten in der Aufgabe ohne erkennbaren Grund stehen bleibt.

Wenn dein Agent kurze Aufgaben abschließt und lange durchgehend nicht überlebt, ist das mit ziemlicher Sicherheit der Grund. Die Lösung ist entweder eine kostenpflichtige Modellvariante oder die Grenze zu akzeptieren und Aufgaben klein zu halten. Eine einmalige Aufladung hebt die Tagesuntergrenze an, aber nicht das Limit pro Minute, sodass eine sehr gesprächige Schleife trotzdem 20 pro Minute erreichen kann, egal wie viel du ausgegeben hast.

Der Agent redet, handelt aber nie

Diesen Fehler diagnostiziert kaum jemand richtig, weil nichts eine Fehlermeldung zeigt. Der Agent antwortet flüssig, beschreibt, was er tun wird, und tut es dann einfach nicht. Kein Tool läuft, keine Datei erscheint, außerhalb der Unterhaltung passiert nichts.

Die Ursache ist das Modell. Ein Agent arbeitet, indem er das Modell einen strukturierten Tool-Aufruf ausgeben lässt, und nicht jedes Modell unterstützt das. Richtest du Hermes auf ein Modell ohne Tool-Calling, bekommst du einen kompetenten Gesprächspartner, dem stillschweigend die Fähigkeit zu handeln genommen wurde. Er ist nicht kaputt; er hat nur keine Hände.

Prüfe, ob das gewählte Modell Tool- oder Function-Calling unter seinen Fähigkeiten aufführt, und bevorzuge ein Modell, das der Anbieter ausdrücklich für den Agent-Einsatz dokumentiert. Deshalb ist das billigste verfügbare Modell für einen Agent oft eine falsche Ersparnis: Die Fähigkeit, ein Tool-Calling-Protokoll zuverlässig zu befolgen, zählt weit mehr als der reine Preis pro Token, wenn der ganze Zweck darin besteht, dass der Agent etwas ausführt.

Eine mildere Variante desselben Problems ist ein Modell, das Tool-Calling unterstützt, aber unzuverlässig umsetzt und fehlerhafte Aufrufe erzeugt, die still scheitern und wiederholt werden. Wenn dein Agent nur halb funktioniert und der Ausführungsverlauf voller wiederholter Versuche beim selben Schritt ist, probiere ein stärkeres Modell, bevor du die Aufgabe als Ursache annimmst.

Wenn der Agent in Ordnung ist und du ihn nicht erreichst

Hermes wird mit einem Tailscale-Mesh ausgeliefert, damit der Agent dein privates Netzwerk erreicht, und viele nutzen dasselbe Mesh auch, um das Dashboard zu erreichen. Dadurch entsteht ein Fehlerbild: Der Agent ist völlig gesund, seine geplanten Aufgaben laufen weiter, und du hast schlicht keinen Weg zu ihm.

Auth-Schlüssel laufen ab, und Geräteschlüssel auch, sodass eine monatelang unberührte Instanz aus dem Tailnet fallen kann, ohne dass etwas schiefgelaufen ist. Prüfe die Tailscale-Admin-Konsole: Fehlt das Gerät oder ist es nicht autorisiert, erzeuge einen neuen Auth-Schlüssel und verbinde es neu. Das Erkennungszeichen dieser Ursache: Geplante Arbeit lief weiter, während das Dashboard nicht erreichbar war.

Das Spiegelbild ist ebenfalls wissenswert. Wenn der Agent das Dashboard erreicht, aber nicht deine internen Dienste, ist das Mesh für dich aktiv und für ihn ausgefallen, was meist bedeutet, dass das Gerät seine Autorisierung verloren hat und die Dienste nicht umgezogen sind.

Die Checkliste

1. Frage den Agent im Dashboard etwas Triviales. Eine Antwort schließt Instanz und Anbieter in einem Schritt aus.
2. Prüfe die Instanz in deinem Flux Dashboard auf eine Neustartschleife, und prüfe den RAM, wenn deine Last schwerer geworden ist.
3. Prüfe im Dashboard des Anbieters auf einen ungültigen Schlüssel, ein leeres Guthaben, ein Rate-Limit oder einen eingestellten Modellnamen.
4. Wenn lange Aufgaben scheitern und kurze gelingen, gehe von einem Rate-Limit aus und prüfe zuerst dein Tageskontingent.
5. Wenn der Agent redet, aber nie handelt, prüfe, ob das gewählte Modell Tool-Calling unterstützt.
6. Wenn das Dashboard nicht erreichbar ist, geplante Aufgaben aber weiterliefen, prüfe Tailscale auf ein abgelaufenes Gerät oder einen abgelaufenen Auth-Schlüssel.

Fast jeder Fall landet bei Schritt eins, drei oder fünf. Ein Agent hat mehr Fehlerstellen als ein Chat-Assistent, weil er mehr tut, und jede hinterlässt einen anderen Fingerabdruck.