Wie ist die Standardmethode, um einen interaktiven Chat mit dem Hermes-Agenten zu starten?

Nach der Installation führen Sie hermes oder hermes chat in Ihrer Shell aus. Dadurch wird der interaktive Agent mit Ihrem konfigurierten Standardmodell, Toolsets und 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 als reiner Endtext ohne Banner oder Sitzungszeilen ausgegeben wird. Falls Sie Tool-Output im Transkript benötigen, verwenden Sie stattdessen hermes chat -q.

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

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

Wo speichert Hermes Agent Konfigurationen und Geheimnisse auf der Festplatte?

State wird unter HERMES_HOME (üblicherweise ~/.hermes) gespeichert, mit config.yaml für Einstellungen, .env für Secrets und Authentifizierungsdaten, sowie Ordnern für Sessions, Skills, Memory, Cron und Logs.

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

Führen Sie hermes doctor für Korrekturen, hermes status für einen Statusausschnitt, hermes dump für eine paste-freundliche 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 innerhalb von tmux, anstatt sich auf den Hintergrundstart von 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-Setups auf einer Maschine aus?

Verwenden Sie das Hermes-Profile-Feature, 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-Status beibehält.

Hermes Agent CLI-Referenz — Befehle, Flags und Schrägstrich-Shortcuts

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

Inhaltsverzeichnis

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

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

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

Diese Pfade nutzen dieselbe Konfiguration und dieselben Daten unter ~/.hermes; diese Seite listet 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 des Hermes-Agenten und CLI-Befehle für den ersten Start

Für Installation und Fehlerbehebung beginnen Sie mit Hermes AI Assistant — Installation, Einrichtung, Workflow und Fehlerbehebung.

Der Installer lädt das Repository herunter, 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`	Startet den interaktiven Chat nach der Installation (täglicher Standardzugang).
`hermes --version` / `hermes version`	Gibt Versionsinformationen aus.
`hermes completion bash` \| `zsh` \| `fish`	Generiert Shell-Vervollständigungsskripte für Tab-Vervollständigung.
`hermes update [--check] [--backup] [--restart-gateway]`	Lädt den neuesten Code, installiert Abhängigkeiten neu; optionaler Snapshot des Home-Verzeichnisses vor dem Update oder Gateway-Neustart.
`hermes uninstall [--full] [--yes]`	Entfernt Hermes; optionale vollständige Datenlöschung.

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

Globale Flags für jede `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`	Wählt das Hermes-Profil für diesen Lauf aus (überschreibt das sticky-Standardprofil von `hermes profile use`).
`--resume`, `-r`	Nimmt eine Sitzung nach ID oder Titel wieder auf.
`--continue [name]`, `-c`	Führt die neueste Sitzung fort oder die neueste, die einem Titel entspricht.
`--worktree`, `-w`	Startet in einem isolierten Git-Worktree für parallele Agenten.
`--yolo`	Umgeht Genehmigungsabfragen für gefährliche Befehle (mit Vorsicht verwenden).
`--pass-session-id`	Beinhaltet die Sitzungs-ID im System-Prompt.
`--ignore-user-config`	Überspringt `~/.hermes/config.yaml` (nur Standardeinstellungen); `.env` wird weiterhin geladen.
`--ignore-rules`	Überspringt die automatische Injektion von AGENTS.md, SOUL.md, `.cursorrules`, Speicher und vorab geladenen Skills.
`--tui`	Startet die TUI (`HERMES_TUI=1` äquivalent).
`--dev`	Führt bei `--tui` TS-Quellen via `tsx` für die TUI-Entwicklung aus.

Isolierte Automatisierung paart 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, Fortsetzung, Worktree, Checkpoints.
`hermes chat -q "..."`	One-Shot-Prompt (nicht interaktiv); behält reichhaltigere Ausgabe als `-z`, wenn Tools ausgeführt werden.
`hermes -z "..."`	Skriptbasierter One-Shot — nur die finale Antwort auf stdout, keine Banner- oder Sitzungsrauschen. Gleicher 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`	Aktiviert komma-getrennte Toolsets für den Lauf.
`-s` / `--skills`	Lädt Skills vorab (wiederholbar oder komma-getrennt).
`--image path`	Fügt einem einzelnen Query ein lokales Bild hinzu.
`--checkpoints`	Aktiviert Dateisystem-Checkpoints vor zerstörerischen Bearbeitungen.
`--max-turns N`	Begrenzt die Anzahl der Tool-Aufruf-Iterationen pro Runde (Standard aus Konfiguration).
`--source`	Sitzungs-Quellen-Tag (`cli` vs `tool` für Integrationen).

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

Modellauswahl, Credential-Pools und Fallback-Provider

