2026 Hermes Agent Installationsanleitung: Vom Einzeiler-curl zum Telegram 7x24 Gateway auf macOS, Linux und Mac-Cloud (2026)

1. Für wen ist diese Installationsanleitung

Wenn Sie unseren Artikel zur Dreischicht-Speicher gelesen haben, wissen Sie bereits, warum Hermes einen Dauerbetrieb-Host braucht. Diese Seite liefert das wie: die konkreten Befehle aus dem Hermes-Agent-Repository von Nous Research bis zu einer funktionierenden Telegram-Brücke. Sie installieren mit dem offiziellen Skript, führen hermes doctor aus, bis Warnungen verschwinden, schließen hermes setup ab, legen Modelle mit hermes model fest, erstellen einen Bot bei BotFather und starten hermes gateway setup sowie hermes gateway install, damit Nachrichten auch nachts ankommen. Abgedeckt sind macOS mit launchd, Linux-VPS mit systemd und per SSH erreichbare Mac-Cloud-Knoten – ohne dass Sie bereits einen Mac mini besitzen müssen. Für TCO und Hardwarewahl nach der Installation verweisen wir auf den Pi- vs. VPS- vs. Mac-mini-Vergleich.

Die Reihenfolge ist bewusst linear: jeder Schritt hat ein sichtbares Ergebnis (Version, grüner Doctor, erste CLI-Antwort, Telegram-Reply, Dienststatus nach Reboot). So vermeiden Sie den typischen Fehler, alles auf einmal zu konfigurieren und bei der ersten Stille nicht zu wissen, ob Modell, Gateway oder Host schuld ist.

2. Schmerzpunkte vor dem curl-Befehl

1. Installation klappt, Gateway nicht. Fehlende API-Keys, falscher terminal.backend oder Portkollisionen mit anderen Agenten lassen Telegram stumm, obwohl hermes --version funktioniert.
2. Telegram-Token auf einem schlafenden Laptop. BotFather liefert in Sekunden ein Token; Long-Polling oder Webhook-Zustellung braucht einen Prozess, der nie suspendiert – MacBooks im Alltag und WSL2 unter Windows verletzen das täglich.
3. Linux-VPS läuft, kämpft aber mit macOS-Workflows. Hermes unterstützt sieben Terminal-Backends und über 20 Kanäle auf Linux, doch Skills mit Xcode, Keychain oder Apple-Benachrichtigungen drängen zu nativem macOS oder einem gemieteten Mac-Knoten.

Viele Teams verbringen einen halben Tag mit Debugging, obwohl der Installer grün war – weil Gateway, Modellrouting und Dauerbetrieb drei getrennte Probleme sind. Diese Anleitung trennt sie in messbare Schritte mit Abnahmetests nach jedem Block.

3. Plattformvergleich: MacBook vs. Pi vs. VPS vs. Mac-mini-Miete

Die Tabelle hilft bei der Wahl des Hosts für das Runbook unten – nicht bei der Frage, ob Hermes sich lohnt. Die meisten produktiven Telegram-Brücken landen auf einem dedizierten Linux-VPS mit systemd oder einem gemieteten Mac mini M4, weil beide online bleiben, ohne Ihr Pendler-Laptop zu belasten. Für DSGVO-sensible Teams zählt oft, dass ein gemieteter dedizierter Mac in der EU betrieben werden kann, während Shared-VPS Nachbarlärm mitbringen.

4. Referenzwerte (2026)

Diese Zahlen rechtfertigen Hardware gegenüber Finanz oder dem eigenen Gewissen:

• Installer-Abdeckung: offizielles install.sh für macOS, Linux und WSL2; ein Gateway-Prozess kann laut Nous-Dokumentation über 20 Messaging-Kanäle anbinden.
• Modellfläche: OpenRouter bietet 300+ Modelle; lokale Ollama- oder LM-Studio-Routen bei ausreichend RAM – planen Sie mindestens 16 GB auf Apple Silicon für 8B–13B-Nebenrouting plus Gateway-Overhead.
• Terminal-Backends: sieben dokumentierte Modi – die meisten Telegram-only-Nutzer bleiben auf local, bis Sandbox-Tools nötig werden.

Wer Skills langfristig aufbauen will, sollte ~/.hermes in verschlüsselte Backups aufnehmen: Skill-Dokumente überleben Neustarts, flüchtiger Sitzungskontext im RAM nicht.

5. Sieben-Schritte-Installations-Runbook

Schritt 1 — Host wählen und Basispakete

Unter macOS Xcode Command Line Tools installieren (xcode-select --install). Auf Ubuntu/Debian-VPS curl, git und build-essential. Dedizierten Unix-Benutzer hermes ohne Produktionsschlüssel anlegen. Ausgehendes HTTPS und für Telegram-Webhooks eine stabile öffentliche IP oder einen Reverse-Tunnel planen.

