Hermes Agent macOS Einrichtung: Installation, Gateway und launchd (2026)

Hermes Agent ist ein MIT-lizenzierter Agent von Nous Research mit einer Selbstverbesserungsschleife: Er erstellt Skills aus Erfahrung, hält Speicher durch periodische Nudges, durchsucht vergangene Sitzungen per FTS5 und modelliert Nutzerkontext über Honcho. Unter macOS installiert er sich als native CLI plus optionales Messaging-Gateway—Telegram, Discord, Slack, WhatsApp, Signal und E-Mail—aus einem hermes gateway-Prozess.

Dieser Leitfaden führt durch macOS-Setup auf Apple Silicon oder Intel—Installation, Erstkonfiguration, Gateway-Anbindung und Gateway-Betrieb mit launchd. Er setzt macOS 15+ auf einer Maschine voraus, die Sie kontrollieren (MacBook, Mac mini, Mac Studio oder per SSH erreichbarer Mac). Wenn Sie Agents bereits in der Cloud betreiben, siehe unser separates Hermes Mac mini M4 Anleitung für Headless-Host-Muster; die Befehle unten sind auf jedem Mac identisch.

Was Sie vor der Installation brauchen

Der Installer holt bei Bedarf uv, Python 3.11, Node.js, ripgrep und ffmpeg. Prüfen Sie danach mit hermes doctor.

Wie Hermes unter macOS aufgebaut ist

Nach der Installation liegt der Zustand unter ~/.hermes/:

~/.hermes/
├── config.toml          # Provider, Tools, Terminal-Backend, Gateway-Einstellungen
├── skills/              # Benutzer- und automatisch erstellte Skills
│   └── openclaw-imports/   # nach hermes claw migrate
├── memory/              # kuratierte Memory-Dateien
└── logs/                # Gateway- und CLI-Logs (Pfade laut Upstream-Doku)

Die hermes-Binärdatei verlinkt nach ~/.local/bin/hermes. Drei Oberflächen sind im Alltag wichtig:

1. CLI (hermes) — Interaktive TUI; Slash-Befehle (/model, /skills, /compress, /new).
2. Gateway (hermes gateway) — Verbindet Messaging-Plattformen mit derselben Agent-Schleife.
3. Terminal-Backends — Wo Shell-/Datei-Tools laufen: local (macOS-Standard), Docker, SSH, Singularity, Modal oder Daytona.

Modell-Routing ist anbieteragnostisch: hermes model wechselt zwischen Nous Portal, OpenRouter (200+ Modelle), OpenAI, Anthropic und BYO-Endpunkten ohne Codeänderung.

macOS-Setup Schritt für Schritt

1. Hermes installieren

Prüfen Sie das Installationsskript in Ihrer Organisation, bevor Sie es in die Shell pipen. Upstream-One-Liner:

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

hermes doctor sollte saubere Checks für uv, Python 3.11, Node, ripgrep und ffmpeg melden. Beheben Sie markierte Abhängigkeiten und führen Sie erneut aus.

2. Ersteinrichtung ausführen

Entweder vollständiger Assistent oder Portal-OAuth:

hermes setup              # interaktiv: Provider, Tools, Gateway-Hinweise
# ODER
hermes setup --portal     # Nous Portal OAuth + Tool Gateway (Suche, Bilder, Browser, TTS)

Der Assistent erkennt ~/.openclaw und bietet Migration an—bei Neuinstallation überspringen.

3. Modell und Tools wählen

hermes model              # provider:model wählen (z. B. openrouter:anthropic/claude-sonnet-4)
hermes tools              # Toolsets ein/aus (40+ Tools upstream)
hermes config set KEY VALUE   # feine Überschreibungen

Mit kurzer CLI-Sitzung bestätigen:

hermes
# in der TUI: Frage stellen, /usage, beenden mit Ctrl+D oder /quit

4. Von OpenClaw migrieren (optional)

Wenn Sie einen bestehenden OpenClaw-Workspace haben:

hermes claw migrate --dry-run
hermes claw migrate

Import umfasst typisch SOUL.md-Persona, MEMORY.md-/USER.md-Einträge, Nutzer-Skills, Befehls-Allowlists, Messaging-Einstellungen und freigegebene API-Schlüssel in ~/.hermes/. Presets siehe hermes claw migrate --help.

5. Messaging-Gateway konfigurieren

hermes gateway setup      # Plattform-Tokens, DM-Pairing, erlaubte Nutzer
hermes gateway start      # Test im Vordergrund

Testen Sie von Telegram (oder Ihrer Plattform): senden Sie /new, dann einen Prompt. Bei onlineem, aber stillem Bot nutzen Sie /status auf der Messaging-Seite—oft Pairing- oder Allowlist-Problem (Upstream Security-Docs).

6. Gateway mit launchd dauerhaft betreiben

Vordergrund-hermes gateway start endet beim Abmelden. Für einen dauerhaft eingeschalteten Mac (Schreibtisch-Mac mini, Studio-Rechner oder Remote-Host) legen Sie einen Benutzer-LaunchAgent an. Beispiel-Plist-Skelett—Pfade nach which hermes anpassen:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>com.hermes.gateway</string>
  <key>ProgramArguments</key>
  <array>
    <string>/Users/YOU/.local/bin/hermes</string>
    <string>gateway</string>
    <string>start</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>KeepAlive</key><true/>
  <key>StandardOutPath</key><string>/Users/YOU/.hermes/logs/gateway.stdout.log</string>
  <key>StandardErrorPath</key><string>/Users/YOU/.hermes/logs/gateway.stderr.log</string>