Befehl	Beschreibung
`hermes model`	Interaktiver Provider- und Modellauswahl; Keys, OAuth, benutzerdefinierte Endpunkte.
`hermes auth`	Credential-Pools — `add`, `list`, `remove`, `reset` für rotierbare Keys und OAuth.
`hermes fallback [list \| add \| remove \| clear]`	Verwaltet geordnete Fallback-Provider, wenn der primäre Provider Fehler wirft oder Rate-Limits erreicht.
`hermes setup [model \| tts \| terminal \| gateway \| tools \| agent] [...]`	Abschnittsweise oder vollständige interaktive Einrichtung (`--quick`, `--reset`, `--non-interactive`).

Veraltete 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 der allgemeinen LLM-Hostierung.

Sobald Ihr Standard auf Qwen oder Gemma auf etwas wie Ollama terminiert, sind Sampler-Standardwerte genauso wichtig wie die Modells-ID, die Sie eingegeben haben; aggregierte agentenorientierte Temperatur- und Penalty-Presets finden Sie in Agentenorientierte LLM-Inferenzparameter für Qwen und Gemma.

Konfigurationsdateien und `hermes config`-Befehle

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

Befehl	Beschreibung
`hermes config show`	Zeigt die effektive Konfiguration an.
`hermes config edit`	Öffnet `config.yaml` in `$EDITOR`.
`hermes config set key value`	Setzt Werte (Secrets werden nach `.env` geroutet, Nicht-Secrets nach YAML).
`hermes config path` / `hermes config env-path`	Gibt Pfade zu Konfigurations- und Env-Dateien aus.
`hermes config check`	Erkennt fehlende oder veraltete Einstellungen.
`hermes config migrate`	Wendet neu eingeführte Optionen interaktiv an.

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

Sitzungsverwaltung und `hermes profile`

Befehl	Beschreibung
`hermes sessions list`	Listet recente Sitzungen auf.
`hermes sessions browse`	Interaktiver Auswähler mit Suche und Fortsetzung.
`hermes sessions export`	Exportiert Sitzungen (z. B. JSONL).
`hermes sessions delete`, `prune`, `rename`, `stats`	Löscht eine Sitzung, entfernt alte, benennt Titel um, zeigt Speicherstatistiken.
`hermes profile list` \| `use` \| `create` \| `delete` \| `show` \| `rename`	Verwaltet isolierte Hermes-Instanzen auf einer Maschine.
`hermes profile export` / `import`	Archiviert oder stellt ein Profil-Tarball wieder her.
`hermes profile alias`	Kurze Wrapper-Skripte für schnelles Profilwechseln.

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. Für das Schreiben und Debuggen von SKILL.md-Dateien — Metadaten, progressive Offenlegung und konditionale Sichtbarkeit — siehe Hermes Agent Skill Authoring — SKILL.md Struktur und Best Practices.

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 Registern und URL-Installationen.
`hermes curator status`, `run`, `pause`, `pin`, `rollback`, …	Hintergründige Skill-Wartung und sicheres Rollback.
`hermes hooks list`, `test`, `revoke`, `doctor`	Deklarierte Shell-Hooks und Allowlists in der Konfiguration.
`hermes plugins`	Komposite UI oder Subbefehle zum Installieren, Aktivieren, Deaktivieren, Entfernen von Plugins.

Eingebauter Speicher und `hermes memory`-Provider

Eingebaute MEMORY.md / USER.md bleiben aktiv; externe Provider fügen optionale Recall-Schichten hinzu. Für Details, wie diese Architektur in der Praxis funktioniert, lesen Sie Hermes Agent Memory System — Wie persistent AI-Speicher tatsächlich funktioniert. Um externe Backends und Aktivierungsabwägungen zu vergleichen, siehe Agent Memory Providers Compared — Honcho, Mem0, Hindsight und fünf weitere.

Befehl	Beschreibung
`hermes memory setup`	Interaktive Konfiguration externer Speicherprovider.
`hermes memory status`	Zeigt aktive Providereinstellungen an.
`hermes memory off`	Deaktiviert externen Provider; 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 verkabelt ist.

Messaging-Gateway, DM-Pairing und Plattformen

Befehl	Beschreibung
`hermes gateway setup`	Interaktive Einrichtung der Messaging-Plattform.
`hermes gateway run`	Vordergrund-Gateway (empfohlen auf WSL, Docker, Termux).
`hermes gateway start` \| `stop` \| `restart` \| `status`	systemd / launchd Service-Steuerung (`--all` betrifft das Gateway jedes Profils).
`hermes gateway install` \| `uninstall`	Installiert oder entfernt benutzerspezifischen Hintergrunddienst.
`hermes pairing list` \| `approve` \| `revoke` \| `clear-pending`	DM-Pairing-Genehmigungen für Messaging-Bots.
`hermes whatsapp`	WhatsApp-Bridge-Pairing-Flow.
`hermes slack manifest`	Generiert Slack-App-Manifest mit Gateway-Slash-Parität.

