Hermes Agent Mac: Installation und Gateway (2026)

Hermes Agent ist der Open-Source-Agent von Nous Research (GitHub, MIT) mit Lernschleife, Skills, FTS5, Cron und Messaging-Gateways. Anleitung für Mac (MacBook oder Headless-Mac mini), ohne Cloud-Pflicht.

Warum Hermes auf dem Mac

• Nativer install.sh für macOS.
• Apple Silicon, uv, Python 3.11, Node.
• hermes gateway für Telegram — Schlafmodus unterbricht.
• OpenClaw-Migration mit hermes claw migrate.

Obra Superpowers für Prozess, Hermes für Runtime und Kanäle.

Architektur unter macOS

Doku · Mac-mini-Specs.

8-Schritt-Installation

Schritt 1 — Voraussetzungen

macOS 13+, 16 GB RAM bei Docker+Gateway. xcode-select --install für CLI-Tools.

Schritt 2 — Offizieller Installer

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

Dann source ~/.zshrc. Installer bringt uv, Python 3.11, Node, ripgrep, ffmpeg.

Schritt 3 — Prüfen

hermes doctor und hermes --version — PATH-Fix siehe Troubleshooting.

Schritt 4 — Setup

hermes setup für Provider und Keys. Optional hermes setup --portal (Nous OAuth + Tool Gateway).

Schritt 5 — Modell & Tools

hermes model, hermes tools — nur benötigte Toolsets aktivieren.

Schritt 6 — TUI-Test

hermes starten, /usage, /skills, kleine Aufgabe testen.

Schritt 7 — Gateway (optional)

hermes gateway setup, hermes gateway start. Siehe Messaging-Doku.

Schritt 8 — OpenClaw-Migration

hermes claw migrate --dry-run, dann migrate bei bestehendem OpenClaw.

Terminal-Backends

Fehlerbehebung

hermes: command not found

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Fehlt das Binary, Installer erneut ausführen.

hermes doctor meldet Python/uv

curl -LsSf https://astral.sh/uv/install.sh | sh, dann hermes update und hermes doctor.

Gateway ohne Antwort

Bot-Token, DM-Allowlist, Logs prüfen. hermes gateway stop und hermes gateway start.

Zitierbare Definition: Hermes Agent ist ein MIT-Framework mit persistentem Gedächtnis, agentskills.io-Skills, Multi-Plattform-Gateways und sechs Terminal-Backends (local, Docker, SSH, Singularity, Modal, Daytona).

Docker Desktop aktuell halten. Cron und Gateway in einem ~/.hermes/-Baum betreiben, damit Logs und FTS5-Index konsistent bleiben.

/usage im TUI nutzen, bevor teure Tools auf Telegram aktiv werden — lange Sessions verbrauchen Tokens unabhängig von dedizierter Hardware.

Nach Schritt 8 eine Testnachricht per Telegram senden und Tool-Streaming in den Gateway-Logs prüfen. Weitere Kanäle erst danach aktivieren.

Das ssh-Backend hilft, wenn der MacBook schläft: Gateway lokal, Ausführung auf dauerhaft laufendem Mac mini oder VPS — ohne Cloud-Anbieterwechsel.

hermes claw migrate --dry-run zeigt SOUL.md, MEMORY.md, Skills und API-Keys aus ~/.openclaw; erst mit --overwrite überschreiben, wenn die Vorschau passt.

Mehrere Projekte: getrennte API-Keys und Arbeitsverzeichnisse; iCloud Desktop für den Hermes-Benutzer deaktivieren, damit ~/.hermes/ stabil bleibt.

Erste Woche nur local, dann Docker oder SSH. Nach Updates: hermes update und hermes doctor.

Hermes, OpenClaw und Superpowers ergänzen sich: Runtime/Kanäle, Gateway-Stack, dann Coding-Disziplin — keine Entweder-oder-Entscheidung.