Schritt 2 — Einzeiler-Installation von upstream

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
exec $SHELL
hermes --version

Shell neu öffnen, damit PATH greift. Auf einem gemieteten Mac-Cloud-Knoten installieren Sie per SSH genauso wie lokal – es gibt keine separate Cloud-Edition.

Schritt 3 — Doctor, dann interaktives Setup

hermes doctor
hermes doctor --fix   # Diffs prüfen vor Annahme
hermes setup

hermes doctor findet fehlende Node-Binaries, unset API-Keys und Gateway-Portkonflikte. hermes setup führt durch Standardpfade unter ~/.hermes. Provider-Keys möglichst per Umgebungsvariable statt Klartext in Config-Dateien setzen.

Schritt 4 — Modelle festlegen

hermes model list
hermes model set default openrouter/anthropic/claude-sonnet-4
hermes config set inference.ollama.base_url http://127.0.0.1:11434

Ein schnelles Modell für Klassifikation und ein schweres für mehrstufige Skills. Gemischtes lokal + Cloud hält Telegram reaktionsfähig ohne explodierende API-Rechnungen.

Schritt 5 — Telegram via BotFather

In Telegram @BotFather öffnen, /newbot ausführen, HTTP-API-Token kopieren und erlaubte Chats einschränken. Token im Secret Manager speichern, dann exportieren:

export TELEGRAM_BOT_TOKEN="123456:ABC..."
hermes gateway setup

Prompts für Kanal-Pairing folgen. Webhook-Modus braucht HTTPS-Terminierung; Long-Polling erfordert weiterhin einen Dauerprozess.

Schritt 6 — Gateway-Dienst installieren

hermes gateway install
hermes gateway status

Unter macOS typischerweise ein LaunchAgent; unter Linux eine systemd-User-Unit. Dienstnamen mit hermes gateway status prüfen, bevor Sie SSH beenden.

Schritt 7 — Abnahme-Smoke-Tests

hermes gateway restart
hermes cron add "0 7 * * *" "Send heartbeat: Gateway alive"

Host einmal neu booten. Antwortet Telegram weiter und feuert der Cron-Job, haben Sie echtes 7x24-Verhalten. ~/.hermes vor OS-Upgrades verschlüsselt sichern.

6. launchd vs. systemd für 7x24-Gateway

macOS (launchd): LaunchAgent unter ~/Library/LaunchAgents/ mit KeepAlive und rotierten Logs unter ~/Library/Logs/hermes/. Nach Config-Änderungen:

launchctl kickstart -k gui/$(id -u)/com.nousresearch.hermes.gateway
launchctl print gui/$(id -u)/com.nousresearch.hermes.gateway | grep state

Linux (systemd): Linger für Benutzer hermes (loginctl enable-linger hermes), dann systemctl --user enable --now hermes-gateway.service. Prüfen mit systemctl --user status hermes-gateway. systemd ist auf VPS exzellent; Keychain- und Apple-Notification-Integration entfällt, unless ein Mac-Knoten für Apple-Skills bleibt.

7. Fehlertabelle

8. FAQ

Installation auf WSL2? Ja für Experimente; Windows-Sleep bricht 7x24-Telegram, unless das Gateway woanders läuft. Löscht Reboot Skills? Skill-Dokumente auf Disk bleiben; RAM-Sitzungskontext weg – ~/.hermes vor Migration sichern. Muss es Telegram sein? Nein – hermes gateway setup deckt auch Slack und Discord ab; Telegram ist der schnellste Smoke-Test.

9. Fazit

Ein MacBook reicht für Schritte 1–5 an einem Nachmittag, aber Deckel zu und heimisches ISP machen es als Langzeit-Telegram-Host ungeeignet. Raspberry-Pi-Kits sparen Geld, kämpfen aber mit RAM. Fünf-Dollar-VPS bleiben online, bringen systemd-Reibung und keine native macOS-Toolchain. Nach grünem hermes doctor und BotFather-Pairing gilt: hermes gateway install auf Hardware, die nie suspendiert – für die meisten Leser launchd auf einem Mac mini M4, gekauft oder gemietet.

VPSMAC Apple-Silicon-Mac in der Cloud mieten bündelt planbare Monatskosten, SSH, optionales Screen Sharing und Löschung bei Rückgabe. Gleiche Install-Befehle wie am Schreibtisch-mini; nur die Shell läuft im Rechenzentrum. Das ist der schnellste Weg vom Einzeiler-curl zu einem Telegram-Agenten um 3 Uhr morgens – ohne Ihr Alltags-Laptop an Gateway-Uptime zu binden.