Hermes KI-Assistent – Installation, Einrichtung, Arbeitsablauf und Fehlerbehebung

Hermes Agent ist ein selbst gehosteter, modellagnostischer KI-Assistent, der auf einem lokalen Computer oder einem kostengünstigen VPS läuft, über Terminal- und Messaging-Schnittstellen arbeitet und sich im Laufe der Zeit verbessert, indem er wiederkehrende Aufgaben in wiederverwendbare Fähigkeiten umwandelt.

In Bezug auf die Funktionalität ähnelt er stark OpenClaw, einem weiteren selbst gehosteten Assistenten-Stack, der um Tools, Speicher und lokale Kontrolle herum aufgebaut ist. Viele Entwickler fanden den Weg zu Hermes, nachdem Anthropic im April 2026 den Zugriff von OpenClaw auf Claude-Abonnements blockiert hatte – die Zeitleiste für den Aufstieg und Fall von OpenClaw erklärt, warum Hermes als natürliche Anlaufstelle für Nutzer auftrat, die persistente, selbst gehostete Automatisierung ohne Abhängigkeit von Anbietern suchten.

Wenn Sie ein breiteres Bild von selbst gehosteten Assistenten, Retrieval und lokaler Infrastruktur rund um Hermes sehen möchten, verbindet diese Übersicht über KI-Systeme diese Themen mit den gleichen Problemen, die Hermes zu lösen versucht.

Für Kompromisse bei der Bereitstellung und Laufzeitentscheidungen bietet LLM-Hosting 2026: Lokal, selbst gehostet & Cloud-Infrastruktur im Vergleich die Hosting-Landschaft dar, während LLM-Leistung 2026: Benchmarks, Engpässe & Optimierung die Aspekte Durchsatz und Latenz behandelt, sobald Hermes läuft. Für eine kompakte Übersicht der Shell-Befehle (hermes gateway, hermes memory, hermes doctor, Slash-Shortcuts und mehr) nutzen Sie das Hermes Agent CLI Cheat Sheet.

Meine verzerrte Meinung: Hermes ist am interessantesten, wenn man ihn als Infrastruktur betrachtet, nicht als einen Tab, den man gelegentlich öffnet. Sobald er als Dienst läuft und ein stabiles Home-Verzeichnis hat, sehen Ihre Prompts weniger aus wie “Chat” und mehr wie “Ops” (Betrieb).

Was Hermes Agent ist und warum es wichtig ist

Hermes Agent ist ein Open-Source-KI-Agent, der von Nous Research entwickelt wurde. Er ist darauf ausgelegt, persistent zu laufen, Tools zu nutzen (Terminal, Dateien, Web und mehr) und sein eigenes Verhalten im Laufe der Zeit mit einem Skills- und Speichersystem zu verbessern.

Zwei Designentscheidungen sind so wichtig, dass sie alles andere in diesem Leitfaden prägen.

Erstens: Hermes ist nicht an einen einzelnen Modellanbieter gebunden. Der offizielle Setup-Prozess unterstützt mehrere Anbieter und jeden OpenAI-kompatiblen Endpunkt, und das Umschalten erfolgt über den Befehl hermes model und nicht über Code-Änderungen.

Zweitens: Hermes zieht eine harte Linie zwischen “Gespräch” und “Ausführung”. Der Agent kann den ganzen Tag lang reden, aber wenn er handeln muss, tut er dies durch explizite Tools und eine konfigurierbare Ausführungsumgebung. Dort liegen Sicherheit, Reproduzierbarkeit und Fehlerbehebung.

Kosten und Lizenzierung sind erfrischend langweilig. Hermes Agent selbst ist Freie Software unter der MIT-Lizenz. Wenn Sie gehostete Modelle nutzen, fallen anfallende Kosten nur an, was Ihr Anbieter berechnet. Wenn Sie lokale Modelle ausführen, können Sie API-Gebühren vollständig vermeiden.

Wenn Ihre Hermes-Konfiguration Claude über externe Tooling-Schichten nutzt, ist diese Änderung bei Anthropic-Abonnements eine nützliche Referenz dafür, warum ab API-basierter Abrechnung jetzt der erwartete Weg ist.

Hermes Agent installieren

Hermes hat einen schnellen Installationspfad für Linux, macOS und WSL2. Die offiziellen Docs halten es bewusst einfach.

Hermes-Installation auf Linux

sudo apt-get update
sudo apt-get upgrade
sudo apt-get curl git
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Nach der Installation laden Sie Ihre Shell neu und starten die CLI.

