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 Terminal- und Messaging-Schnittstellen arbeitet und sich im Laufe der Zeit verbessert, indem er wiederholte Aufgaben in wiederverwendbare Fertigkeiten umwandelt.

Funktional ist er sehr ähnlich zu OpenClaw, einem anderen selbst gehosteten Assistenten-Stack, der um Tools, Speicher und lokale Kontrolle aufgebaut ist. Viele Entwickler fanden den Weg zu Hermes, nachdem Anthropic den Zugang von OpenClaw zu Claude-Abonnements im April 2026 blockiert hatte — die Zeitleiste von OpenClaws Aufstieg und Fall erklärt, warum Hermes als natürlicher Zielort für Nutzer entstand, die persistente, selbst gehostete Automatisierung ohne Anbieterabhängigkeit wollten.

Wenn Sie das größere Bild selbst gehosteter Assistenten, Retrieval und lokaler Infrastruktur rund um Hermes sehen möchten, verbindet diese Übersicht über KI-Systeme diese Themen mit den Problemen, die Hermes zu lösen versucht. Für das fünfschichtige Assistentenmodell — LLM, Speicher, Tooling, Routing und Observability — mit Hermes und OpenClaw als Referenzimplementierungen, siehe Architektur von KI-Assistenten. Für konkrete Adoptionsdaten — GitHub-Sterne, tägliches Token-Volumen von OpenRouter, PyPI-Downloadzahlen, CVE-Historie und Reddit-Community-Stimmung — verfolgt OpenClaw vs. Hermes Agent: Sterne, Downloads & Nutzung 2026, wie sich Hermes in jedem messbaren Signal mit 19 Alternativen vergleicht.

Für Kompromisse bei der Bereitstellung und Laufzeitentscheidungen bietet LLM-Hosting in 2026: Lokale, selbst gehostete & Cloud-Infrastruktur im Vergleich die Hosting-Übersicht, während LLM-Leistung in 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-Standardwerte für mehrschrittige Tool-Nutzung mit Agentische LLM-Inferenzparameter für Qwen und Gemma. Für eine kompakte Übersicht der Shell-Befehle (hermes gateway, hermes memory, hermes doctor, Schrägstrich-Shortcuts und mehr), nutzen Sie das Hermes Agent CLI-Cheatsheet. Wenn Ihr Haupteingangspunkt Messaging auf Mobilgeräten ist, nutzen Sie Hermes Sprachsteuerung von Ihrem Telefon für den Sprachstack und plattformspezifisches Setup.

Meine voreingenommene Meinung: Hermes ist am interessantesten, wenn er als Infrastruktur behandelt wird, nicht als 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”.

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 so konzipiert, dass er persistent läuft, Tools (Terminal, Dateien, Web und mehr) nutzt und sein eigenes Verhalten im Laufe der Zeit mit einem Skills- und Speichersystem verbessert.

Zwei Designentscheidungen sind hervorzuheben, da sie alles andere 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 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 einen konfigurierbaren Ausführungs-Backend. Dort leben 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, 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 Tooling-Schichten nutzt, ist diese Anthropic-Abonnementänderung eine nützliche Referenz dazu, 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 Docs 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 ein dünner Wrapper. Laut Installationsleitfaden richtet er Abhängigkeiten, das Repo, eine virtuelle Umgebung und den hermes-Befehl ein und bringt Sie dann in einen ersten chatbereiten Zustand.

Hinweise für Windows und Android

Natives Windows wird nicht unterstützt. Die Docs empfehlen WSL2 und das Ausführen 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 Umgebungskonfiguration entsprechend anpasst.

Schnellstart

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

Einen Anbieter und ein Modell wä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 über wichtige Konfigurationsbereiche auszuführen

Ein minimaler Flow 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 hebt auch hervor, dass Hermes mit OpenAI-kompatiblen APIs funktioniert. Das ist wichtig, weil es sowohl gehostete Dienste als auch selbst gehostete Endpunkte einschließt.

Tool-Ausführung früh beweisen

Bevor Sie Gewohnheiten rund um Hermes aufbauen, ist es wert zu verifizieren, dass Tool-Nutzung in Ihrer Umgebung funktioniert. Der Schnellstart 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.

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

Konfiguration, die skaliert

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

Wo Konfiguration und Zustand liegen

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-Credentials, SOUL.md für Identität und Ordner für Erinnerungen, Skills, Cron, Sessions und Logs.

Das ist aus zwei Gründen wichtig.

• Debugging wird mechanisch, weil Sie genau wissen, wo Sie hinschauen müssen.
• Backups werden straightforward, weil ein Verzeichnis den größten Teil des Agent-Zustands einfängt, der Sie interessiert.

