Hermes AI Assistant – Installation, Einrichtung, Workflow und Fehlerbehebung

Hermes Agent ist ein selbst gehosteter, modellunabhängiger KI-Assistent, der auf einem lokalen Rechner oder einem günstigen VPS läuft, über Terminal- und Messaging-Schnittstellen funktioniert und sich mit der Zeit verbessert, indem er wiederkehrende Aufgaben in wiederverwendbare Fertigkeiten verwandelt.

Funktional ist er dem OpenClaw sehr ähnlich, einem weiteren selbst gehosteten Assistenten-Stack, der um Werkzeuge, Speicher und lokale Kontrolle herum aufgebaut ist. Viele Entwickler fanden den Weg zu Hermes, nachdem Anthropic im April 2026 den Zugriff auf OpenClaw für Claude-Abonnements blockierte – die Zeitleiste des Aufstiegs und Falls von OpenClaw erklärt, warum Hermes als natürlicher Zielort für Benutzer hervortrat, die eine persistente, selbst gehostete Automatisierung ohne Anbieterabhängigkeit wollten.

Wenn Sie das umfassendere Bild von selbst gehosteten Assistenten, Retrieval und lokaler Infrastruktur rund um Hermes verstehen möchten, verbindet diese Übersicht über KI-Systeme diese Themen mit den gleichen Problemen, die Hermes zu lösen versucht. Für das Fünfschicht-Assistentenmodell – LLM, Speicher, Werkzeugkasten, Routing und Beobachtbarkeit – mit Hermes und OpenClaw als Referenzimplementierungen, siehe KI-Assistenten-Architektur. Für konkrete Adoptionsdaten – GitHub-Stars, tägliche Token-Volumina auf OpenRouter, PyPI-Downloadzahlen, CVE-Verlauf und Reddit-Community-Stimmung – verfolgt OpenClaw vs. Hermes Agent: Stars, Downloads & Nutzung 2026, wie sich Hermes im Vergleich zu 19 Alternativen bei jedem messbaren Indikator schlägt.