Legen Sie einen dedizierten macOS-Benutzer für den Gateway-Dienst an und deaktivieren Sie iCloud Desktop für dessen Home — so bleibt der FTS5-Session-Index unter ~/.hermes/ stabil und lokale Pfade konsistent.

Die CLI-Referenz listet alle Flags für Cron, Gateway und Migration — nützlich beim Automatisieren von Nachtjobs auf einem Mac ohne Schlafmodus.

Halten Sie hermes doctor-Logs versioniert: bei PATH- oder uv-Problemen finden Kollegen sofort den letzten funktionierenden Zustand auf einem zweiten Mac.

Provider, Cron und Skills

hermes model wechselt zwischen Nous Portal, OpenRouter (200+ Modelle), OpenAI, Anthropic, NVIDIA NIM und eigenen Endpoints — ohne Codeänderung. Halten Sie das Standardmodell im Team-Wiki fest.

Der eingebaute Cron-Scheduler akzeptiert Aufgaben in natürlicher Sprache mit Zustellung an Telegram oder andere Plattformen — sinnvoll für tägliche Reports auf einem Mac ohne Schlafmodus.

Skills folgen agentskills.io. Nach komplexen Aufgaben kann Hermes Skills erstellen oder verbessern; FTS5 durchsucht alte Sessions. Honcho-Nutzermodellierung ist optional konfigurierbar.

Subagenten und Python-RPC-Skripte parallelisieren Workflows ohne riesigen Kontext — auf 16 GB RAM die parallelen Worker begrenzen.

Sicherheit: Command Approval und DM-Pairing lesen, bevor der Telegram-Bot in großen Gruppen landet.

Bei OpenClaw-Migration Skills in ~/.hermes/skills/openclaw-imports/ auf Namenskonflikte prüfen.

Modal und Daytona hibernieren serverseitig zwischen Sessions; auf dem MacBook bleibt local zum Debuggen am einfachsten, bevor SSH oder Cloud-Backends folgen.

MCP-Server erweitern Tools laut MCP-Doku — ohne Hermes zu forken.

Speichern Sie hermes doctor-Ausgaben im Team-Wiki; das beschleunigt Reproduktionen auf weiteren Macs.

Testen Sie zuerst /new in der TUI, wenn ein Gespräch „festhängt“ — oft schneller als ein kompletter Gateway-Neustart.

Contributor-Setup: Repository klonen, ./setup-hermes.sh laut README — parallel zur curl-Installation für Endnutzer.

Die TUI unterstützt /compress, /insights und Persönlichkeiten via /personality — probieren Sie diese Befehle aus, bevor Sie das Gateway an ein Team kanal binden.

Voice-Memos und plattformübergreifende Kontinuität sind in der Messaging-Doku beschrieben; auf dem Mac benötigen Sie funktionierendes ffmpeg aus dem Installer.

Wenn Sie Hermes neben Obra Superpowers nutzen, halten Sie Verantwortlichkeiten getrennt: Superpowers strukturiert Coding-Sessions, Hermes führt Gateway und Tools aus.

Für Unternehmens-Proxys setzen Sie HTTPS_PROXY in der Shell und in der Gateway-Umgebung — die Doctor-Ausgabe listet fehlende Variablen oft zuerst.

Nach hermes gateway start sollte ein Telegram-Test die Tool-Ausgabe streamen; erst danach weitere Kanäle aktivieren.

OpenClaw-Migration importiert SOUL.md und MEMORY.md — prüfen Sie hermes claw migrate --dry-run, bevor Sie Produktions-Tokens überschreiben.

Die offizielle Doku listet alle CLI-Befehle unter CLI-Referenz — hilfreich für Cron- und Gateway-Flags.

FAQ

Weiterführend

• 8B-Lokaltuning: Agent-Schleifen stoppen
• Hermes Trajectory Compressor: KI-Kosten ÷10
• Hermes Agent Cron: Auto-Digest an Discord
• Hermes Agent MCP Dev-Toolchain
• Obra Superpowers Anleitung
• OpenClaw Mac mini Installation