Wie ist die Standardmethode, um einen interaktiven Chat mit Hermes Agent zu starten?

Nach der Installation führen Sie hermes oder hermes chat in Ihrer Shell aus. Damit wird der interaktive Agent mit Ihrem konfigurierten Standardmodell, den Toolsets und dem Profil gestartet.

Wie führen Sie ein skriptfreundliches One-Shot aus, das nur die finale Antwort ausgibt?

Verwenden Sie hermes -z mit Ihrem Prompt, damit stdout nur den reinen Endtext ohne Banner oder Sitzungszeilen enthält. Wenn Sie Tool-Ausgaben im Protokoll benötigen, verwenden Sie stattdessen hermes chat -q.

Wie unterscheidet sich das Terminal-Hermes-Modell vom In-Session-Slash-Modell-Befehl?

Das Hermes-Modell läuft unabhängig von Chat-Sessions und ermöglicht das Hinzufügen von Providern, API-Schlüsseln, OAuth-Logins sowie benutzerdefinierter Endpunkte. Der Befehl /model wechselt nur zwischen bereits konfigurierten Providern.

Wo speichert Hermes Agent Konfigurationen und Geheimnisse auf der Festplatte?

Der State befindet sich unter HERMES_HOME (in der Regel ~/.hermes), mit config.yaml für die Einstellungen, .env für Secrets und erforderlichenfalls Auth-Daten sowie Ordnern für Sessions, Skills, Memory, Cron und Logs.

Welche CLI-Befehle helfen, wenn Modelle fehlschlagen oder API-Schlüssel falsch erscheinen?

Führen Sie hermes doctor für Fehlerbehebungen, hermes status für eine Momentaufnahme, hermes dump für eine paste-fähige Zusammenfassung und hermes logs mit Filtern oder Follow-Modus zur Inspektion von Fehlern aus.

Wie sollten Sie das Messaging-Gateway unter WSL2 ausführen?

Starten Sie das Hermes Gateway lieber innerhalb von tmux, anstatt sich auf den Hintergrundstart via systemd zu verlassen, da das Verhalten von systemd unter WSL variiert. Konfigurieren Sie die Plattformen zuvor mit hermes gateway setup.

Wie führen Sie mehrere isolierte Hermes-Installationen auf einer Maschine aus?

Verwenden Sie das Hermes-Profil, um separate Homes zu erstellen und mit –profile oder hermes profile use zwischen ihnen zu wechseln, sodass jedes Profil seine eigenen Konfigurationen, Sitzungen, Skills und Gateway-Zustände beibehält.

Hermes Agent CLI-Referenzkarte – Befehle, Flags und Slash-Shortcuts

Shell- und TUI-Befehle für den selbst gehosteten Hermes Agent.

Inhaltsverzeichnis

Hermes Agent von Nous Research ist ein modellagnostischer, werkzeugnutzender Assistent, den Sie lokal oder auf einem VPS ausführen können.

Hermes bindet Sie nicht an eine einzige Oberfläche. Sie können verwenden:

die klassische hermes / hermes chat CLI,
die Vollbild-hermes --tui-Sitzung,
einen langlaufenden hermes gateway für Telegram, Discord, Slack und andere Messaging-Plattformen,
hermes dashboard für eine lokale Browser-UI, wenn die Web-Extras installiert sind.

Diese Wege nutzen dieselbe Konfiguration und dieselben Daten unter ~/.hermes; diese Seite listet die Shell-Befehle auf, die in diesen Modi relevant sind.

Hermes Agent CLI Cheat Sheet — Terminal-Referenz

Nachfolgend finden Sie eine kompakte Befehlsreferenz, gruppiert nach Aufgaben.

Installation von Hermes Agent und erste CLI-Befehle

Beginnen Sie bei der Installation und Fehlerbehebung mit Hermes AI Assistant — Installation, Einrichtung, Workflow und Fehlerbehebung.

Der Installer zieht das Repository, richtet eine Python-Umgebung ein und verknüpft die hermes-Executable. Nach source ~/.bashrc oder ~/.zshrc ist Ihr Standard-Einstiegspunkt für interaktive Chats einfach hermes (aus derselben Familie wie hermes chat).