source ~/.bashrc   # oder source ~/.zshrc
hermes

Der Installer ist nicht nur ein dünner Wrapper. Laut Installationsleitfaden richtet er Abhängigkeiten, das Repository, eine virtuelle Umgebung und den hermes-Befehl ein und bringt Sie in einen ersten chatbereiten Zustand.

Hinweise zu Windows und Android

Native Windows-Unterstützung existiert nicht. Die Docs empfehlen WSL2 und das Ausführen von Hermes innerhalb davon.

Für Android unterstützt Hermes einen Termux-Installationspfad. Er ist so konzipiert, dass er Termux erkennt und seine Abhängigkeiten und Umgebungssetup entsprechend anpasst.

Schnellstart

Der schnellste erste Start ist buchstäblich nur hermes, aber ein sinnvoller Schnellstart bedeutet zwei zusätzliche Entscheidungen: welchen Modellanbieter man nutzt und welche Tools aktiviert werden sollen.

Einen Anbieter und ein Modell auswählen

Hermes bietet drei komplementäre Einstiegspunkte:

• hermes model, um einen Anbieter und ein Standardmodell auszuwählen
• hermes tools, um Toolsets zu aktivieren oder zu deaktivieren
• hermes setup, um einen interaktiven Assistenten für wichtige Konfigurationsbereiche auszuführen

Ein minimaler Ablauf sieht so aus:

hermes model
hermes tools
hermes

In Bezug darauf, was tatsächlich unterstützt wird, listet der offizielle Quickstart eine Reihe von Anbietern auf und betont auch, dass Hermes mit OpenAI-kompatiblen APIs funktioniert. Das ist wichtig, da es sowohl gehostete Dienste als auch selbst gehostete Endpunkte einschließt.

Tool-Ausführung frühzeitig beweisen

Bevor Sie Gewohnheiten rund um Hermes aufbauen, lohnt es sich zu überprüfen, ob die Tool-Nutzung in Ihrer Umgebung funktioniert. Der Quickstart schlägt explizit die Terminal-Nutzung als erste Funktion vor, die man ausprobieren sollte.

In der Praxis erfüllt ein kleiner “Smoke-Test”-Prompt zwei Aufgaben: Er prüft das Terminal-Tool und validiert Berechtigungsaufforderungen.

Beispielprompt:

Zeige meine Festplattennutzung und die fünf größten Verzeichnisse an.

Wenn Hermes das Terminal-Tool nicht ausführen kann, springen Sie weiter zu Fehlerbehebung. Fehlkonfiguration des Terminal-Backends ist eine der häufigsten Ursachen, und die Lösung ist meist offensichtlich, sobald man die Konfiguration ansieht.

Konfiguration, die skaliert

Hermes belohnt diejenigen, die verstehen, wo er seinen Zustand speichert und wie er Konfiguration auflöst. Hierher stammen auch viele “Es hat gestern noch funktioniert”-Probleme.

Wo Konfiguration und Zustand gespeichert sind

Hermes speichert seine Einstellungen und seinen Zustand unter ~/.hermes. Der offizielle Konfigurationsleitfaden dokumentiert die Struktur, einschließlich config.yaml für Einstellungen, .env für Secrets, auth.json für OAuth-Anmeldedaten, SOUL.md für Identität und Ordner für Erinnerungen, Skills, Cron-Jobs, Sitzungen und Logs.

Das ist aus zwei Gründen wichtig.

• Debugging wird mechanisch, weil Sie genau wissen, wo Sie hinschauen müssen.
• Backups werden straightforward (einfach), weil ein einzelnes Verzeichnis den größten Teil des Agenten-Zustands erfasst, der Sie interessiert.

Konfigurationspriorität und das Herausnehmen von Secrets aus config.yaml

Hermes löst Konfiguration mit einer Prioritätsreihenfolge auf. Oben stehen CLI-Overrides, dann config.yaml, dann .env, mit integrierten Standardwerten ganz unten.

Das schöne Detail ist, dass hermes config set Werte in die richtige Datei routet: API-Schlüssel nach .env und nicht-geheime Einstellungen nach config.yaml.

hermes config set model openrouter/meta-llama/llama-3.1-70b-instruct
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxx

Hermes unterstützt auch die Substitution von Umgebungsvariablen innerhalb von config.yaml via ${VAR_NAME}-Syntax. Das ist nützlich, wenn Sie bestimmte Werte in der Umgebung halten möchten, sie aber dennoch in strukturierter Konfiguration referenzieren wollen.

Sandbox und Ausführungsumgebungen

