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

Hermes Agent ist ein selbst gehosteter, modellunabhängiger KI-Assistent, der auf einem lokalen Computer oder einem kostengünstigen VPS läuft, über Terminal- und Messaging-Schnittstellen arbeitet und sich durch die Umwandlung wiederkehrender Aufgaben in wiederverwendbare Fähigkeiten im Laufe der Zeit verbessert.

In seinen Funktionen ähnelt er stark OpenClaw, einem weiteren selbst gehosteten Assistenten-Stack, der um Werkzeuge, Speicher und lokale Kontrolle herum aufgebaut ist. Viele Entwickler fanden nach der Blockierung des Claude-Abonnementzugriffs von Anthropic für OpenClaw im April 2026 den Weg zu Hermes. 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 suchten.

Wenn Sie das größere Bild der selbst gehosteten Assistenten, des Retrieval und der lokalen Infrastruktur rund um Hermes betrachten möchten, verbindet dieser Überblick über KI-Systeme diese Themen mit den Problemen, die Hermes lösen möchte, zusammen. Für konkrete Adoptionsdaten — GitHub-Sterne, tägliches Token-Volumen bei 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 liefert LLM-Hosting in 2026: Lokal, selbst gehostet & Cloud-Infrastruktur im Vergleich die Hosting-Landschaft, während LLM-Leistung in 2026: Benchmarks, Engpässe & Optimierung die Aspekte Durchsatz und Latenz abdeckt, sobald Hermes läuft. Wenn Sie Hermes routinemäßig auf Qwen oder Gemma bei lokalen Laufzeiten wie Ollama ausrichten, konsolidieren Sie Temperatur- und Penalty-Presets für mehrstufige 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 die Hermes Agent CLI Cheat Sheet. Wenn Ihr Haupteintrittspunkt Messaging auf Mobilgeräten ist, nutzen Sie Hermes Sprachsteuerung von Ihrem Telefon für den Sprach-Stack und plattformspezifische Einrichtung.

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

Was Hermes Agent ist und warum er wichtig ist

Hermes Agent ist ein Open-Source-KI-Agent, entwickelt von Nous Research. Er ist darauf ausgelegt, persistent zu laufen, Werkzeuge 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 sind besonders hervorzuheben, da sie den Rest dieses Leitfadens prägen.

Erstens ist Hermes 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 statt 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 Werkzeuge und einen konfigurierbaren Ausführungshintergrund. 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 die laufenden Kosten an, die Ihr Anbieter berechnet. Wenn Sie lokale Modelle laufen lassen, können Sie API-Gebühren vollständig vermeiden.

Wenn Ihre Hermes-Einrichtung Claude über externe Werkzeug-Schichten nutzt, ist diese Änderung bei Anthropic-Abonnements eine nützliche Referenz dafür, warum API-basierte Abrechnung nun der erwartete Weg ist.

Hermes Agent installieren

Hermes hat einen schnellen Installationspfad 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 Installationsanleitung richtet er Abhängigkeiten, das Repository, eine virtuelle Umgebung und den Befehl hermes ein und bringt Sie 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-Installationspfad. Er ist darauf ausgelegt, Termux zu erkennen und seine Abhängigkeiten und Umgebungseinrichtung entsprechend anzupassen.

Schnellstart

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

Wählen Sie einen Anbieter und ein Modell

Hermes bietet drei komplementäre Einstiegspunkte:

• hermes model, um einen Anbieter und ein Standardmodell auszuwählen
• hermes tools, um Werkzeugsets 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 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, weil es sowohl gehostete Dienste als auch selbst gehostete Endpunkte umfasst.

Beweisen Sie die Werkzeugausführung frühzeitig

Bevor Sie Gewohnheiten rund um Hermes aufbauen, ist es wert, zu überprüfen, ob die Werkzeugnutzung in Ihrer Umgebung funktioniert. Der Schnellstart schlägt explizit die Terminalnutzung als erste Funktion vor, die man ausprobieren sollte.

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

Beispielprompt:

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

Wenn Hermes das Terminal-Werkzeug 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 skalierbar ist

Hermes belohnt Menschen, die verstehen, wo er den Status speichert und wie er Konfiguration auflöst. Dies ist auch der Ort, an dem viele “es hat gestern noch funktioniert”-Probleme entstehen.

Wo Konfiguration und Status gespeichert sind

Hermes speichert seine Einstellungen und seinen Status unter ~/.hermes. Der offizielle Konfigurationsleitfaden dokumentiert die Struktur, einschließlich config.yaml für Einstellungen, .env für Secrets, auth.json für OAuth-Anmeldeinformationen, 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 suchen müssen.
• Backups werden einfach, weil ein Verzeichnis den Großteil des Agenten-Status erfasst, der Ihnen wichtig ist.

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