Befehl	Beschreibung
`curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh \| bash`	Offizielle Einzeil-Installation (Linux, macOS, WSL2).
`hermes` / `hermes chat`	Interaktiven Chat starten (Standard-Tageseinstieg).
`hermes --version` / `hermes version`	Versionsinformationen ausgeben.
`hermes completion bash` \| `zsh` \| `fish`	Shell-Vervollständigungsskripte für Tab-Vervollständigung erzeugen.
`hermes update [--check] [--backup] [--restart-gateway]`	Neuesten Code ziehen, Abhängigkeiten neu installieren, optionales Pre-Update-Home-Snapshot oder Gateway-Neustart.
`hermes uninstall [--full] [--yes]`	Hermes deinstallieren; optionale vollständige Datenlöschung.

Native Windows wird nicht unterstützt; verwenden Sie WSL2. Android-Installationen über Termux folgen einem dedizierten Pfad in den Upstream-Dokumenten.

Globale Flags für jeden `hermes`-Aufruf

Diese Flags gelten vor Subbefehlen und ändern, welches Profil, welche Sitzung oder wie viel persönliche Konfiguration geladen wird.

Flag	Beschreibung
`--profile`, `-p`	Hermes-Profil für diesen Lauf auswählen (überschreibt das sticky-Standardprofil von `hermes profile use`).
`--resume`, `-r`	Sitzung nach ID oder Titel fortsetzen.
`--continue [name]`, `-c`	Letzte Sitzung fortsetzen oder letzte Sitzung, die einem Titel entspricht.
`--worktree`, `-w`	Start in einem isolierten Git-Worktree für parallele Agents.
`--yolo`	Genehmigungsabfragen für gefährliche Befehle umgehen (mit Vorsicht verwenden).
`--pass-session-id`	Sitzungs-ID im System-Prompt enthalten.
`--ignore-user-config`	`~/.hermes/config.yaml` überspringen (nur Standardwerte); `.env` wird weiterhin geladen.
`--ignore-rules`	Auto-Injektion von AGENTS.md, SOUL.md, `.cursorrules`, Memory und vorbeladenen Skills überspringen.
`--tui`	TUI starten (äquivalent zu `HERMES_TUI=1`).
`--dev`	Mit `--tui` TS-Quellen via `tsx` für TUI-Entwicklung ausführen.

Isolierte Automatisierung kombiniert oft hermes chat --ignore-user-config --ignore-rules mit hermes -z für reproduzierbare One-Shots.

`hermes chat`, One-Shot-Prompts und `hermes -z`

Befehl / Muster	Beschreibung
`hermes chat`	Interaktiver oder skriptbasierter Chat; Hauptoberfläche für `-q`, `-m`, `--provider`, Toolsets, Resume, Worktree, Checkpoints.
`hermes chat -q "..."`	One-Shot-Prompt (nicht interaktiv); behält reichhaltigere Ausgabe als `-z` bei, wenn Tools laufen.
`hermes -z "..."`	Skriptbasierter One-Shot — nur finale Antwort auf stdout, keine Banner oder Sitzungsgeräusche. Derselbe Agent und Tools; ideal für Pipes und Skripte.
`hermes chat --quiet`, `-Q`	Leiserer programmatischer Modus (Banner und Tool-Vorschauen unterdrückt).
`-m` / `--model`, `--provider`	Modell- und Provider-Überschreibungen pro Lauf; Umgebungsvariablen `HERMES_INFERENCE_MODEL` / `HERMES_INFERENCE_PROVIDER` spiegeln dieses Verhalten wider.
`-t` / `--toolsets`	Komma-getrennte Toolsets für den Lauf aktivieren.
`-s` / `--skills`	Skills vorladen (wiederholbar oder kommagetrennt).
`--image path`	Lokales Bild an eine einzelne Abfrage anhängen.
`--checkpoints`	Dateisystem-Checkpoints vor zerstörerischen Bearbeitungen aktivieren.
`--max-turns N`	Tool-Aufruf-Iterationen pro Turn begrenzen (Standard aus Konfiguration).
`--source`	Sitzungs-Quellentag (`cli` vs `tool` für Integrationen).