Hermes unterstützt mehrere Terminal-Backends, die definieren, wo Shell-Befehle tatsächlich ausgeführt werden. Der Konfigurationsleitfaden listet local, docker, ssh, modal, daytona und singularity auf.

Die opinionated (meinungsbetonte), aber nicht missionarische Art, darüber nachzudenken, ist:

• local ist am schnellsten und einfachsten, aber es ist nicht isoliert
• docker ist eine pragmatische Schicht für Sicherheit und Reproduzierbarkeit
• ssh ist eine saubere Möglichkeit, Ihr Chat-Gerät von Ihrem Compute-Box zu trennen
• modal und daytona passen zu “serverless, aber persistent genug”-Workflows
• singularity ist die HPC-freundliche Option

Ein minimales Beispiel für ein Docker-Backend:

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_volumes:
    - "/home/user/projects:/workspace/projects"
  docker_forward_env:
    - "GITHUB_TOKEN"

Die Docs beschreiben auch die Sicherheitsverstärkung für das Docker-Backend, wie das Dropen von Capabilities und das Deaktivieren der Privilege-Escalation.

Skills, Speicher und Profile

Hermes hat zwei verwandte Mechanismen zur Kumulation von Wert.

Skills sind prozeduraler Speicher. Hermes kann eigene Skills erstellen, aktualisieren und löschen und kann anbieten, einen Ansatz als Skill zu speichern, nachdem er eine komplexe Aufgabe abgeschlossen hat.

Der integrierte Speicher wird als Dateien wie MEMORY.md und USER.md unter ~/.hermes gespeichert, und Hermes kann auch externe Speicheranbieter für tieferes Abrufen nutzen. Die Speicher-Docs listen mehrere Provider-Plugins auf, und der Leitfaden für Speicheranbieter dokumentiert einen interaktiven Setup-Prozess. Für eine vollständige technische Aufschlüsselung, wie die Speicherarchitektur funktioniert – eingefrorene Snapshots, Zeichenlimits, die acht externen Anbieter und die Philosophie hinter begrenztem Speicher – siehe Hermes Agent Memory System: Wie persistenten KI-Speicher tatsächlich funktioniert.

Wenn Sie mehrere unabhängige Agenten auf derselben Maschine möchten, bieten Hermes-Profile Isolation. Jedes Profil erhält sein eigenes Verzeichnis mit eigener Konfiguration, Secrets, Erinnerungen, Sitzungen, Skills, Cron-Jobs und Gateway-Zustand.

Für einen tieferen Einblick, welche Skills in der Produktion nach Rolle gut funktionieren – Ingenieure, Forscher, Operatoren und Executive-Workflows – siehe Hermes AI Assistant Skills für echte Produktions-Setups. Wenn Sie bereit sind, SKILL.md-Dateien selbst zu verfassen oder zu debuggen – YAML-Metadaten, progressive Offenlegungsebenen, bedingte Sichtbarkeit und Hub-Installationen – nutzen Sie Hermes Agent Skill Authoring — SKILL.md Struktur und Best Practices.

Typischer Workflow

Wenn Sie Hermes wie einen Agenten behandeln, den Sie behalten werden, beginnt der Workflow wie Service Engineering auszusehen.

Eine stabile Basis

Eine Basis, die tendenziell nicht verrottet, ist:

1. Installieren und einen ersten Chat in der CLI ausführen.
2. Einen Anbieter und ein Modell mit hermes model auswählen und dann die Kosten bestätigen.
3. Toolsets konfigurieren und entscheiden, ob die Terminal-Ausführung lokal oder in einer Sandbox erfolgt.
4. Eine schnelle Änderung an SOUL.md vornehmen, nur nachdem Sie die Standardeinstellung eine Weile genutzt haben. Identitätsänderungen sind wichtiger, als man erwartet, da es “Slot 1” im System-Prompt ist.

Tägliche Nutzung, die sich kumuliert

Hermes hat eine Terminal-Benutzeroberfläche statt einer Web-UI, und er ist für lange Sitzungen mit Slash-Befehlen, fortsetzbaren Sitzungen und gestreamtem Tool-Output ausgelegt.

In der Praxis ist ein nützlicher Rhythmus:

• Arbeit in einer benannten Sitzung für ein Projekt ausführen
• Kontext komprimieren, wenn er zu groß wird
• Hermes lassen, wiederkehrende Routinen in Skills zu verwandeln
• Eine mentale Grenze zwischen “fragen” und “handeln” halten, damit Tool-Ausführung auditierbar bleibt

Messaging-Gateway für 24/7-Zugriff

