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

Hermes Agent ist ein selbst gehosteter, modellagnostischer KI-Assistent, der auf einem lokalen Rechner oder einem kostengünstigen VPS läuft, über Terminal- und Messaging-Schnittstellen bedient wird und mit der Zeit intelligenter wird, indem er wiederkehrende Aufgaben in wiederverwendbare Fähigkeiten umwandelt.

Funktional ist er sehr ähnlich zu OpenClaw, einem weiteren selbst gehosteten Assistenten-Stack, der um Werkzeuge, Speicher und lokale Kontrolle aufgebaut ist. Viele Entwickler kamen zu Hermes, nachdem Anthropic den Claude-Abonnementzugang von OpenClaw im April 2026 blockierte – der Zeitstrahl des Aufstiegs und Falls von OpenClaw erklärt, warum Hermes das natürliche Ziel für Nutzer wurde, die eine persistente, selbst gehostete Automatisierung ohne Abhängigkeit von Anbietern wollten.

Wenn Sie das größere Bild zu selbst gehosteten Assistenten, Retrieval und lokaler Infrastruktur rund um Hermes verstehen möchten, verbindet diese Übersicht über KI-Systeme diese Themen mit denselben Problemen, die Hermes lösen soll. Für das Fünfschichten-Modell für Assistenten – LLM, Speicher, Werkzeuge, Routing und Observability – mit Hermes und OpenClaw als Referenzimplementierungen, siehe KI-Assistenten-Architektur. Für konkrete Adoptionsdaten – GitHub-Sterne, tägliche Token-Volumen auf OpenRouter, PyPI-Downloadzahlen, CVE-Historie und die Stimmung in der Reddit-Community – verfolgt OpenClaw vs. Hermes Agent: Sterne, Downloads & Nutzung 2026, wie Hermes sich gegenüber 19 Alternativen in jedem messbaren Signal verhält.

Für Deployment-Trade-offs und Laufzeitentscheidungen bietet LLM-Hosting im Jahr 2026: Lokal, Selbst Gehostet & Cloud-Infrastruktur im Vergleich die Hostingschaft, während LLM-Performance im Jahr 2026: Benchmarks, Flaschenhälse & Optimierung die Seite des Durchsatzes und der Latenz abdeckt, sobald Hermes läuft. Wenn Sie Hermes routinemäßig auf Qwen oder Gemma auf lokalen Laufzeiten wie Ollama ausrichten, konsolidieren Sie Temperatur- und Strafpresets für den mehrstufigen Werkzeuggebrauch mit Agentic LLM-Inferenz-Parameter für Qwen und Gemma. Für eine kompakte Übersicht der Shell-Befehle (hermes gateway, hermes memory, hermes doctor, Slash-Shortcuts und mehr), verwenden Sie den Hermes Agent CLI Spickzettel. Wenn Ihr Hauptzugangspunkt das Messaging am Smartphone ist, verwenden Sie Hermes Sprachsteuerung von Ihrem Telefon aus für den Sprach-Stack und die plattformspezifische Einrichtung.

Meine voreingenommene 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 Home-Verzeichnis hat, beginnen Ihre Prompts weniger wie „Chat" und mehr wie „Ops" zu wirken.

Was Hermes Agent ist und warum es wichtig ist

Hermes Agent ist ein Open-Source-KI-Agent, entwickelt von Nous Research. Er ist so konzipiert, dass er persistent läuft, Werkzeuge nutzt (Terminal, Dateien, Web und mehr) und sein eigenes Verhalten über die Zeit mit einem System für Fähigkeiten und Speicher verbessert.

Zwei Designentscheidungen sind es wert, ausführlich erklärt zu werden, da sie alles Weitere in diesem Leitfaden prägen.

Erstens ist Hermes nicht an einen einzelnen Modellanbieter gebunden. Der offizielle Einrichtungsvorgang unterstützt mehrere Anbieter und jeden OpenAI-kompatiblen Endpunkt, und das Umschalten erfolgt über den Befehl hermes model statt über 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 Werkzeuge und eine konfigurierbare Ausführungs-Back-End. Dort liegen Sicherheit, Reproduzierbarkeit und Fehlerbehebung.