Hermes Modell außerhalb der Sitzung vs /model innerhalb — Das Ausführen von hermes model aus der Shell ist der Ort, an dem Sie Provider, Keys und OAuth hinzufügen. Slash /model wechselt nur zwischen bereits konfigurierten Providern. Wenn Sie nur OpenRouter in /model sehen, beenden Sie die Sitzung und schließen Sie hermes model ab.

Modell-Auswahl, Credential-Pools und Fallback-Provider

Befehl	Beschreibung
`hermes model`	Interaktiver Provider- und Modell-Auswahl; Keys, OAuth, benutzerdefinierte Endpunkte.
`hermes auth`	Credential-Pools — `add`, `list`, `remove`, `reset` für rotationsfreundliche Keys und OAuth.
`hermes fallback [list \| add \| remove \| clear]`	Geordnete Fallback-Provider verwalten, wenn der Primärprovider Fehler oder Rate-Limits meldet.
`hermes setup [model \| tts \| terminal \| gateway \| tools \| agent] [...]`	Abschnittsweises oder vollständiges interaktives Setup (`--quick`, `--reset`, `--non-interactive`).

Veraltet hermes login / hermes logout — verwenden Sie stattdessen hermes auth und hermes model.

Die Wahl zwischen lokalen OpenAI-kompatiblen Endpunkten und gehosteten APIs für hermes model unterliegt denselben Abwägungen wie bei allgemeiner LLM-Hosting (Latenz, Kosten, Betrieb).

Konfigurationsdateien und `hermes config`-Befehle

Konfiguration löst sich auf als CLI-Überschreibungen → config.yaml → .env → Standards. API-Keys gehören in .env; strukturierte Einstellungen in config.yaml.

Befehl	Beschreibung
`hermes config show`	Effektive Konfiguration anzeigen.
`hermes config edit`	`config.yaml` in `$EDITOR` öffnen.
`hermes config set key value`	Werte setzen (Secrets werden nach `.env` geroutet, Nicht-Secrets nach YAML).
`hermes config path` / `hermes config env-path`	Pfade zu Konfigurations- und Env-Dateien ausgeben.
`hermes config check`	Fehlende oder veraltete Einstellungen erkennen.
`hermes config migrate`	Neuen Optionen interaktiv anwenden.

Wo Dateien liegen — Alles befindet sich unter HERMES_HOME (Standard ~/.hermes) für Konfiguration, Secrets, Memories, Skills, Sitzungen, Gateway-Zustand und Logs.

Sitzungsverwaltung und `hermes profile`

Befehl	Beschreibung
`hermes sessions list`	Letzte Sitzungen auflisten.
`hermes sessions browse`	Interaktiver Auswähler mit Suche und Fortsetzung.
`hermes sessions export`	Sitzungen exportieren (z.B. JSONL).
`hermes sessions delete`, `prune`, `rename`, `stats`	Eine Sitzung löschen, alte kürzen, Titel umbenennen, Store-Statistiken anzeigen.
`hermes profile list` \| `use` \| `create` \| `delete` \| `show` \| `rename`	Isolierte Hermes-Instanzen auf einer Maschine verwalten.
`hermes profile export` / `import`	Profil-Tarball archivieren oder wiederherstellen.
`hermes profile alias`	Kurze Wrapper-Skripte für schnelles Profil-Wechseln.

Verwenden Sie hermes -p work chat -q "..." für ad-hoc-Läufe, ohne das sticky-Standardprofil zu ändern.

Skills-Hub, Toolsets, Shell-Hooks und Plugins

Für profilbasierte Konfiguration und Skills, die auf echte Produktionsworkflows nach Rolle abgestimmt sind, siehe Hermes AI Assistant Skills für echte Produktionssetups.

Befehl	Beschreibung
`hermes tools`	Interaktive plattformbezogene Tool-Aktivierung; `--summary` gibt aktuelle Auswahl aus.
`hermes skills browse`, `search`, `inspect`, `install`, `list`, `check`, `update`, `audit`, `uninstall`, `publish`, `snapshot`, `tap`, `config`	Skills-Hub-Workflows einschließlich Registries und URL-Installationen.
`hermes curator status`, `run`, `pause`, `pin`, `rollback`, …	Hintergrund-Skill-Wartung und sicheres Rollback.
`hermes hooks list`, `test`, `revoke`, `doctor`	Deklarierte Shell-Hooks und Allowlists in der Konfiguration.
`hermes plugins`	Composite-UI oder Subbefehle zum Installieren, Aktivieren, Deaktivieren, Entfernen von Plugins.