Das Messaging-Gateway ist das Teil, das Hermes wie einen Assistenten und nicht wie eine Terminal-App fühlen lässt. Die Docs beschreiben es als einen einzelnen Prozess, der sich mit mehreren Plattformen verbindet, Sitzungen verwaltet, Cron-Jobs ausführt und Nachrichten liefert.

Das Setup wird via hermes gateway setup aufgerufen, und das Gateway kann im Vordergrund oder als Benutzerdienst laufen. Die CLI-Referenz dokumentiert Gateway-Subbefehle wie run, install, start, stop, status und restart.

Für Multi-Agent-Backlogs und kontrollierte Planung siehe Kanban in Hermes Agent für selbst gehostete LLM-Workflows, das Dispatcher-Limits, Abhängigkeitsketten und cron-basiertes Batching behandelt.

Sicherheit für einen toolnutzenden Bot ist wichtig. Die Gateway-Docs beschreiben Allowlists für bestimmte Plattformen und einen DM-Pairing-Flow, der einmalige Pairing-Codes ausstellt und Genehmigung via hermes pairing approve erfordert.

Updates ohne Drama

Hermes-Updates sind ein erstklassiger Befehl. Der Update-Leitfaden dokumentiert hermes update, Config-Migrationschecks und eine kleine Post-Update-Validierungsroutine einschließlich hermes doctor und hermes gateway status.

hermes update
hermes doctor
hermes gateway status

Fehlerbehebung und Diagnostik

Die meisten Hermes-Fehler sind nicht mysteriös. Sie sehen mysteriös aus, weil Menschen nur die Modell-Ebene prüfen und die Laufzeit-Ebene ignorieren.

Schnelle Triage-Befehle

Die CLI-Referenz positioniert explizit drei Befehle als den Kern-Loop:

• hermes doctor für interaktive Diagnostik
• hermes status für einen schnellen Überblick
• hermes dump für eine teilbare, redigierte Zusammenfassung des Setups

Für Logs tailt hermes logs Dateien, die unter ~/.hermes/logs gespeichert sind.

hermes doctor --fix
hermes status
hermes dump --show-keys
hermes logs errors -f

Häufige Installationsfehler

Die FAQ und der Troubleshooting-Leitfaden listen mehrere wiederkehrende Probleme und ihre Fixes auf, einschließlich Python-Version-Probleme, uv nicht gefunden und Berechtigungsprobleme, die durch Mischen von sudo-Installationen mit Benutzerinstallationen verursacht werden.

Wenn Sie auf diese Fehler stoßen, bieten die Docs spezifische Remediation-Schritte wie das Upgraden von Python, das Installieren von uv und das Neuinstallieren von Hermes ohne sudo.

Anbieter- und Modellprobleme

Wenn API-Schlüssel nicht funktionieren, empfiehlt die FAQ, die Konfiguration zu überprüfen, hermes model erneut auszuführen oder einen Schlüssel direkt via hermes config set zu setzen. Es wird auch ein häufiger Fehler hervorgehoben: Schlüssel sind anbieter-spezifisch.

Bei “Modell nicht gefunden”-Problemen verweist die FAQ zurück auf die Verwendung von hermes model, um eine gültige Kennung auszuwählen, und zeigt sowohl Config- als auch pro-Sitzung-Overrides.

Rate-Limiting- und Kontextlängenprobleme werden ebenfalls behandelt. Die FAQ schlägt vor, auf 429-Fehler zu warten, Anbieter oder Modelle zu wechseln und den Kontextdruck via Kompression oder einer frischen Sitzung zu reduzieren.

Terminal-Backend- und Gateway-Probleme

Wenn Terminal-Befehle sofort fehlschlagen, enthält der Konfigurationsleitfaden einen Abschnitt über “häufige Terminal-Backend-Probleme” und weist auf die typischen Ursachen pro Backend hin, einschließlich Docker läuft nicht und fehlende SSH-Variablen. Es wird auch angemerkt, dass das Zurückfallen auf local ein gültiger Debugging-Schritt ist, wenn die Sandbox-Konfiguration in Frage steht.

Bei Gateway-Problemen hebt der Messaging-Leitfaden Allowlists und Pairing als sichere Defaults hervor, was bedeutet, dass viele “Bot ist stumm”-Vorfälle eigentlich Autorisierung, die ihre Arbeit tut.

Referenzen

• Hermes Agent Homepage
• Hermes Agent Memory System: Wie persistenten KI-Speicher tatsächlich funktioniert
• Hermes AI Assistant Skills für echte Produktions-Setups