Hermes löst Konfiguration mit einer Prioritätsreihenfolge auf. Oben stehen CLI-Overrides, dann config.yaml, dann .env, mit eingebauten Standardwerten am unteren Ende.

Das nette Detail ist, dass hermes config set Werte in die richtige Datei leitet: API-Schlüssel in .env und nicht-geheime Einstellungen in 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 Umgebungsvariablensubstitution innerhalb von config.yaml über die ${VAR_NAME}-Syntax. Dies ist nützlich, wenn Sie bestimmte Werte in der Umgebung halten möchten, sie aber dennoch in der strukturierten Konfiguration referenzieren.

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 Meinung habende, aber nicht missionarische Art, dies zu betrachten, 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 Entfernen von Capabilities und das Deaktivieren der Privilege-Escalation.

Skills, Memory und Profile

Hermes hat zwei verwandte Mechanismen zur Kumulation von Wert.

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

Das integrierte Memory wird als Dateien wie MEMORY.md und USER.md unter ~/.hermes gespeichert, und Hermes kann auch externe Memory-Anbieter für tiefere Erinnerungsfähigkeiten nutzen. Die Memory-Docs listen mehrere Provider-Plugins auf, und der Leitfaden für Memory-Provider dokumentiert einen interaktiven Setup-Prozess. Für eine vollständige technische Aufschlüsselung, wie die Memory-Architektur funktioniert — eingefrorene Snapshots, Zeichenlimits, die acht externen Provider und die Philosophie hinter begrenztem Memory — sehen Sie Hermes Agent Memory System: Wie persistentes KI-Gedächtnis tatsächlich funktioniert.

Wenn Sie mehrere unabhängige Agenten auf derselben Maschine wünschen, bieten Hermes-Profile Isolation. Jedes Profil erhält sein eigenes Verzeichnis mit eigener Konfiguration, Secrets, Memories, Sitzungen, Skills, Cron-Jobs und Gateway-Status.

Für einen tieferen Einblick, welche Skills in der Produktion nach Rolle gut funktionieren — Ingenieure, Forscher, Operatoren und Executive-Workflows — sehen Sie Hermes AI Assistant Skills für echte Produktionssetups. Wenn Sie bereit sind, SKILL.md-Dateien selbst zu autorieren oder zu debuggen — YAML-Metadaten, progressive Disklosure-Level, 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 nicht leicht 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. Werkzeugsets konfigurieren und entscheiden, ob die Terminal-Ausführung lokal oder sandboxed ist.
4. Eine schnelle Änderung an SOUL.md vornehmen, nur nachdem Sie die Standardeinstellung eine Weile verwendet haben. Identitätsänderungen sind wichtiger, als die Leute erwarten, weil es “Slot 1” im System-Prompt ist.

Tägliche Nutzung, die sich kumuliert

Hermes hat eine Terminal-Benutzeroberfläche statt einer Web-UI, und sie 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 wiederkehrende Routinen in Skills umwandeln lassen
• Eine mentale Grenze zwischen “fragen” und “handeln” halten, damit die Tool-Ausführung auditierbar bleibt

Messaging-Gateway für 24/7-Zugriff

Das Messaging-Gateway ist das Stück, das Hermes wie einen Assistenten statt wie eine Terminal-App fühlen lässt. Die Docs beschreiben es als einen einzelnen Prozess, der sich mit mehreren Plattformen verbindet, Sitzungen handhabt, 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 sehen Sie Kanban in Hermes Agent für selbst gehostete LLM-Workflows, das Dispatcher-Limits, Abhängigkeitsketten und cron-basiertes Batching abdeckt.

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

Updates ohne Drama

Hermes-Updates sind ein First-Class-Befehl. Der Update-Leitfaden dokumentiert hermes update, Konfigurationsmigrationschecks 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 Modellschicht überprüfen und die Laufzeitschicht ignorieren.

Schnelle Triage-Befehle

Die CLI-Referenz positioniert explizit drei Befehle als Kernschleife:

• 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 ihre Lösungen auf, einschließlich Python-Version-Probleme, 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 Docs spezifische Remediation-Schritte 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 wird auch ein häufiger Fallstrick hervorgehoben: 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-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 über Komprimierung 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 weist auf die typischen Ursachen pro Backend hin, einschließlich Docker läuft nicht und fehlende SSH-Variablen. Es wird auch angemerkt, dass ein Fallback 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 tatsächlich Autorisierung sind, die ihre Arbeit tut.

Referenzen

• Hermes Agent Homepage
• Hermes Agent Memory System: Wie persistentes KI-Gedächtnis tatsächlich funktioniert
• Hermes AI Assistant Skills für echte Produktionssetups