2026 Hermes Agent Installations-Leitfaden:
macOS / Linux + Telegram Gateway 7×24

Wer 2026 den Open-Source-Hermes Agent von Nous Research evaluiert, scheitert selten am Prompt-Design, sondern an der Kette aus Installations-Skript, Python-/Node-Abhängigkeiten, LLM-API-Key, Telegram-Bot und Gateway-Dienst. Dieser Beitrag richtet sich an Entwickler und kleine Teams, die Hermes auf macOS, Linux oder WSL2 von „läuft im Terminal“ bis „Telegram jederzeit erreichbar, Host 7×24 online“ bringen wollen: zuerst sechs typische Installations-Irrtümer, dann Umgebungstabelle und Host-Matrix, anschließend kopierbare Befehle für curl | bash, hermes doctor, hermes setup und Telegram Gateway (mindestens acht Schritte). Gedächtnisarchitektur und Kauf-/Miet-TCO stehen in unserem Dreistufiges-Gedächtnis-Artikel und der 24-Monats-TCO-Analyse. Mietpreise auf der NOVAKVM-Mietpreisseite, Bestellung über Bestellseite. Befehle und Versionen gemäß offizieller Dokumentation — nach jedem Release Links erneut öffnen. EU-Teams, die personenbezogene Inhalte in ~/.hermes/ oder über Cloud-LLM-APIs verarbeiten, sollten Aufbewahrung, Export und dokumentierte Löschung bei Vertragsende in ihre DSGVO-Dokumentation aufnehmen; technische Kontinuität ersetzt keine Rechtsberatung.

[ SECTION_01 ] // PAIN_MAP Die sechs häufigsten Missverständnisse bei der Hermes-Installation (2026)

• „Python 3.11 und Node 22 müssen vorher manuell installiert werden“: Das offizielle Skript zieht Laufzeiten über uv; Sie brauchen nur funktionierendes Git. Gemischte System-Python-Installationen lösen oft ModuleNotFoundError aus.
• „Nach der Installation antwortet der Bot sofort in Telegram“: CLI-Chat und Gateway sind getrennte Pfade; Kanäle erfordern hermes gateway setup plus einen laufenden Daemon.
• „hermes: command not found bedeutet fehlgeschlagene Installation“: Meist ist der PATH nicht aktualisiert — neues Terminal oder source ~/.zshrc, kein Voll-Reinstall nötig.
• „Jeder Linux-VPS ist wie ein Mac“: Die Dokumentation ist auf macOS am vollständigsten; Browser-Automatisierung und macOS-spezifische Skills verhalten sich auf reinem Linux anders — vor Produktion die Plattformhinweise lesen.
• „Der Bot antwortet in Gruppen nicht trotz @mention“: Im Telegram-Privacy-Modus reagieren Bots in Gruppen oft nur auf /-Befehle; Group Privacy in BotFather deaktivieren und Bot entfernen und erneut einladen.
• „Ein zugeklapptes MacBook reicht als Produktions-Gateway“: Sleep pausiert Prozesse; Skill-Komposition und Channel-Callbacks brauchen einen überwachten Always-On-Host — das ist mehr als „Installation erfolgreich“.

Offizielle Hermes-Einstiegspunkte — Installer-URL und Parameter nach jedem Release erneut prüfen:

Hermes Agent offizielle Installationsdokumentation (Nous Research)

NousResearch/hermes-agent (GitHub-Repository)

[ SECTION_02 ] // ENV_MATRIX Hermes Agent Anforderungen: Mindestspec und Deployment-Träger

Die Tabelle fasst pragmatische Untergrenzen für Lokalinstallation zusammen; ein Gateway, das nur Cloud-APIs nutzt, braucht weniger RAM als ein Setup mit lokalem Ollama. Preise und Verfügbarkeit stehen nicht in der Matrix — bitte Mietpreisseite öffnen.

Nur Installation testen? Ein Notebook genügt. Sollen Telegram und Skill-Komposition wochenlang durchlaufen, gehört das Gateway auf einen Produktions-Mac ohne Sleep.

Auf Apple Silicon profitiert Hermes von der dokumentierten macOS-Toolkette und Metal-beschleunigten Browser-Pfaden, wo Skills sie voraussetzen — auf Linux-VPS fehlt diese Schicht. Wer LLM-Aufrufe ausschließlich über Cloud-APIs routet, sendet Prompts und Antworten an Anbieter außerhalb der EU; das gehört in die Datenschutz-Folgenabschätzung neben der lokalen Speicherung unter ~/.hermes/.

[ SECTION_03 ] // INSTALL Hermes Agent One-Liner: curl-Skript, PATH und hermes doctor

Auf macOS, Linux, WSL2 oder Termux empfiehlt Nous Research diese Zeile (Repository-Klon nach ~/.hermes/hermes-agent/, globaler Befehl hermes):

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
hermes doctor
hermes --version

Headless-Server ohne Browser-Automatisierung können Browser-Abhängigkeiten überspringen (Parameter laut offizieller Doku):

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser

hermes doctor prüft Python, Node, ripgrep, ffmpeg, PATH und API-Keys; bei ❌ den Hinweisen folgen, nicht überspringen. Der native Windows-PowerShell-Installer ist frühe Beta — für Produktion bleibt WSL2 plus Linux-Befehle oben der stabilere Pfad (siehe Installation-Kapitel).