Konfigurationspriorität und Secrets aus config.yaml halten

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

Das nette 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 Umgebungsvariablensubstitution innerhalb von config.yaml via ${VAR_NAME}-Syntax. Das ist nützlich, wenn Sie bestimmte Werte in der Umgebung behalten möchten, sie aber dennoch in strukturierter Konfiguration referenzieren wollen.

Sandbox und Ausführungs-Backends

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 opinionierte, 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 Ihrer 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 Sicherheitsabsicherung für das Docker-Backend, wie das Dropen von Capabilities und das Deaktivieren von Privilege-Escalation.

Skills, Speicher und Profile

Hermes hat zwei verwandte Mechanismen zur Kumulierung 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 eine komplexe Aufgabe abgeschlossen ist.

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

Wenn Sie mehrere unabhängige Agenten auf demselben Machine möchten, bieten Hermes-Profile Isolation. Jedes Profil erhält sein eigenes Verzeichnis mit seiner eigenen Konfiguration, Secrets, Erinnerungen, Sessions, Skills, Cron-Jobs und Gateway-Zustand.

Für einen tieferen Blick darauf, welche Skills in der Produktion nach Rolle gut funktionieren — Ingenieure, Forscher, Operatoren und Executive-Workflows — siehe Hermes KI-Assistent Skills für echte Produktionssetups. Wenn Sie bereit sind, SKILL.md-Dateien selbst zu autorieren oder zu debuggen — YAML-Metadaten, progressive Disclosure-Ebenen, bedingte Sichtbarkeit und Hub-Installs — 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 nicht so leicht verrottet:

1. Installieren und einen ersten Chat in der CLI ausführen.
2. Einen Anbieter und ein Modell mit hermes model auswählen und dann Kosten bestätigen.
3. Toolsets konfigurieren und entscheiden, ob Terminal-Ausführung lokal oder sandboxed ist.
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, weil 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, fortsetzbaren Sessions und gestreamtem Tool-Output konzipiert.

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 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 Docs beschreiben es als einen einzelnen Prozess, der sich mit mehreren Plattformen verbindet, Sessions handhabt, Cron-Jobs ausführt und Nachrichten liefert.

Setup wird via hermes gateway setup aufgerufen, und das Gateway kann im Vordergrund oder als Benutzer-Dienst laufen. Die CLI-Referenz dokumentiert Gateway-Subbefehle 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 tool-nutzenden Bot ist wichtig. Die Gateway-Docs beschreiben Allowlists für bestimmte Plattformen und einen DM-Pairing-Flow, der One-Time-Pairing-Codes ausgibt und Genehmigung via hermes pairing approve erfordert.

Updates ohne Drama

Hermes-Updates sind ein First-Class-Befehl. Der Update-Leitfaden dokumentiert hermes update, Config-Migrations-Checks 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 Modell-Schicht prüfen und die Laufzeit-Schicht 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 eine schnelle Übersicht
• hermes dump für eine teilbare, redigierte 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 der Fehlerbehebungsleitfaden listet mehrere wiederkehrende Probleme und ihre Lösungen auf, einschließlich Python-Version-Problemen, uv nicht gefunden und Berechtigungsproblemen, die durch Mischen von sudo-Installs mit User-Installs verursacht werden.

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

Anbieter- und Modellprobleme

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

Für “Modell nicht gefunden”-Probleme verweist die FAQ zurück auf die Nutzung von hermes model, um eine gültige ID auszuwählen, und zeigt sowohl Config- als auch Per-Session-Überschreibungen.

Rate-Limiting- und Kontextlänge-Probleme werden ebenfalls abgedeckt. Die FAQ schlägt vor, auf 429-Fehler zu warten, Anbieter oder Modelle zu wechseln und Kontextdruck via Kompression oder einer neuen Session zu reduzieren.

Terminal-Backend- und Gateway-Probleme

Wenn Terminal-Befehle sofort fehlschlagen, enthält der Konfigurationsleitfaden eine Sektion “häufige Terminal-Backend-Probleme” und verweist auf die typischen Ursachen pro Backend, einschließlich Docker läuft nicht und fehlende SSH-Variablen. Es wird auch angemerkt, dass ein Fallback auf local ein validen Debugging-Schritt ist, wenn Sandbox-Konfiguration in Frage steht.

Für Gateway-Probleme hebt der Messaging-Leitfaden Allowlists und Pairing als sichere Defaults hervor, was bedeutet, dass viele “Bot ist still”-Incidents eigentlich Autorisierung sind, die ihre Arbeit tut.

Referenzen

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