Eingebautes Memory und `hermes memory`-Provider

Eingebaute MEMORY.md / USER.md bleiben aktiv; externe Provider fügen optionale Recall-Schichten hinzu. Um zu verstehen, wie diese Architektur in der Praxis funktioniert, lesen Sie Hermes Agent Memory System — Wie persistente KI-Memory tatsächlich funktioniert. Um externe Backends und Aktivierungs-Abwägungen zu vergleichen, siehe Agent Memory Provider im Vergleich — Honcho, Mem0, Hindsight und fünf weitere.

Befehl	Beschreibung
`hermes memory setup`	Interaktive Konfiguration externer Memory-Provider.
`hermes memory status`	Aktive Provider-Einstellungen anzeigen.
`hermes memory off`	Externen Provider deaktivieren; eingebaute Dateien bleiben erhalten.

Wenn ein Provider aktiv ist, kann er zusätzliche provider-spezifische Top-Level-Subbefehle registrieren — führen Sie hermes --help aus, um zu sehen, was heute verdrahtet ist.

Messaging-Gateway, DM-Pairing und Plattformen

Befehl	Beschreibung
`hermes gateway setup`	Interaktives Messaging-Plattform-Setup.
`hermes gateway run`	Vordergrund-Gateway (empfohlen auf WSL, Docker, Termux).
`hermes gateway start` \| `stop` \| `restart` \| `status`	systemd / launchd Service-Steuerung (`--all` betrifft jedes Profil-Gateway).
`hermes gateway install` \| `uninstall`	Benutzer-level Hintergrund-Service installieren oder entfernen.
`hermes pairing list` \| `approve` \| `revoke` \| `clear-pending`	DM-Pairing-Genehmigungen für Messaging-Bots.
`hermes whatsapp`	WhatsApp-Brücke-Pairing-Flow.
`hermes slack manifest`	Slack-App-Manifest mit Gateway-Slash-Parität generieren.

Auf WSL ist hermes gateway run innerhalb von tmux das resiliente Muster, wenn gateway start fehlschlägt.

Cron-Scheduler, Webhooks und Kanban

Befehl	Beschreibung
`hermes cron …`	Geplante Prompts erstellen, bearbeiten, pausieren, fortsetzen, ausführen, entfernen (`tick` für manuellen Scheduler-Pass).
`hermes webhook subscribe`, `list`, `remove`, `test`	Dynamische Webhook-Routen für ereignisgesteuerte Läufe.
`hermes kanban …`	Multi-Profil-Aufgabenboard, unterstützt von SQLite; `dispatch` steuert Worker.

`hermes doctor`, Logs, Backup und Nutzungs-Insights

Befehl	Beschreibung
`hermes doctor [--fix]`	Interaktive Diagnose und optionale Auto-Reparatur.
`hermes status [--all] [--deep]`	Knappes Status; tiefere Checks bei Bedarf.
`hermes dump [--show-keys]`	Paste-freundliches Setup-Zusammenfassung für Discord oder GitHub Issues.
`hermes debug share`	Redigiertes Debug-Bundle auf einen Paste-Service hochladen (oder `--local`).
`hermes logs [agent \| errors \| gateway \| list]`	Logs unter dem Profil-Log-Verzeichnis tailen und filtern.
`hermes backup`, `hermes import`	Zip-Snapshots von Home-Daten und Wiederherstellungspfade.
`hermes insights [--days N] [--source …]`	Token-, Kosten- und Aktivitäts-Analytics.

Wenn nach einem Upgrade etwas bricht, bilden hermes doctor, hermes status und hermes logs errors -f den schnellsten Triage-Loop.

MCP, ACP, Web-Dashboard und OpenClaw-Migration

