Hermes AI-Assistent – Installation, Einrichtung, Workflow und Fehlerbehebung

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

In seiner 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 den Zugang von OpenClaw zur Claude-Abonnementnutzung im April 2026 blockierte — die Zeitleiste von OpenClaws Aufstieg und Fall erklärt, warum Hermes das natürliche Ziel für Nutzer wurde, die eine persistente, selbst gehostete Automatisierung ohne Anbieterabhängigkeit suchten.

Wenn Sie das größere Bild selbst gehosteter Assistenten, Retrieval-Systeme und lokaler Infrastruktur rund um Hermes sehen möchten, verknüpft diese Übersicht über KI-Systeme diese Themen mit den Problemen, die Hermes zu lösen versucht, zusammen.

Für Kompromisse bei der Bereitstellung und Laufzeitentscheidungen bietet LLM-Hosting 2026: Lokal, selbst gehostet und Cloud-Infrastruktur im Vergleich die Hosting-Landschaft, während LLM-Leistung 2026: Benchmarks, Engpässe & Optimierung die Aspekte Durchsatz und Latenz abdeckt, 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-Referenzblatt. Wenn Ihr Haupteinstiegspunkt Messaging auf Mobilgeräten ist, nutzen Sie Hermes Sprachsteuerung von Ihrem Telefon für den Sprachstack und die plattformspezifische Einrichtung.

Meine unvoreingenommene Meinung: Hermes ist am interessantesten, wenn er als Infrastruktur behandelt wird, nicht als ein Tab, das man gelegentlich öffnet. Sobald er als Dienst läuft und ein stabiles Heimatverzeichnis hat, sehen Ihre Prompts weniger aus wie „Chat“ und mehr aus wie „Ops“ (Betrieb).

Was Hermes Agent ist und warum er 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 Memory-System zu verbessern.

Zwei Designentscheidungen verdienen eine genaue Erläuterung, da sie alles andere in diesem Leitfaden prägen.

Erstens ist Hermes nicht an einen einzigen Modellanbieter gebunden. Der offizielle Einrichtungsablauf unterstützt mehrere Anbieter und jede OpenAI-kompatible Endpunkt, und das Wechseln erfolgt über den Befehl hermes model anstatt durch Code-Änderungen.

Zweitens zieht Hermes eine harte Linie zwischen „Konversation“ und „Ausführung“. Der Agent kann den ganzen Tag reden, aber wenn er handeln muss, tut er dies durch explizite Tools und eine konfigurierbare Ausführungshintergrundumgebung. 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 verwenden, sind die laufenden Kosten nur das, was Ihr Anbieter berechnet. Wenn Sie lokale Modelle ausführen, können Sie API-Gebühren vollständig vermeiden.

Wenn Ihre Hermes-Einrichtung Claude über externe Tool-Schichten nutzt, ist diese Änderung an der Anthropic-Abonnementnutzung ein nützlicher Referenzpunkt, warum API-basierte Abrechnung jetzt der erwartete Weg ist.

Hermes Agent installieren

Hermes hat einen schnellen Installationspfad für Linux, macOS und WSL2. Die offiziellen Dokumentation halten es absichtlich 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 eine dünne Hülle. Laut Installationsanleitung 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 gibt es nicht. Die Dokumentation empfiehlt WSL2 und die Ausführung von Hermes darin.

Für Android unterstützt Hermes einen Termux-Installationspfad. Er ist darauf ausgelegt, Termux zu erkennen und seine Abhängigkeits- und Umgebungssetup entsprechend anzupassen.

Schnellstart

Der schnellste erste Lauf ist buchstäblich nur hermes, aber ein sinnvoller Schnellstart bedeutet zwei zusätzliche Entscheidungen: Welchen Modellanbieter soll man verwenden und welche Tools sollen aktiviert sein?

Einen Anbieter und ein Modell auswählen

Hermes bietet drei ergänzende 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 verschiedene 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 Schnellstart eine Reihe von Anbietern auf und weist auch darauf hin, dass Hermes mit OpenAI-kompatiblen APIs funktioniert. Das ist wichtig, da dies sowohl gehostete Dienste als auch selbst gehostete Endpunkte einschließt.

Tool-Ausführung frühzeitig beweisen

Bevor Sie Gewohnheiten rund um Hermes entwickeln, ist es sinnvoll zu überprüfen, ob die Tool-Nutzung in Ihrer Umgebung funktioniert. Der Schnellstart schlägt explizit die Terminal-Nutzung als erstes Feature vor, das 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 Festplattenbelegung und die fünf größten Verzeichnisse.

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 Leute, die verstehen, wo er seinen Zustand speichert und wie er Konfiguration auflöst. Dies ist auch der Ort, an dem viele „es funktionierte gestern“-Probleme herstammen.

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 Geheimnisse, 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.

• Die Fehlerbehebung wird mechanisch, weil Sie genau wissen, wo Sie hinsehen müssen.
• Backups werden straightforward, weil ein Verzeichnis den Großteil des Agent-Zustands erfasst, der Ihnen wichtig ist.

Konfigurationspriorität und Geheimnisse aus config.yaml halten

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

