2026 Hermes Agent Installationsleitfaden: macOS / Linux / WSL2 One-Liner, Telegram Gateway & 24/7 Troubleshooting

Sechs Install-Fallen: warum nur README oft scheitert

Ende Mai 2026 lieferte Nous Research v0.15.2 mit pip install hermes-agent und curl | bash. Stars aendern sich woechentlich; Forenbeitraege ueberspringen die Reibung der ersten Stunde. Nutzen Sie die Liste als Pre-Flight, bevor Sie neu installieren.

1. PATH nicht geladen: ohne source ~/.zshrc erscheint hermes: command not found trotz erfolgreicher Installation — haeufigster Fehlalarm.
2. System-Python vs. venv: python3 -m hermes kann dotenv vermissen. Unterstuetzter Einstieg: ~/.hermes/hermes-agent/venv/bin/hermes.
3. Nur CLI: ohne hermes setup / hermes model sofort API key not set.
4. Gateway vs. CLI: Telegram braucht hermes gateway als Dauerprozess; einmalige CLI-Chats erreichen das Handy nicht.
5. Telegram Group Privacy: neue Bots reagieren in Gruppen nur auf Slash-Befehle — ohne BotFather-Fix wirkt der Bot „kaputt“.
6. Halbe Migration: v0.14→v0.15 erfordert hermes config check && hermes config migrate vor Missing config after update-Debugging.

OpenClaw punktet bei Multi-Channel-Gateway und npm/Docker-Compose; Hermes bei MEMORY.md/USER.md, Skill-Synthese und MCP. Dieser Artikel bleibt in der Install-Spur; Speicher-TCO steht in den verlinkten Hermes-Posts.

DSGVO-relevant schon bei Installation: Hermes legt Sessions, Skills und Nutzerprofile unter ~/.hermes/ lokal ab — kein eingebautes Produkt-Telemetrie-Backend. Personenbezogene Inhalte in Prompts oder USER.md erfordern trotzdem Verzeichnis der Verarbeitungstaetigkeiten, Zugriffskontrolle und AVV mit LLM-Anbietern. Auf geteilten VPS ohne Mandantentrennung scheitert Art. 32 DSGVO; dedizierte MACCOME-Instanzen mit FileVault-at-rest sind der uebliche EU-Pfad fuer Agent-Speicher.

Umgebung: was wirklich auf der Platte liegen muss

Der Installer bringt Python 3.11 (uv), Node 22, ripgrep, ffmpeg mit. Sie brauchen git, HTTPS zu GitHub raw und Ihrem LLM, plus Platz fuer Skills und SQLite-WAL. Headless ohne Browser: --skip-browser spart RAM und GB.

Remote-Mac-Knoten verhalten sich wie lokal: SSH, gleiche Befehle, danach launchd/systemd. RTT zur API-Region dominiert bei Cloud-Modellen; Unified Memory hilft bei Camoufox und mehreren Gateways.

WSL2: Hermes auf ext4 innerhalb WSL, nicht unter /mnt/c. Windows-Sleep waehrend Gateway-Nachttests erklaert viele falsche Linux-Bugs. Migration: tarball ~/.hermes auf dedizierten Linux- oder Miet-Mac-Knoten.

8 Schritte: vom One-Liner bis Telegram online

Identisch auf macOS, Linux, WSL2. Jeden Gate pruefen — hermes doctor ueberspringen kostet meist laenger.

1. One-Liner: offizielles Skript (bash-Block). Erfolg: Meldung zu ~/.hermes.
2. Shell: source ~/.zshrc oder neues Terminal.
3. Doctor: ~12 Checks; hermes --version → v0.15.x.
4. Modelle: hermes setup oder Keys in ~/.hermes/.env.
5. Smoke: hermes mit leichtem Tool-Aufruf (Verzeichnisliste).
6. Telegram-Bot: @BotFather /newbot; numerische ID via @userinfobot.
7. Gateway: hermes gateway setup oder Env TELEGRAM_BOT_TOKEN, TELEGRAM_ALLOWED_USERS.
8. Daemon: Test hermes gateway; Produktion hermes gateway install && hermes gateway start.