Befehl	Beschreibung
`hermes mcp serve`	Hermes als MCP-Server ausführen.
`hermes mcp add`, `remove`, `list`, `test`, `configure`	MCP-Client-Verbindungen von Hermes aus verwalten.
`hermes acp`	Agent Client Protocol stdio-Server für Editoren (zusätzliche Installation kann erforderlich sein).
`hermes dashboard [--port …] [--host …]`	Lokales Web-Dashboard (`pip install hermes-agent[web]`).
`hermes claw migrate …`	OpenClaw-Style-Konfigurationen nach Hermes migrieren (`--dry-run`, Presets, optionale Secrets).

OpenClaw-Migration — hermes claw migrate liest Legacy-OpenClaw-Home-Verzeichnisse; um zu sehen, wie dieser Stack vor dem Umzug aussah, siehe die OpenClaw Fallstudie.

Slash-Befehle in der Hermes CLI-Sitzung

Tippen Sie / für Autocomplete. Befehle sind case-insensitive; Skills registrieren zusätzliche /skill-name-Routen. Die folgenden Tabellen sind eine kuratierte Teilmenge; für das vollständige Register siehe Offizielle Hermes Agent-Dokumentation am Ende dieses Artikels.

Sitzungsfluss, Hintergrundaufgaben und Ziele

Befehl	Beschreibung
`/new`, `/reset`	Neue Sitzungs-ID und Historie.
`/resume [name]`	Benannte Sitzung fortsetzen.
`/compress [focus]`	Manuelle Kontextkompression mit optionalem Fokus-Thema.
`/retry`, `/undo`	Letzten Turn wiederholen oder letzte Exchange fallen lassen.
`/title …`	Sitzung benennen für spätere `/resume`.
`/background …`, `/queue …`, `/steer …`	Paralleler Hintergrund-Lauf, queue-nächster Prompt, Mid-Loop-Nudge nach nächstem Tool.
`/goal …`	Persistentes Multi-Turn-Ziel mit Judge-Loop (`status`, `pause`, `resume`, `clear`).
`/branch`, `/fork`	Konversation verzweigen für alternative Exploration.

Modelle, Tool-Toggles, Skills und Reload

Befehl	Beschreibung
`/model … [--global]`	Modelle unter konfigurierten Providern wechseln; `--global` persistiert Standard.
`/tools …`, `/toolsets`	Sitzungs-Tool-Toggles und Toolset-Auflistung.
`/skills …`	Skills aus dem Chat heraus suchen, installieren und verwalten.
`/cron …`	Geplante Aufgaben-UI aus der CLI-Sitzung.
`/reload-mcp`	MCP-Server aus Konfiguration neu laden.
`/reload`	`.env` in die laufende Sitzung neu laden, ohne Neustart.

Nutzung, Hilfe und Beenden

Befehl	Beschreibung
`/usage`, `/insights`	Token- und Kosten-Sichtbarkeit; Analytics-Snapshot.
`/help`, `/quit`	Hilfe oder CLI beenden.

Messaging-Apps (Telegram, Discord, Slack und andere) exponieren einen überlappenden Slash-Set plus /approve, /restart, /commands und verwandte Gateway-only-Helfer — Plattform-Unterschiede sind in der Slash-Befehls-Referenz unter Offizielle Hermes Agent-Dokumentation unten dokumentiert.

Weitere nützliche Lektüre

Verwandte Seiten auf dieser Website (breiterer Kontext für Hermes und Terminal-Agents):

AI Systems — Selbst gehostete Assistenten, RAG und lokale Infrastruktur — Cluster-Übersicht und wie Assistenten in den Stack passen
AI Systems Memory — Memory-Hub und angrenzende Leitfäden
AI Developer Tools — Terminal- und IDE-Tooling-Landschaft
OpenCode Quickstart — ein weiterer terminal-first Agent zum ergonomischen Vergleich

Offizielle Hermes Agent-Dokumentation

Upstream-Dokumentation auf hermes-agent.nousresearch.com:

Tipp. Halten Sie hermes dump und hermes doctor --fix im Muskelgedächtnis — sie verwandeln vage “etwas ist kaputt”-Berichte in umsetzbare Diffs gegen ein bekannt-gutes Setup.