Kosten und Lizenzierung sind erfrischend langweilig. Hermes Agent selbst ist kostenlose Software unter der MIT-Lizenz. 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 Werkzeugebenen verwendet, ist diese Änderung an der Anthropic-Abonnementregelung eine nützliche Referenz dafür, warum API-basierte Abrechnung jetzt der erwartete Weg ist.

Hermes Agent installieren

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

Hermes-Installation auf Linux

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install 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

Das Installationsprogramm ist nicht nur ein dünner Wrapper. Laut dem Installationsleitfaden richtet es Abhängigkeiten, das Repository, eine virtuelle Umgebung und den hermes-Befehl ein und bringt Sie in einen startbereiten Chat-Zustand.

Wenn Sie nicht von einem sauberen Neustart beginnen, sondern aus einer bestehenden OpenClaw-Deployment kommen, installieren und validieren Sie zuerst ein leeres Hermes, und folgen Sie dann dem gestuften Wechsel in So migrieren Sie sicher von OpenClaw zu Hermes Agent – hermes claw migrate mappt Persona, Speicher, Fähigkeiten, Anbieter und MCP-Server, aber Cron-Jobs, Plugins und Multi-Agent-Routing müssen von Hand neu aufgebaut werden.

Hinweise zu 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-Installationsweg. Er ist so konzipiert, dass er Termux erkennt und seine Abhängigkeits- und Umgebungsentsprechend anpasst.

Schnellstart

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

Wählen Sie einen Anbieter und ein Modell

Hermes bietet drei komplementäre Einstiegspunkte:

• hermes model, um einen Anbieter und das Standardmodell auszuwählen
• hermes tools, um Werkzeugsets zu aktivieren oder zu deaktivieren
• hermes setup, um einen interaktiven Assistenten über die wichtigsten Konfigurationsbereiche auszuführen

Ein minimales Ablauf sieht so aus:

hermes model
hermes tools
hermes

In Bezug auf das, 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.

Beweis der Werkzeugausführung frühzeitig

Bevor Sie Gewohnheiten rund um Hermes aufbauen, ist es sinnvoll, zu verifizieren, dass die Werkzeugnutzung in Ihrer Umgebung funktioniert. Der Schnellstart empfiehlt ausdrücklich die Terminalnutzung als erste zu testende Funktion.

In der Praxis erfüllt ein kleiner „Smoke-Test"-Prompt zwei Aufgaben: Er prüft das Terminal-Werkzeug und validiert Berechtigungsanfragen.

Beispiel-Prompt:

Zeig mir meine Disk-Nutzung und die fünf größten Verzeichnisse.

Wenn Hermes das Terminal-Werkzeug nicht ausführen kann, springen Sie direkt zur Fehlerbehebung. Fehlkonfiguration der Terminal-Back-End ist eine der häufigsten Ursachen, und die Lösung ist in der Regel offensichtlich, sobald man sich die Konfiguration ansieht.

Skalierbare Konfiguration

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

Wo Konfiguration und Zustand gespeichert werden

Hermes speichert seine Einstellungen und seinen Zustand 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 die Identität sowie Ordner für Speicher, Fähigkeiten, Cron, Sitzungen und Logs.

Das ist aus zwei Gründen wichtig.

• Das Debuggen wird mechanisch, weil man genau weiß, wo man hinsehen muss.
• Backups werden einfach, weil ein Verzeichnis den größten Teil des Agenten-Zustands erfasst, um den es Ihnen geht.

Konfigurationspriorität und Geheimnisse aus config.yaml fernhalten

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

Das schöne Detail ist, dass hermes config set Werte zur richtigen Datei leitet: API-Schlüssel zu .env und nicht-geheime Einstellungen zu 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. Dies ist nützlich, wenn Sie bestimmte Werte in der Umgebung halten möchten, aber sie dennoch in der strukturierten Konfiguration referenzieren möchten.

Sandbox und Ausführungs-Back-Ends

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

Die meinungsvolle, aber nicht evangelisierende Art, darüber nachzudenken, ist:

• local ist am schnellsten und einfachsten, aber nicht isoliert
• docker ist eine pragmatische Schicht für Sicherheit und Reproduzierbarkeit
• ssh ist ein sauberer Weg, um Ihr Chat-Gerät von Ihrer Rechnerbox zu trennen
• modal und daytona eignen sich für „Serverless, aber persistent genug"-Workflows
• singularity ist die HPC-freundliche Option

Ein minimales Beispiel für ein Docker-Back-End:

# ~/.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 Sicherheitsverstärkung für das Docker-Back-End, wie das Entfernen von Capabilities und das Deaktivieren der Privilegieneskalation.

Fähigkeiten, Speicher und Profile

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

Fähigkeiten (Skills) sind prozedurales Gedächtnis. Hermes kann seine eigenen Fähigkeiten erstellen, aktualisieren und löschen und kann anbieten, einen Ansatz als Fähigkeit zu speichern, nachdem er eine komplexe Aufgabe abgeschlossen hat.

Der eingebaute Speicher wird als Dateien wie MEMORY.md und USER.md unter ~/.hermes gespeichert, und Hermes kann auch externe Speicheranbieter für eine tiefere Erinnerung verwenden. Die Speicher-Dokumentation listet mehrere Anbieter-Plugins auf, und der Speicheranbieter-Leitfaden dokumentiert einen interaktiven Einrichtungsvorgang. Für eine vollständige technische Aufschlüsselung, wie die Speicherarchitektur funktioniert – eingefrorene Snapshots, Zeichenlimits, die externen Anbieter und die Philosophie hinter begrenztem Speicher – siehe Hermes Agent Memory System: Wie persistente KI-Speicher tatsächlich funktionieren. Wenn Sie einen lokalen, selbst gehosteten Anbieter mit ungewöhnlich granularer Kontrolle darüber wünschen, was automatisch geschrieben wird, siehe Mnemosyne für Hermes Agent: Lokaler Speicher-Schnellstart – und Selbstverstärkende Speicher-Schleifen in KI-Agenten für das, warum konservative Schreib-Defaults überhaupt wichtig sind.

Wenn Sie mehrere unabhängige Agenten auf demselben Rechner möchten, bieten Hermes-Profile Isolation. Jedes Profil erhält sein eigenes Verzeichnis mit eigener Konfiguration, eigenen Geheimnissen, eigenen Speichern, Sitzungen, Fähigkeiten, Cron-Jobs und Gateway-Zustand.

Für einen tieferen Einblick in welche Fähigkeiten gut in der Produktion funktionieren, nach Rolle unterteilt – Ingenieure, Forscher, Operatoren und Executive-Workflows – siehe Hermes KI-Assistenten-Fähigkeiten für echte Produktionssetups. Wenn Sie bereit sind, SKILL.md-Dateien selbst zu verfassen oder zu debuggen – YAML-Metadaten, progressive Offenlegungsebenen, bedingte Sichtbarkeit und Hub-Installationen – verwenden 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 auszuwirken wie Service-Engineering.

Eine stabile Baseline

Eine Baseline, die nicht leicht veraltet, ist:

1. Installieren und ersten Chat in der CLI ausführen.
2. Wählen Sie einen Anbieter und ein Modell mit hermes model, und bestätigen Sie dann die Kosten.
3. Konfigurieren Sie Werkzeugsets und entscheiden Sie, ob die Terminalausführung lokal oder sandboxed ist.
4. Führen Sie eine schnelle Änderung an SOUL.md erst nach einer Weile der Nutzung des Standards durch. Identitätsänderungen sind wichtiger, als die meisten erwarten, da es „Slot 1" im System-Prompt ist.

Tägliche Nutzung, die sich kumuliert

Hermes hat eine Terminal-Oberfläche statt einer Web-Oberfläche, und sie ist für lange Sitzungen mit Slash-Befehlen, wiederaufnehmbaren Sitzungen und Streaming-Werkzeugausgabe konzipiert. Die Shell-Flags, Subkommandos und Slash-Shortcuts für diese Sitzung finden Sie im Hermes Agent CLI Spickzettel.