Auf WSL ist hermes gateway run innerhalb von tmux das resiliente Muster, wenn gateway start Probleme macht. Für End-to-End-Telefon-Workflows, die dieselbe Gateway-Schicht nutzen, siehe Hermes Sprachsteuerung von Ihrem Telefon. Für den Betrieb auf einem dedizierten Server mit einem separaten Desktop-Client folgen Sie Hermes Agent Headless Server und Remote Desktop Setup.

Cron-Scheduler, Webhooks und Kanban

Befehl	Beschreibung
`hermes cron …`	Erstellen, Bearbeiten, Pausieren, Fortsetzen, Ausführen, Entfernen geplanter Prompts (`tick` für manuellen Scheduler-Durchlauf).
`hermes webhook subscribe`, `list`, `remove`, `test`	Dynamische Webhook-Routen für ereignisgesteuerte Läufe.
`hermes kanban …`	Multi-Profile-Aufgabenboard, unterstützt durch SQLite; `dispatch` steuert Worker.

Wenn Sie praktische Konkurrenzmuster für hermes kanban auf selbst gehosteten Gateways benötigen, siehe Kanban in Hermes Agent für selbst gehostete LLM-Workflows.

`hermes doctor`, Logs, Backup und Nutzungseinblicke

Befehl	Beschreibung
`hermes doctor [--fix]`	Interaktive Diagnose und optionale Auto-Reparatur.
`hermes status [--all] [--deep]`	Kurzer Status; tiefere Checks bei Bedarf.
`hermes dump [--show-keys]`	Paste-freundliches Setup-Zusammenfassung für Discord oder GitHub Issues.
`hermes debug share`	Lädt redigiertes Debug-Bundle auf einen Paste-Service hoch (oder `--local`).
`hermes logs [agent \| errors \| gateway \| list]`	Tailt und filtert Logs im Log-Verzeichnis des Profils.
`hermes backup`, `hermes import`	Zip-Snapshots der Home-Daten und Wiederherstellungspfade.
`hermes insights [--days N] [--source …]`	Token-, Kosten- und Aktivitätsanalysen.

Wenn etwas nach einem Upgrade bricht, bilden hermes doctor, hermes status und hermes logs errors -f die schnellste Triagierungsschleife.

MCP, ACP, Web-Dashboard und OpenClaw-Migration

Befehl	Beschreibung
`hermes mcp serve`	Führt Hermes als MCP-Server aus.
`hermes mcp add`, `remove`, `list`, `test`, `configure`	Verwaltet MCP-Client-Verbindungen von Hermes.
`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 …`	Migriert OpenClaw-ähnliche Konfigurationen in Hermes (`--dry-run`, Presets, optionale Secrets).

OpenClaw-Migration — hermes claw migrate liest veraltete OpenClaw-Home-Verzeichnisse; für Details, 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 nicht case-sensitive; 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]`	Nimmt eine benannte Sitzung wieder auf.
`/compress [focus]`	Manuelle Kontextkompression mit optionalem Fokusthema.
`/retry`, `/undo`	Wiederholt letzte Runde oder verwirft letzten Austausch.
`/title …`	Benennt die Sitzung für spätere `/resume` um.
`/background …`, `/queue …`, `/steer …`	Paralleler Hintergrundlauf, wartender nächster Prompt, Mid-Loop-Anstoss nach nächstem Tool.
`/goal …`	Persistentes Multi-Turn-Ziel mit Judge-Loop (`status`, `pause`, `resume`, `clear`).

Modelle, Tool-Toggles, Skills und Neuladen

Befehl	Beschreibung
`/model … [--global]`	Wechselt Modelle zwischen konfigurierten Providern; `--global` persistiert Standard.
`/tools …`, `/toolsets`	Sitzungstool-Toggles und Toolset-Liste.
`/skills …`	Sucht, installiert und verwaltet Skills aus dem Chat.
`/cron …`	Geplante Aufgaben-UI aus der CLI-Sitzung.
`/reload-mcp`	Lädt MCP-Server aus der Konfiguration neu.
`/reload`	Lädt `.env` in die laufende Sitzung neu, ohne Neustart.

Nutzung, Hilfe und Beenden

Befehl	Beschreibung
`/usage`, `/insights`	Token- und Kostensichtbarkeit; Analytik-Snapshot.
`/help`, `/quit`	Hilfe oder Beendet die CLI.

Messaging-Apps (Telegram, Discord, Slack und andere) bieten einen überlappenden Slash-Satz plus /approve, /restart, /commands und verwandte Gateway-nur-Helfer an — Plattformunterschiede sind im Slash-Befehls-Register unter Offizielle Hermes Agent Dokumentation unten dokumentiert.

Weitere nützliche Lektüre

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

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

Offizielle Hermes Agent Dokumentation

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

Tipp. Behalten Sie hermes dump und hermes doctor --fix im Muskelgedächtnis — sie verwandeln vage „etwas ist kaputt“-Berichte in umsetzbare Diffs gegenüber einem bekannten guten Setup.