curl | bash ohne manuelles Python; ② hermes doctor mit ~12 Checks; ③ hermes gateway install für Telegram 7×24. Der GitHub-Stand liegt bei über 174.000 Stars — doch die häufigste Fehlannahme bleibt: Installation ≠ Betrieb. USER.md, Skills und SQLite liegen lokal unter ~/.hermes; für DSGVO-relevante Datenverarbeitung auf dediziertem Bare Metal zählt zusätzlich, wo der Gateway physisch läuft. Dieser Leitfaden liefert Umgebungsmatrix, sechsstufiges Runbook, Fehlertabelle und Host-Kennzahlen.
Warum Hermes Agent 2026 — und wie es sich von OpenClaw unterscheidet
Bei der Suche nach Open-Source-KI-Agent-Tutorials kreuzen sich Hermes Agent, OpenClaw, LangGraph und CrewAI. Die Trennlinie ist klar: Hermes ist ein persönlicher Bereitschafts-Agent auf Ihrer Maschine — USER.md, MEMORY.md und Skills unter ~/.hermes, Gateway für Kanäle. OpenClaw betont Multi-Channel-Hub und ClawHub-Ökosystem; LangGraph/CrewAI sind Orchestrierungs-Frameworks ohne fertige Persistenz.
Skill-Zinseszins: Wiederkehrende Aufgaben laden aus ~/.hermes/skills/. Community-Messungen: Skill-Anzahl von einstellig auf ~12 in 30 Tagen, Token auf ähnlichen Jobs ca. 38 % weniger — Effizienzindikator, kein Qualitätsscore.
Modellagnostisch: Anthropic, OpenAI, OpenRouter, GitHub Copilot, Ollama — Schlüssel in ~/.hermes/.env, Verarbeitung bleibt auf Ihrer Instanz.
MCP-Erweiterungen: Model Context Protocol für GitHub, Browser-Automatisierung und mehr.
Installations-Engpass: Einmal CLI reicht nicht — Gateway 7×24 ist Pflicht für Skill-Compounding. Host-Vergleich: Drei-Wege-Matrix; Speicherarchitektur: 3-Schichten-Guide.
Hermes Agent Anforderungen: macOS, Linux oder VPS?
| Parameter | Minimum | Empfohlen (Produktions-Gateway) |
|---|---|---|
| OS | macOS 12+, Ubuntu 20.04+, WSL2 | macOS 14+ (Apple Silicon) oder Ubuntu 24.04 LTS |
| Python / Node | Skript installiert 3.11 / Node 18+ | Skript-Default Node 22, kein sudo |
| RAM | 4 GB (nur API + Gateway) | 16 GB (Browser-Automatisierung + lokales 7B-Fallback) |
| Disk | ~1,5 GB (inkl. Skill-Cache) | ≥ 20 GB SSD |
| Netz | GitHub raw + LLM-API erreichbar | Stabile, niedrige Latenz |
| Host-Szenario | 7×24-Verfügbarkeit | Phase |
|---|---|---|
| Laptop zugeklappt | ≈ 60 %, Skill-Compounding bricht ab | Nur POC |
| x86 VPS 4 GB | ≈ 99,5 %, keine macOS-Skill-Pfade | Reine Linux-Nutzer |
| Mac Mini M4 Miete | Rechenzentrum-SLA, launchd nativ | Telegram-Produktion, Camoufox |
Hermes Agent Installation: sechsstufiges Runbook (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.zshrc
Headless-Server: bash -s -- --skip-browser. Das Skript installiert uv, Python 3.11, Node 22, ripgrep, ffmpeg, klont nach ~/.hermes/hermes-agent/ und schreibt hermes in PATH. Erfolgszeile: ✅ Hermes Agent installed at ~/.hermes.
Installationsskript: curl-Befehl oben. Windows hat install.ps1 — Produktion bevorzugt WSL2 + Linux-Skript.
Shell neu laden: source ~/.zshrc oder source ~/.bashrc behebt hermes: command not found.
Gesundheitscheck: hermes doctor prüft Python, Node, ripgrep, ffmpeg, PATH, API-Keys — ca. 12 Punkte. hermes --version zeigt v0.14.x oder v0.15-Kandidat.
LLM konfigurieren: hermes setup oder hermes model für OpenRouter / Anthropic / Ollama. Schlüssel in ~/.hermes/.env, z. B. hermes config set OPENROUTER_API_KEY sk-or-xxxx.
CLI-Smoke-Test: hermes starten, z. B. „Fasse heutige KI-News zusammen“ — Tool-Aufrufe und Routing prüfen.
Update & Migration: täglich hermes update; nach Upgrade hermes config check && hermes config migrate.
Hermes Agent Telegram: BotFather bis gateway install
CLI allein = lokaler Chat. Für mobile Aufträge brauchen Sie Gateway. Ablauf: @BotFather → /newbot → Token speichern → @userinfobot für numerische User-ID.
hermes gateway setup hermes gateway install hermes gateway start hermes gateway status
Der Wizard schreibt TELEGRAM_BOT_TOKEN und TELEGRAM_ALLOWED_USERS. Linux-Produktion: sudo hermes gateway install --system und journalctl -u hermes-gateway -f; macOS nutzt launchd-User-Service.
| Fehler / Symptom | Ursache | Behebung |
|---|---|---|
hermes: command not found | PATH nicht geladen | Terminal neu oder rc sourcen |
API key not set | Kein LLM konfiguriert | hermes model |
| Gruppe schweigt | Bot-Privatmodus | Group Privacy in BotFather aus, Bot rauswerfen und neu einladen |
ModuleNotFoundError: dotenv | System-Python | ~/.hermes/hermes-agent/venv/bin/hermes nutzen |
Hinweis: Nützlich auch hermes tools, hermes config check. MCP unter mcp_servers in ~/.hermes/config.yaml; headless: hermes mcp login + SSH-Tunnel für OAuth.
Nach der Installation: Skill-Compounding und Mac Mini M4 Kennzahlen
Star-Skala: Stand Juni 2026: hermes-agent ca. 174.720 Stars. Install- und Telegram-Docs iterieren am schnellsten auf dem macOS-Pfad.
Leistungsaufnahme: M4 idle 4–6 W; Gateway + Automatisierung typisch 15–25 W — geeignet für Dauerbetrieb.
Unified Memory: Bei 16 GB UMA Gateway-Residenz ca. 4 GB Klasse, gemeinsamer Adressraum mit Camoufox und SQLite WAL — weniger Swap als kleiner x86-VPS.
Zugeklapptes Notebook, Raspberry-Pi-I/O-Engpass oder Linux-VPS ohne macOS-Browser-Skills sind keine Installationsfehler — sondern falsche Host-Wahl mit Gateway-SLA unter 99 %. Für Telegram 7×24 mit wachsenden Skills ist MESHLAUNCH Mac Mini M4 Bare-Metal-Miete oft die sauberere Lösung: gleiches curl über SSH, launchd, und ~/.hermes vor Kündigung tarballen. Die Datenverarbeitung erfolgt auf dediziertem EU-Bare-Metal ohne Multi-Tenant-Nachbarschaft — relevant für Auftragsverarbeitung und interne Compliance. Mietpreise für Tages-POC; Grenzen in Hilfezentrum.
Nein. install.sh nutzt uv für Python 3.11 und Node 22. Bei doctor-Fehler prüfen, ob venv-hermes statt System-Python aufgerufen wird.
Nach Deaktivierung von Group Privacy in BotFather Bot aus Gruppe entfernen und neu einladen. TELEGRAM_ALLOWED_USERS prüfen. Optional M4 mieten für isolierten Gateway-Test.
Plattenspeicher bleibt, aber offline Gateway stoppt Skill-Compounding und Cron. Produktion: hermes gateway install auf 7×24-Host — siehe Speicherarchitektur.