In der Praxis ist ein nützlicher Rhythmus:

• Führen Sie Arbeit in einer benannten Sitzung für ein Projekt aus
• Komprimieren Sie den Kontext, wenn er zu groß wird
• Lassen Sie Hermes wiederkehrende Routinen zu Fähigkeiten machen
• Halten Sie eine mentale Grenze zwischen „fragen" und „handeln", damit die Werkzeugausführung auditierbar bleibt

Messaging-Gateway für 24/7-Zugang

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

Die Einrichtung wird über hermes gateway setup aufgerufen, und das Gateway kann im Vordergrund oder als Benutzerservice laufen. Die CLI-Referenz dokumentiert Gateway-Subkommandos wie run, install, start, stop, status und restart. Wenn Sie dieses Gateway-Modell auf einem dedizierten Server ausführen und von einem separaten Desktop-Client aus verbinden möchten, verwenden 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, was Dispatcher-Limits, Abhängigkeitsketten und Cron-basiertes Batching abdeckt.

Sicherheit für einen bot, der Werkzeuge verwendet, ist wichtig. Die Gateway-Dokumentation beschreibt Allowlists für bestimmte Plattformen und einen DM-Pairing-Flow, der Einmal-Pairing-Codes ausstellt und die Genehmigung über hermes pairing approve erfordert.

Updates ohne Drama

Hermes-Updates sind ein erstklassiger Befehl. Das Update-Leitfaden dokumentiert hermes update, Konfigurationsmigrationsprüfungen und eine kleine Validierungsroutine nach dem Update, einschließlich hermes doctor und hermes gateway status.

hermes update
hermes doctor
hermes gateway status

Fehlerbehebung und Diagnosen

Die meisten Hermes-Fehler sind nicht mysteriös. Sie wirken mysteriös, weil Menschen nur die Schicht des Modells prüfen und die Laufzeitschicht ignorieren.

Schnelle Triage-Befehle

Die CLI-Referenz positioniert explizit drei Befehle als den Kernkreislauf:

• hermes doctor für interaktive Diagnosen
• hermes status für einen schnellen Überblick
• hermes dump für eine teilbare, zensierte Setup-Zusammenfassung

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 ihre Fixes auf, einschließlich Python-Versionsprobleme, uv nicht gefunden und Berechtigungsprobleme, die durch das Mischen von sudo-Installationen mit Benutzerinstallationen verursacht werden.

Wenn Sie auf diese Fehler stoßen, bieten die Dokumentation spezifische Lösungsschritte wie das Aktualisieren von Python, die Installation von uv und die Neuinstallation von Hermes ohne sudo an.

Probleme mit Anbietern und Modellen

Wenn API-Schlüssel nicht funktionieren, empfiehlt die FAQ, die Konfiguration zu prüfen, hermes model neu 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 anbieter spezifisch.

Für „Modell nicht gefunden"-Probleme verweist die FAQ zurück auf die Verwendung von hermes model, um einen gültigen Bezeichner auszuwählen, und zeigt sowohl Konfigurations- als auch pro-Sitzungs-Overrides.

Rate-Limiting- und Kontextlängenprobleme werden ebenfalls behandelt. Die FAQ schlägt vor, auf 429-Fehler zu warten, den Anbieter oder das Modell zu wechseln und den Kontextdruck durch Komprimierung oder eine neue Sitzung zu verringern.

Probleme mit Terminal-Back-End und Gateway

Wenn Terminal-Befehle sofort fehlschlagen, enthält der Konfigurationsleitfaden einen Abschnitt zu „häufige Terminal-Back-End-Probleme" und verweist auf die typischen Ursachen pro Back-End, einschließlich Docker läuft nicht und fehlende SSH-Variablen. Es merkt auch an, dass das Fallback auf local ein valides Debugging-Verfahren 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 tatsächlich die Autorisierung bei der Arbeit zeigen.

Referenzen

• Hermes Agent Homepage
• Hermes Agent Memory System: Wie persistente KI-Speicher tatsächlich funktionieren
• Hermes KI-Assistenten-Fähigkeiten für echte Produktionssetups