Das nette Detail ist, dass hermes config set Werte in die richtige Datei leitet: 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 Umgebungsvariable-Substitution innerhalb von config.yaml über die ${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ührungshintergründe

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, 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 Rechen-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 Dokumentation beschreibt auch die Sicherheitshärtung für das Docker-Backend, wie das Ablegen von Capabilities und das Deaktivieren der Privileg-Eskalation.

Skills, Memory und Profile

Hermes hat zwei verwandte Mechanismen zur Kumulation von Wert.

Skills sind prozedurale Erinnerungen. Hermes kann seine eigenen 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 tiefere Abrufe nutzen. Die Memory-Dokumentation listet mehrere Anbieter-Plugins auf, und der Leitfaden für Memory-Anbieter dokumentiert einen interaktiven Einrichtungsablauf. Für eine vollständige technische Aufschlüsselung, wie die Memory-Architektur funktioniert — eingefrorene Snapshots, Zeichenlimits, die acht externen Anbieter und die Philosophie hinter begrenztem Memory — siehe Hermes Agent Memory System: Wie persistente KI-Erinnerung 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, Geheimnissen, 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-Assistent Skills für echte Produktionssetups. Wenn Sie bereit sind, SKILL.md-Dateien selbst zu autorieren oder zu debuggen — YAML-Metadaten, progressive Offenlegungsebenen, bedingte Sichtbarkeit und Hub-Installationen — nutzen Sie Hermes Agent Skill-Autorierung — SKILL.md-Struktur und Best Practices.

Typischer Workflow

Wenn Sie Hermes wie einen Agenten behandeln, den Sie behalten werden, sieht der Workflow wie Service-Engineering aus.

Eine stabile Basis

Eine Basis, die nicht verrottet, ist:

1. Installation und Ausführung eines ersten Chats in der CLI.
2. Auswahl eines Anbieters und Modells mit hermes model, dann Bestätigung der Kosten.
3. Konfiguration von Toolsets und Entscheidung, ob die Terminal-Ausführung lokal oder sandboxed ist.
4. Eine schnelle Änderung an SOUL.md erst nach einer Weile, in der Sie das Standardverhalten genutzt haben. Identitätsänderungen sind wichtiger, als die Leute erwarten, da es „Slot 1“ im System-Prompt ist.

Tägliche Nutzung, die sich kumuliert

Hermes hat eine Terminal-UI statt einer Web-UI, und er ist für lange Sessions mit Slash-Befehlen, wiederaufnehmbaren Sessions und gestreamtem Tool-Output ausgelegt.

In der Praxis ist ein nützlicher Rhythmus:

• Arbeit in einer benannten Session für ein Projekt ausführen
• Kontext komprimieren, wenn er zu groß wird
• Hermes lassen, wiederholte Routinen in Skills umzuwandeln
• Eine mentale Grenze zwischen „fragen“ und „handeln“ halten, damit Tool-Ausführung überprüfbar bleibt

Messaging-Gateway für 24/7-Zugriff

Das Messaging-Gateway ist das Stück, das Hermes wie einen Assistenten statt einer Terminal-App fühlen lässt. Die Dokumentation beschreibt es als einen einzelnen Prozess, der sich mit mehreren Plattformen verbindet, Sessions verwaltet, Cron-Jobs ausführt und Nachrichten liefert.

Die Einrichtung wird über 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, was Dispatcher-Limits, Abhängigkeitsketten und cron-basierte Batching abdeckt.

Sicherheit für einen toolnutzenden Bot ist wichtig. Die Gateway-Dokumentation beschreibt Allowlists für bestimmte Plattformen und einen DM-Pairing-Flow, der Einmal-Pairing-Codes ausgibt und Genehmigung über hermes pairing approve erfordert.

Updates ohne Drama

Hermes-Updates sind ein First-Class-Befehl. Der Update-Leitfaden dokumentiert hermes update, Konfigurationsmigrationsprüfungen 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 Leute nur die Modelleschicht prüfen und die Laufzeitschicht ignorieren.

Schnelle Triage-Befehle

Die CLI-Referenz positioniert explizit drei Befehle als Kern-Schleife:

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

Für Logs tails 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 Fehlerbehebungsleitfaden listet mehrere wiederkehrende Probleme und deren Lösungen 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 Dokumentation spezifische Behebungsschritte wie das Upgrade von Python, die Installation von uv und die Neuinstallation 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 über hermes config set zu setzen. Es weist auch auf eine häufige Falle hin: Schlüssel sind anbieterspezifisch.

Für „Modell nicht gefunden“-Probleme verweist die FAQ zurück zur Verwendung von hermes model, um eine gültige ID auszuwählen, und zeigt sowohl Konfigurations- als auch pro-Session-Überschreibungen.

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 neuen Session zu reduzieren.

Terminal-Backend- und Gateway-Probleme

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

Für Gateway-Probleme hebt der Messaging-Leitfaden Allowlists und Pairing als sichere Standards hervor, was bedeutet, dass viele „Bot ist stumm“-Vorfälle eigentlich Autorisierung, die ihre Arbeit tut, sind.

Referenzen

• Hermes Agent Homepage
• Hermes Agent Memory System: Wie persistente KI-Erinnerung tatsächlich funktioniert
• Hermes AI-Assistent Skills für echte Produktionssetups