Das Skript legt das Git-Repository unter ~/.hermes/hermes-agent/ ab und registriert hermes in Ihrer Shell-Konfiguration. Nach Updates hermes doctor erneut ausführen, bevor Sie Gateway-Dienste neu starten — veraltete venv-Pfade sind eine häufige Ursache für scheinbar „kaputte“ Installationen nach einem Pull.

[ SECTION_04 ] // RUNBOOK Acht Schritte: Modell, CLI-Smoke-Test, Telegram und Gateway-Dauerbetrieb

1. Installation abschließen und PATH laden: Verzeichnis ~/.hermes vorhanden, dann hermes doctor ohne Blocker.
2. LLM konfigurieren: Einsteiger hermes setup; mit vorhandenem Key hermes model oder Einträge in ~/.hermes/.env (OpenRouter, Anthropic, OpenAI, Ollama Base URL).
3. CLI-Smoke-Test: hermes starten, echte Aufgabe testen (z. B. Dateitypverteilung im aktuellen Ordner), Tool-Kette und API-Abrechnung prüfen.
4. Telegram-Bot anlegen: @BotFather, /newbot, Token sichern; eigene numerische ID via @userinfobot.
5. Gateway-Konfiguration: hermes gateway setup mit Telegram wählen; alternativ TELEGRAM_BOT_TOKEN und TELEGRAM_ALLOWED_USERS setzen.
6. Gateway im Vordergrund testen: hermes gateway, Bot im Privatchat ansprechen, Antwort bestätigen, dann in den Hintergrund.
7. Daemon installieren: macOS hermes gateway install + hermes gateway start (launchd); Linux optional sudo hermes gateway install --system, Logs mit journalctl -u hermes-gateway -f.
8. Backup-Disziplin: ~/.hermes/ regelmäßig archivieren; bei Hostwechsel oder Mietende Verzeichnis wiederherstellen — nur Binaries neu zu installieren erzeugt „Amnesie“.

hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status

Für Gruppenchats die offizielle Messaging-Dokumentation zum Privacy-Modus lesen; nach Deaktivierung von Group Privacy Bot aus der Gruppe entfernen und erneut einladen.

Hermes Agent Telegram-Anbindung (GitHub)

[ SECTION_05 ] // TROUBLESHOOT Installations- und Gateway-Fehler: Symptom-Matrix

Führen Sie diese Schritte auf einem Remote-Mac aus, gilt die Verbindungs- und Sitzungs-Baseline im Hilfezentrum. Wer exklusives Apple Silicon und planbare Checkout-Löschung braucht, sollte monatliches Bare-Metal gegenüber Dauerbetrieb auf dem Privatnotebook abwägen.

[ SECTION_06 ] // HARD_FACTS Zitierbare Fakten und NOVAKVM-Abschluss

• Installer-Verhalten: Offizielles Skript installiert via uv Python 3.11, Node 22, ripgrep, ffmpeg und legt das Repository unter ~/.hermes/hermes-agent/ ab. (Quelle: Installation-Dokumentation — nach Release erneut prüfen.)
• Konfigurationswurzel: Umgebungsvariablen und Gateway-Tokens standardmäßig in ~/.hermes/.env; sitzungsübergreifendes Gedächtnis und Skills persistieren im selben Baum. (Quelle: Memory / Setup-Dokumentation.)
• Modellagnostisch: Hermes unterstützt Anthropic, OpenAI, OpenRouter, GitHub Copilot, Ollama u. a.; Modell-IDs und Abrechnung beim jeweiligen Anbieter prüfen.
• MCP-Erweiterung: mcp_servers in ~/.hermes/config.yaml, OAuth via hermes mcp login (headless oft mit SSH-Tunnel).
• Versionskontrolle: hermes --version und GitHub Releases maßgeblich; keine unbelegten Star-Zahlen oder Benchmark-Rankings aus Sekundärquellen übernehmen.

„Installiert“ ist der Anfang: Privatnotebooks eignen sich fürs Wochenend-POC, aber Sleep, Systemupdates und gemischte Privatdaten unterbrechen Gateway und Skill-Komposition. Reine Linux-VPS laufen auf der API-Route, verlieren aber bei Browser-Automatisierung und macOS-Tooling an Reibung. Wer Hermes in der CLI als langfristig wertvoll erkannt hat, fährt produktiver mit zunächst monatlich gemietetem exklusivem Mac mini M4, zwei bis vier Wochen Gateway-Logs, dann Entscheidung über Hardwarekauf.

Auf der NOVAKVM-Mietpreisseite Stufe nach Parallelität und Speicher wählen, über Bestellseite Knoten provisionieren, dann die acht Schritte dieses Artikels für Installation und Telegram-Dauerbetrieb. Für Hermes-Produktion mit nativem macOS-Installationspfad, launchd-Gateway 7×24 und planbarer Mietende-Löschung ist NOVAKVM Mac-mini-M4-Bare-Metal-Miete meist günstiger in Entscheidungskosten als das Hauptnotebook dauerhaft wach zu halten.