Schritt 8 trennt „installiert“ von „produktiv“. Vordergrund-Gateway stirbt mit SSH ohne tmux; User-launchd auf macOS ueberlebt Logout. Erst DM testen, dann Gruppen — zwei Variablen weniger.

LLM-Auswahl 2026 (datenbasiert)

OpenRouter: schnellste Multi-Model-Experimente. Anthropic: Enterprise-Standard in hermes model. Nous Portal: hermes setup --portal. Ollama: fuer DSGVO-kritische Teilmengen ohne Drittland-Prompt-Transfer fuer lokale 7B-Runs. Grok/x_search nur bei Bedarf in hermes tools aktivieren — Token-Budget messbar halten.

Keys zentral in ~/.hermes/.env, nicht nur in Shell-Exports — Gateway und CLI teilen eine Quelle. Telegram: Token nie in Git; TELEGRAM_ALLOWED_USERS nur numerische IDs; getrennte Bots pro Umgebung.

Harte Kennzahlen: Version, Stars, Skill-Compounding

• GitHub Stars (Snapshot 2026-06): ca. 174.720, MIT — Tag auf Releases pruefen (v0.15.2 / 2026.5.29.2).
• Fussabdruck: ~1,5 GB mit Skills; Gateway-RSS oft ~4,2 GB mit Browser-Automation — auf Apple-UMA glatter.
• Skill-Compounding (30-Tage-Bericht): Skills 3→19, ~38 % weniger Token auf Wiederhol-Tasks — nur bei 24/7-Uptime.

Stars ≠ Betriebsreife. Fuer Management: 38 %-Token plus Gateway-Uptime-% und Telegram-p50 — nicht Stars allein. Unter 90 % Uptime im ersten Monat sind Skill-Einsparungen hypothetisch.

Zwoelf haeufige Fehler

Erste Woche: Tabelle zuerst; sonst hermes doctor + Gateway-Logs vor GitHub-Issue.

Plattform-Matrix: Laptop, VPS, gemieteter Mac Mini M4

Install-OK ≠ Produktion. Telegram + Skill-Loop brauchen Host-Verfuegbarkeit. MacBook: Schritte 1–5 ok, Schritt 8 scheitert an Sleep/Reisen. VPS: Uptime, aber oft ohne macOS-curl | bash und Camoufox-Pfad. Pi: ~88 % Hobby-Uptime, I/O-Timeouts bei langen Agent-Runs. MACCOME Mac Mini M4 Miete: echtes macOS, Rechenzentrum, launchd wie in diesem Runbook.

TCO Miete vs. Kauf: Strom, Kuehlung, statische IP, physisches Risiko, Ihr macOS-On-call — nicht nur MSRP. Viele Teams: Produktion gemietet, Laptop nur SSH.

Abschluss: Install ist Schritt 1 — Uptime macht den Agent guenstiger

Mit den 8 Schritten erreichen die meisten Teams in 30–60 Minuten erste CLI- und Telegram-Antwort (bei freigegebenen API-Keys). Danach dominieren Betrieb: Sleep, Token-Rotation ohne Gateway-Restart, RAM unter Browser-Skills.

(a) Laptop nicht 24/7. (b) Kleiner x86-VPS ohne macOS/Camoufox-Pfad. (c) Kauf verschiebt Capex und Heimnetz auf Sie.

Wenn Hermes repetitive Arbeit spart und Sie planbare Monatskosten, SSH in Minuten und tarball ~/.hermes/ vor Hostwechsel brauchen — plus DSGVO-freundlicher lokaler Speicher auf dediziertem EU-Host — ist ein MACCOME Mac Mini M4 die uebliche Produktionsform. Weiter: Architektur, 30 Tage, Region auf Mietpreisen.