Für Deployement-Trade-offs und Laufzeitoptionen liefert [LLM-Hosting 2026: Lokale, selbst gehostete & Cloud-Infrastruktur im Vergleich](https://www.glukhov.org/de/llm-hosting/ “Kompletter Leitfaden zum LLM-Hosting 2026. Vergleichen Sie Ollama, vLLM, Docker Model Runner, LocalAI und Cloud-Anbieter. Lernen Sie Kosten-, Leistungs- und Infrastrukturttrade-offs.”} das Hosting-Map, während LLM-Leistung 2026: Benchmarks, Engpässe & Optimierung die Durchsatz- und Latenzseite abdeckt, sobald Hermes läuft. Wenn Sie Hermes routinemäßig auf Qwen oder Gemma auf lokalen Laufzeiten wie Ollama ausrichten, konsolidieren Sie Temperatur- und Penalty-Voreinstellungen für mehrstufige Werkzeugnutzung mit Agentische LLM-Inferenzparameter für Qwen und Gemma. Für eine kompakte Übersicht von Shell-Befehlen (hermes gateway, hermes memory, hermes doctor, Slash-Shortcuts und mehr), nutzen Sie das Hermes Agent CLI-Spickzettel. Wenn Ihr Haupteinstiegspunkt Messaging auf dem Smartphone ist, nutzen Sie Hermes Sprachsteuerung von Ihrem Telefon aus für den Sprach-Stack und plattformspezifische Einrichtung.

Meine subjektive Meinung: Hermes ist am interessantesten, wenn man ihn als Infrastruktur behandelt, nicht als einen Tab, den man ab und zu öffnet. Sobald er als Dienst läuft und ein stabiles Home-Verzeichnis hat, beginnen Ihre Prompts weniger nach „Chat" und mehr nach „Ops" (Betrieb) zu aussehen.

Was Hermes Agent ist und warum es wichtig ist

Hermes Agent ist ein quelloffener KI-Agent, entwickelt von Nous Research. Er ist so konzipiert, dass er persistent läuft, Werkzeuge (Terminal, Dateien, Web und mehr) verwendet und sein eigenes Verhalten mit der Zeit über ein Fertigkeiten- und Speichersystem verbessert.

Zwei Designentscheidungen sind es wert, ausdrücklich genannt zu werden, da sie alles Weitere in diesem Leitfaden prägen.

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

Zweitens zieht Hermes eine harte Grenze zwischen „Gespräch" und „Ausführung". Der Agent kann den ganzen Tag reden, aber wenn er handeln muss, tut er dies durch explizite Werkzeuge und eine konfigurierbare Ausführungs-Hintergrundsystem (Backend). Dort liegen Sicherheit, Reproduzierbarkeit und Fehlersuche.

Kosten und Lizenzierung sind erfrischend langweilig. Hermes Agent selbst ist unter der MIT-Lizenz kostenlose Software. Wenn Sie gehostete Modelle verwenden, sind die laufenden Kosten das, was Ihr Anbieter berechnet. Wenn Sie lokale Modelle ausführen, können Sie API-Gebühren vollständig vermeiden.

Wenn Ihr Hermes-Setup Claude über externe Werkzeug-Ebenen nutzt, ist diese Änderung der Anthropic-Abonnementrichtlinie eine nützliche Referenz dafür, warum API-basierte Abrechnung jetzt der erwartete Weg ist.

Hermes Agent installieren

Hermes hat einen schnellen Installationspfad für Linux, macOS und WSL2. Die offizielle Dokumentation hält dies 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 ein dünner Wrapper. Laut dem Installationsleitfaden richtet er Abhängigkeiten, das Repository, eine virtuelle Umgebung und den hermes-Befehl ein und bringt Sie zu einem ersten Chat-fähigen Zustand.

Wenn Sie von einer bestehenden OpenClaw-Deployment kommen, statt neu zu starten, installieren und validieren Sie zuerst ein leeres Hermes, und folgen Sie dann dem gestuften Übergang in So migrieren Sie sicher von OpenClaw zu Hermes Agent – hermes claw migrate bildet Persona, Speicher, Fertigkeiten, Anbieter und MCP-Server ab, aber Cron-Jobs, Plugins und Multi-Agent-Routing müssen von Hand neu aufgebaut werden.

Hinweise für Windows und Android

Natives Windows wird nicht unterstützt. Die Dokumentation empfiehlt WSL2 und die Ausführung von Hermes darin.

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

Schnellstart

Der schnellste erste Lauf ist buchstäblich nur hermes, aber ein bedeutungsvoller Schnellstart bedeutet zwei zusätzliche Entscheidungen: Welcher Modellanbieter verwendet werden soll und welche Werkzeuge aktiviert werden sollen.

Anbieter und Modell auswählen

Hermes bietet drei komplementäre Einstiegspunkte:

• hermes model zur Auswahl eines Anbieters und eines Standardmodells
• hermes tools zum Aktivieren oder Deaktivieren von Werkzeug-Sets
• hermes setup zum Ausführen eines interaktiven Assistenten in den wichtigsten Konfigurationsbereichen

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.

Werkzeugausführung früh beweisen

Bevor Sie Gewohnheiten rund um Hermes aufbauen, lohnt es sich zu überprüfen, ob die Werkzeugnutzung in Ihrer Umgebung funktioniert. Der Schnellstart empfiehlt ausdrücklich die Terminal-Nutzung als erste Funktion zum Ausprobieren.

In der Praxis erfüllt ein kleiner „Rauchtest"-Prompt zwei Aufgaben: Er prüft das Terminal-Werkzeug und validiert die Berechtigungs-Hinweise.

Beispiel-Prompt:

Zeig meine Datennutzung und die fünf größten Verzeichnisse.

Wenn Hermes das Terminal-Werkzeug nicht ausführen kann, springen Sie zu Fehlersuche. Eine Fehlkonfiguration der Terminal-Hintergrundsystem (Backend) ist eine der häufigsten Ursachen, und die Lösung ist normalerweise offensichtlich, wenn man sich die Konfiguration ansieht.

Konfiguration, die skaliert

Hermes belohnt Menschen, die verstehen, wo er Zustand speichert und wie er Konfigurationen auflöst. Hierher stammen auch viele „es hat gestern noch funktioniert"-Probleme.

Wo Konfiguration und Zustand liegen

Hermes speichert seine Einstellungen und Zustände unter ~/.hermes. Der offizielle Konfigurationsleitfaden dokumentiert das Layout, einschließlich config.yaml für Einstellungen, .env für Geheimnisse, auth.json für OAuth-Credentials, SOUL.md für Identität und Ordner für Erinnerungen, Fertigkeiten, Cron, Sitzungen und Logs.

Das ist aus zwei Gründen wichtig.

• Fehlersuche wird mechanisch, weil man genau weiß, wo man hinsehen soll.
• Backups werden einfach, weil ein Verzeichnis den meisten Agenten-Zustand erfasst, der einem wichtig ist.

Konfigurationspriorität und Geheimnisse aus config.yaml fernhalten

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

Das schöne Detail ist, dass hermes config set Werte zur richtigen 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 Umgebungsvariablen-Substitution innerhalb von config.yaml via ${VAR_NAME}-Syntax. Das ist nützlich, wenn man bestimmte Werte in der Umgebung halten möchte, sie aber dennoch in der strukturierten Konfiguration referenzieren will.

Sandbox und Ausführungshintergrundsysteme

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

Die meinungsstarken, aber nicht evangelisierende Art, dies zu betrachten, ist:

• local ist am schnellsten und einfachsten, aber nicht isoliert
• docker ist eine pragmatische Sicherheits- und Reproduzierbarkeitsschicht
• ssh ist ein sauberer Weg, um das Chat-Gerät vom Compute-Box zu trennen
• modal und daytona eignen sich für „serverless, aber persistent genug"-Workflows
• singularity ist die HPC-freundliche Option

Ein minimales Docker-Backend-Beispiel:

# ~/.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 Härtung der Sicherheit für das Docker-Backend, wie z. B. das Entfernen von Capabilities und das Deaktivieren von Privilege-Eskalation.

Fertigkeiten, Speicher und Profile

Hermes hat zwei zusammenhängende Mechanismen zum Aufbau von Wert.

Fertigkeiten sind prozedurales Gedächtnis. Hermes kann eigene Fertigkeiten erstellen, aktualisieren und löschen und kann anbieten, einen Ansatz nach Abschluss einer komplexen Aufgabe als Fertigkeit zu speichern.

Der eingebaute Speicher wird als Dateien wie MEMORY.md und USER.md unter ~/.hermes gespeichert, und Hermes kann auch externe Speicheranbieter für tiefere Erinnerungen nutzen. Die Speicher-Dokumentation listet mehrere Anbieter-Plugins auf, und der Speicheranbieter-Leitfaden dokumentiert einen interaktiven Einrichtungs-Flow. Für einen vollständigen technischen Einblick, wie die Speicherarchitektur funktioniert – eingefrorene Snapshots, Zeichenlimits, die externen Anbieter und die Philosophie hinter begrenztem Speicher – siehe Hermes Agent Speichersystem: Wie persistierendes KI-Gedächtnis tatsächlich funktioniert. Wenn Sie einen lokalen, selbst gehosteten Anbieter mit ungewöhnlich granularer Kontrolle darüber wünschen, was automatisch geschrieben wird, sehen Sie sich Mnemosyne für Hermes Agent: Lokaler Speicher-Schnellstart an – und Selbstverstärkende Speicher-Schleifen in KI-Agenten dafür, warum konservative Schreib-Standardwerte überhaupt wichtig sind.

Wenn Sie mehrere unabhängige Agenten auf demselben Rechner möchten, bieten Hermes-Profile Isolation. Jedes Profil erhält seinen eigenen Ordner mit seiner eigenen Konfiguration, seinen Geheimnissen, Erinnerungen, Sitzungen, Fertigkeiten, Cron-Jobs und Gateway-Zustand.

Für einen tieferen Blick darauf, welche Fertigkeiten in der Produktion gut funktionieren, nach Rolle – Ingenieure, Forscher, Operatoren und Executive-Workflows – siehe Hermes KI-Assistenten-Fertigkeiten für reale Produktions-Setups. Wenn Sie bereit sind, SKILL.md-Dateien selbst zu autorisieren oder zu debuggen – YAML-Metadaten, progressive Offenlegungsebenen, bedingte Sichtbarkeit und Hub-Installationen – nutzen Sie Hermes Agent Fertigkeiten-Autorisierung — SKILL.md-Struktur und beste Praktiken.

Typischer Workflow

Wenn man Hermes wie einen Agenten behandelt, den man behalten wird, beginnt der Workflow aus wie Service-Engineering auszusehen.

Eine stabile Baseline

Eine Baseline, die nicht leicht veraltet, ist:

1. Installieren und einen ersten Chat in der CLI ausführen.
2. Einen Anbieter und ein Modell mit hermes model auswählen, dann Kosten bestätigen.
3. Werkzeug-Sets konfigurieren und entscheiden, ob die Terminal-Ausführung lokal oder sandboxed ist.
4. Eine schnelle Änderung an SOUL.md vornehmen, nur nachdem man das Standardprofil eine Weile verwendet hat. Identitätsänderungen sind wichtiger, als man erwartet, da es „Slot 1" im System-Prompt ist.

Tägliche Nutzung, die sich aufsummiert

Hermes hat eine Terminal-Oberfläche (TUI) anstelle einer Web-Oberfläche und ist für lange Sitzungen mit Slash-Befehlen, wiederaufnehmbaren Sitzungen und streamendem Werkzeug-Output konzipiert.

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 wiederkehrende Routinen in Fertigkeiten verwandeln lassen
• Eine mentale Grenze zwischen „fragen" und „handeln" halten, damit die Werkzeugausfü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, Sitzungen 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-Unterbefehle wie run, install, start, stop, status und restart. Wenn Sie dieses Gateway-Modell auf einem dedizierten Server laufen lassen möchten, während Sie von einem separaten Desktop-Client verbinden, nutzen Sie Hermes Agent Headless-Server und Remote-Desktop-Setup.

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-basierte Batching abdeckt.

Sicherheit für einen Bot, der Werkzeuge verwendet, ist wichtig. Die Gateway-Dokumentation beschreibt Whitelists für bestimmte Plattformen und einen DM-Pairing-Flow, der einmalige Pairing-Codes ausgibt und eine Genehmigung via hermes pairing approve erfordert.

Updates ohne Drama

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

hermes update
hermes doctor
hermes gateway status

Fehlersuche und Diagnosen

Die meisten Hermes-Fehler sind nicht mysteriös. Sie wirken mysteriös, weil Leute nur die Modell-Schicht prüfen und die Laufzeit-Schicht ignorieren.

Schnelle Triage-Befehle

Die CLI-Referenz positioniert drei Befehle ausdrücklich als den Kern-Loop:

• hermes doctor für interaktive Diagnosen
• hermes status für eine schnelle Übersicht
• hermes dump für eine teilbare, geschwärzte Setup-Zusammenfassung

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 Fehlersucheleitfaden listet mehrere wiederkehrende Probleme und deren Lösungen auf, einschließlich Python-Versionsprobleme, uv nicht gefunden und Berechtigungsprobleme, die durch das Mischen von sudo-Installationen mit Benutzer-Installationen verursacht werden.

Wenn Sie auf diese Fehler stoßen, bieten die Dokumentation spezifische Sanierungsschritte wie das Upgraden 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 via hermes config set zu setzen. Es weist auch auf eine häufige Falle hin: Schlüssel sind anbieter-spezifisch.

Für „Modell nicht gefunden"-Probleme verweist die FAQ darauf, hermes model zu verwenden, um eine gültige Kennung auszuwählen, und zeigt sowohl Konfigurations- als auch pro-Sitzungs-Überschreibungen.

Rate-Limiting- und Kontextlängenprobleme werden auch abgedeckt. Die FAQ schlägt vor, auf 429-Fehler zu warten, Anbieter oder Modelle zu wechseln und den Kontextdruck durch Kompression oder eine neue Sitzung zu reduzieren.

Terminal-Backend- und Gateway-Probleme

Wenn Terminal-Befehle sofort fehlschlagen, enthält der Konfigurationsleitfaden einen Abschnitt „häufige Terminal-Backend-Probleme" und verweist auf die typischen Ursachen pro Backend, einschließlich Docker läuft nicht und fehlende SSH-Variablen. Es weist auch darauf hin, dass das Zurückfallen auf lokal ein gültiger Fehlerschritt ist, wenn die Sandbox-Konfiguration in Frage steht.

Für Gateway-Probleme hebt der Messaging-Leitfaden Whitelists und Pairing als sichere Standards hervor, was bedeutet, dass viele „Bot ist still"-Vorfälle tatsächlich die Autorisierung bei der Arbeit sind.

Referenzen

• Hermes Agent Homepage
• Hermes Agent Speichersystem: Wie persistierendes KI-Gedächtnis tatsächlich funktioniert
• Hermes KI-Assistenten-Fertigkeiten für reale Produktions-Setups