</dict>
</plist>

Laden:

mkdir -p ~/.hermes/logs
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.hermes.gateway.plist
launchctl kickstart -k gui/$(id -u)/com.hermes.gateway

Telegram-/Discord-Tokens im Plist-EnvironmentVariables-Dict oder einer beim Boot referenzierten Env-Datei speichern—nicht nur in einer SSH-Session exportieren.

7. Cron-ähnliche Automatisierung aktivieren (optional)

Hermes bringt einen integrierten Cron-Scheduler mit Zustellung an Messaging-Plattformen. Jobs in natürlicher Sprache per CLI oder Config gemäß Upstream-Cron-Dokumentation definieren. Unter macOS brauchen Cron-Jobs einen laufenden Gateway- (oder CLI-)Prozess—ein weiterer Grund für launchd auf einem nicht schlafenden Mac.

8. ~/.hermes/ sichern

tar -czf hermes-backup-$(date +%Y%m%d).tar.gz -C ~ .hermes

Skills und Speicher sind schwerer neu zu erzeugen als Chat-Logs. Snapshot vor größeren Upgrades:

hermes update
hermes doctor

Fehlerbehebung

hermes doctor scheitert bei Python oder uv

Symptom: Doctor meldet fehlendes uv oder falsche Python-Version.

Fix: Installationsskript erneut ausführen. Hermes erwartet Python 3.11 via uv. Unter macOS mit Homebrew auch brew install ripgrep ffmpeg node, dann erneut hermes doctor.

Gateway startet, Bots antworten nicht

Symptom: hermes gateway start loggt "running"; DMs hängen ohne Fehler im Chat.

Fix: DM-Pairing und Allowlists in hermes gateway setup abschließen. Gateway nach Token-Änderung neu starten. Bei launchd prüfen, ob Env-Variablen im Plist blieben—launchctl print gui/$(id -u)/com.hermes.gateway zeigt die Umgebung.

CLI-Tools schlagen mit Berechtigungsfehlern fehl

Symptom: Datei- oder Shell-Tools fehlschlagen auf macOS-Pfaden außerhalb des Workspace.

Fix: Befehlsfreigabe in der Config prüfen (Upstream Security). Bei Vollplatten-Pfaden kann macOS TCC Dateien/Ordner-Zugriff anfordern—auf der Maschine mit local-Backend gewähren.

Wann ein Always-on-Mac sinnvoll ist

Ein schlafender MacBook pausiert Gateway-Zustellung und Cron. Teams, die per Telegram chatten, während der Agent woanders läuft, setzen oft einen kleinen Always-on-Mac ein—Schreibtisch-Mac mini oder gehostetes macOS—mit launchd für hermes gateway. Die Schritte in diesem Leitfaden ändern sich nicht; nur Schlafrichtlinie und Netzwerkerreichbarkeit unterscheiden sich. Bei SSH-Backend-Workflows (CLI auf Laptop, Tools auf Remote-Mac) Terminal-Backend in config.toml laut Upstream Tools-Doku auf diesen Host zeigen.

Nach der Installation: Newsletter-Pipeline mit Hermes Subagent-Delegation für Solopreneure —ein Boss, drei Worker per delegate_task.

Hermes Multi-Device-Gateway-Leitfaden — Telegram-Handy und Discord-Desktop.

FAQ

Ersetzt Hermes OpenClaw oder OpenHuman?

Nein—unterschiedliche Designs. Hermes betont Skills + Memory-Nudges + integriertes Cron; OpenClaw ist Gateway-first-Automatisierung; OpenHuman ist Desktop-Speicher mit OAuth-Auto-Fetch. OpenClaw-Daten migrieren Sie mit hermes claw migrate. Vergleichs-Runbooks finden Sie in unserem Hermes Mac mini M4 Anleitung und OpenClaw macOS Installationsanleitung.

Brauche ich Nous Portal?

Nein. Portal (hermes setup --portal) bündelt Modelle und Tool Gateway unter einem OAuth-Login. Sie können OpenRouter-, OpenAI- oder Anthropic-Schlüssel direkt angeben und Tools einzeln aktivieren.

Wo liegt die Config unter macOS?

Hauptbaum: ~/.hermes/ mit config.toml, Skills, Memory und Logs. Die hermes-Binärdatei liegt unter ~/.local/bin/hermes. Nutzen Sie hermes config-Unterbefehle statt blindem Editieren—Assistentenwerte entsprechen dokumentierten Schlüsseln.

Läuft Hermes auf Apple-Silicon-Mac mini?

Ja—das Installationsskript unterstützt macOS auf Apple Silicon. Gateway und lokales Backend laufen nativ; kein Rosetta für den von uv installierten Python-Stack.

Wie aktualisiere ich Hermes?

hermes update
hermes doctor

Nach Updates launchd-verwaltetes Gateway neu starten: launchctl kickstart -k gui/$(id -u)/com.hermes.gateway.

Related reading

• GPT-5.6 Prognose: Codex Open Source für Agent-Effizienz