Wie Sie Hermes Agent rund um die Uhr auf einem dedizierten Mac mini betreiben

1. Warum Hermes Agent auf einem Mac mini betreiben?

Hermes Agent ist darauf ausgelegt, dauerhaft online zu bleiben: Er speichert persistente Erinnerungen, führt geplante Aufgaben mit seinem integrierten Cron aus und verbessert zwischen den Gesprächen seine eigenen Skills. Nichts davon funktioniert auf einem Laptop, der in den Ruhezustand geht, oder auf einem geteilten VPS, der neu startet. Ein dedizierter Mac mini von MyRemoteMac bietet Ihnen Apple Silicon (Tier 1 für Hermes), vollen Root-Zugriff per SSH und VNC, 1 Gbps inklusive und einen pauschalen Monatspreis, mit der Option, ein lokales Ollama-Modell auf derselben Maschine zu betreiben, sodass die Inferenz pro Token nichts kostet.

2. Voraussetzungen

Der offizielle Installer ist bewusst schlank. Sie brauchen weder Homebrew noch Python oder Node.js: Hermes lädt sein eigenes gepinntes uv und Python 3.14 herunter, und Node.js wird erst später benötigt, falls Sie die WhatsApp-Bridge aktivieren. Das brauchen Sie tatsächlich:

• Einen dedizierten Mac mini von MyRemoteMac, M4 ab 85 $/Monat oder M6 ab 149 $/Monat. Beide haben Apple Silicon, das für Hermes Tier 1 ist.
• SSH-Zugriff auf Ihren Mac mini (im MyRemoteMac-Abonnement enthalten)
• git und curl auf dem Mac (plus tar und ein SHA-256-Tool, alle auf macOS vorinstalliert, git über die Xcode Command Line Tools). Der Installer bricht nur ab, wenn git oder curl fehlt.
• Einen LLM-Anbieter: einen API-Schlüssel (Anthropic, OpenRouter, OpenAI und 25+ weitere), ein Nous-Portal-Abonnement oder ein lokales Ollama-Modell. Das Modell muss mindestens 64.000 Token Kontext bieten und Tool Calling unterstützen.
• Ein Messaging-Konto bei Telegram, Discord oder WhatsApp (Telegram ist am schnellsten eingerichtet)

3. Schritt 1: Per SSH verbinden und den Installer ausführen

Verbinden Sie sich per SSH mit Ihrem Mac mini, mit den Zugangsdaten aus Ihrem MyRemoteMac-Dashboard. Der Installer benötigt git und curl (plus tar und ein SHA-256-Tool, alle auf macOS vorinstalliert) und erledigt dann alles Weitere selbst: Er klont den Quellcode nach ~/.hermes/hermes-agent, lädt ein gepinntes, per SHA-256 verifiziertes uv herunter, stellt Python 3.14 bereit, installiert die Abhängigkeiten, erstellt ~/.hermes/config.yaml und ~/.hermes/.env (chmod 600) und startet eine interaktive Einrichtung.

Per SSH verbinden und die Voraussetzungen prüfen

# Connect to your Mac mini
ssh admin@your-server-ip

# Confirm Apple Silicon (Tier 1 platform for Hermes Agent)
uname -m
# arm64

# The installer requires only git and curl: both ship with macOS
git --version && curl --version

Den offiziellen Einzeiler-Installer ausführen

Das ist derselbe Befehl, den das offizielle README und die Installationsseite veröffentlichen. Verwenden Sie nicht Homebrew: brew install hermes-agent wird in der offiziellen Dokumentation als nicht unterstützte Methode geführt. Wenn Sie die Installation per SSH skripten, ergänzen Sie --non-interactive (Alias --skip-setup) und führen Sie den Assistenten anschließend selbst aus.

# Official one-line installer (Linux / macOS / WSL2)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# What it does:
# - clones the source into ~/.hermes/hermes-agent
# - downloads a pinned, sha256-verified uv and provisions Python 3.14
# - creates ~/.hermes/config.yaml and ~/.hermes/.env (chmod 600)
# - launches the interactive setup wizard

# Scripting over SSH? Skip the wizard and run it later with `hermes model`:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --non-interactive

Shell neu laden und überprüfen

Der Installer fügt ~/.local/bin in ~/.zshrc und ~/.zprofile zu Ihrem PATH hinzu. Laden Sie die Shell neu (oder öffnen Sie eine neue SSH-Sitzung) und führen Sie dann die integrierte Diagnose aus:

# Reload the shell so ~/.local/bin/hermes is on PATH
source ~/.zshrc    # or open a new SSH session

# Verify the install
hermes --version

# Built-in diagnostics (add --fix to attempt automatic repairs)
hermes doctor

4. Schritt 2: Modellanbieter konfigurieren (API oder lokales Ollama)

Hermes bewahrt Geheimnisse in ~/.hermes/.env und alles andere in ~/.hermes/config.yaml auf und bietet drei offizielle Wege, ein Modell auszuwählen. Was auch immer Sie wählen: Das Modell braucht mindestens 64.000 Token Kontext. Beachten Sie, dass das eigene Hermes-4-Chatmodell von Nous nicht das ist, was die Agentenschleife braucht, die Nous-Portal-Dokumentation empfiehlt stattdessen ein Frontier-Modell mit Tool Calling.

Option A oder B: der interaktive Assistent oder Nous Portal

Der Assistent führt Sie durch Anbieter, API-Schlüssel und OAuth-Logins. Nous Portal ist ein Abonnement, das dem Agenten über einen einzigen OAuth-Login Zugriff auf 300+ Modelle gibt (die Preise stehen auf der Nous-Portal-Website, nicht in der Dokumentation).

# Option A: interactive wizard (providers, API keys, OAuth logins)
hermes model

# Option B: Nous Portal subscription via OAuth (300+ models)
hermes setup --portal

Option C: Schlüssel und Modell nicht-interaktiv setzen

UPPER_SNAKE-Schlüssel wie ANTHROPIC_API_KEY, OPENROUTER_API_KEY oder OPENAI_API_KEY landen in .env; Schlüssel mit Punkten oder in Kleinbuchstaben gehen in config.yaml. Die Modell-ID unten ist das Beispiel aus dem offiziellen Quickstart, wählen Sie ein beliebiges aktuelles Modell Ihres Anbieters mit 64k+ Kontext und Tool Calling.

# Option C: non-interactive, UPPER_SNAKE keys go to ~/.hermes/.env
hermes config set ANTHROPIC_API_KEY sk-ant-YOUR_API_KEY_HERE

# Dotted / lowercase keys go to ~/.hermes/config.yaml
# (model id below is the example from the official quickstart)
hermes config set model anthropic/claude-opus-4.6

# Review the active configuration
hermes config show

Optional: ein kostenloses lokales Modell mit Ollama

Ihr Mac mini kann das Modell selbst hosten. Die offizielle Hermes-Ollama-Anleitung verwendet gemma4:31b (etwa 20 GB auf der Festplatte, 24+ GB RAM, Tool Calling unterstützt), bei MyRemoteMac erfüllt eine 24-GB-Konfiguration (Mac mini M4 24 GB für 129 $/Monat oder M6 24 GB für 219 $/Monat) dieses dokumentierte Minimum, wobei wenig Spielraum für macOS und das 64k-Kontextfenster bleibt, wenn Sie auf einem Mac mini mit 24 GB Reserven wollen, wählen Sie stattdessen ein kleineres Tool-Calling-Modell. Das Standard-Kontextfenster von Ollama liegt weit unter der 64k-Anforderung von Hermes, daher lässt die Dokumentation Sie ein Modelfile erstellen, das num_ctx erhöht. Installieren Sie zuerst Ollama für macOS von ollama.com/download; Ollama dokumentiert außerdem einen geführten Weg mit ollama launch hermes.

# 1. Install Ollama for macOS from https://ollama.com/download

# 2. Pull a tool-calling model (~20 GB on disk, 24+ GB RAM)
ollama pull gemma4:31b

# 3. Hermes needs 64k context: build a Modelfile that raises num_ctx
printf 'FROM gemma4:31b\nPARAMETER num_ctx 64000\n' > Modelfile
ollama create gemma4-64k -f Modelfile

# 4. Point Hermes at the local OpenAI-compatible endpoint
hermes setup
# Choose "Custom Endpoint": base URL http://localhost:11434/v1, model gemma4-64k

# Alternative guided path documented by Ollama:
ollama launch hermes

Smoke-Test, bevor Sie etwas anderes hinzufügen

Der Quickstart ist eindeutig: Wenn Hermes keinen normalen Chat abschließen kann, fügen Sie noch kein Gateway, keinen Cron und keine Skills hinzu. Führen Sie zuerst ein sauberes Gespräch durch:

# Classic CLI chat
hermes

# Or the terminal UI
hermes --tui

5. Schritt 3: Messaging-Kanäle verbinden

Ein einziger Hermes-Gateway-Prozess bedient alle Ihre Plattformen: Die offizielle Dokumentation zählt 20+ aus einem Gateway, darunter Telegram, Discord, Slack, WhatsApp, Signal, Google Chat, Microsoft Teams, Matrix, Mattermost und iMessage-Bridges. Unten finden Sie die drei, die wir anhand der jeweiligen Dokumentationsseiten überprüft haben. Das Gateway arbeitet nach dem Prinzip deny-by-default, bis Sie Ihre Benutzer-ID auf die Allowlist setzen, ignoriert der Bot jeden.

Telegram (empfohlener erster Kanal)

Erstellen Sie einen Bot mit @BotFather (/newbot liefert Ihnen das Token) und holen Sie sich Ihre numerische Benutzer-ID von @userinfobot, Telegram-Allowlists verwenden numerische IDs, keine @Benutzernamen. Führen Sie dann den Gateway-Assistenten aus, der die Werte nach ~/.hermes/.env schreibt. Long Polling ist der Standard, daher ist weder ein eingehender Port noch eine Firewall-Regel nötig.

# 1. In Telegram, open @BotFather, send /newbot and copy the token
# 2. Open @userinfobot to get your numeric user ID

# 3. Run the gateway wizard (writes the values to ~/.hermes/.env)
hermes gateway setup

# Equivalent manual entries in ~/.hermes/.env:
# TELEGRAM_BOT_TOKEN=123456789:ABC...
# TELEGRAM_ALLOWED_USERS=123456789
# Optional: chat that receives scheduled-task results (or send /sethome in a chat)
# TELEGRAM_HOME_CHANNEL=123456789

Discord (optional)

Erstellen Sie eine Anwendung im Discord Developer Portal, kopieren Sie das Bot-Token und aktivieren Sie unter Privileged Gateway Intents sowohl den Message Content Intent als auch den Server Members Intent, ohne Message Content Intent empfängt der Bot Ereignisse mit leerem Text. Laden Sie den Bot mit der Berechtigungszahl 274878286912 ein und setzen Sie dann Ihre Benutzer-ID auf die Allowlist.

# In the Discord Developer Portal (https://discord.com/developers/applications):
# 1. New Application > Bot > copy the Bot Token
# 2. Privileged Gateway Intents: enable Message Content Intent + Server Members Intent
# 3. Invite the bot with permission integer 274878286912

hermes gateway setup   # choose Discord

# Equivalent manual entries in ~/.hermes/.env:
# DISCORD_BOT_TOKEN=...
# DISCORD_ALLOWED_USERS=284102345871466496
# DISCORD_REQUIRE_MENTION=true   (default)

WhatsApp (optional)

WhatsApp verwendet eine inoffizielle Bridge (Baileys), die Node.js v18+ und eine dedizierte, per QR-Code gekoppelte Telefonnummer benötigt. Die offizielle Dokumentation warnt, dass ein geringes Risiko von Kontoeinschränkungen besteht, und das Sitzungsverzeichnis gewährt vollen Zugriff auf das Konto, teilen Sie es niemals.

# Requires Node.js v18+ on the Mac mini (only needed for WhatsApp)
node --version

# Pair a dedicated phone number via QR code
hermes whatsapp

# ~/.hermes/.env:
# WHATSAPP_ENABLED=true
# WHATSAPP_MODE=bot
# WHATSAPP_ALLOWED_USERS=15551234567   (country code, no +)

# Session is stored in ~/.hermes/platforms/whatsapp/session: never share it
# Meta Business Cloud API alternative: hermes whatsapp-cloud

Das Gateway im Vordergrund testen

Starten Sie das Gateway in Ihrer SSH-Sitzung, senden Sie Ihrem Bot eine Nachricht, bestätigen Sie, dass er antwortet, und drücken Sie dann Ctrl-C. hermes gateway status zeigt den Dienststatus; schreiben Sie dem Bot, um die Funktion Ende-zu-Ende zu bestätigen.

# Run the gateway in the foreground
hermes gateway

# Send your bot a message from Telegram / Discord: it should reply.
# Press Ctrl-C to stop (the persistent service is set up in Step 4)

6. Schritt 4: Rund um die Uhr mit launchd betreiben, aktualisieren, migrieren

hermes gateway install registriert einen LaunchAgent auf Benutzerebene unter ~/Library/LaunchAgents/ai.hermes.gateway.plist (Label ai.hermes.gateway), sodass das Gateway bei der Anmeldung startet (RunAtLoad) und von macOS überwacht wird. Ein wichtiges Detail aus der offiziellen FAQ: Die plist friert Ihren vollständigen Shell-PATH zum Installationszeitpunkt ein. Installieren Sie Node.js, ffmpeg oder Ollama vor diesem Schritt, oder führen Sie hermes gateway install danach erneut aus.

Den Dienst installieren und starten

# Register the launchd LaunchAgent
# (writes ~/Library/LaunchAgents/ai.hermes.gateway.plist with your current PATH)
hermes gateway install

# Start it now
hermes gateway start

# Service status
hermes gateway status

# Live logs
tail -f ~/.hermes/logs/gateway.log

# Other commands: hermes gateway stop | restart | list
# Foreground run (no launchd): hermes gateway run

Prüfen, ob launchd ihn überwacht (und einmal einen Neustart testen)

hermes gateway status zeigt den Dienststatus; schreiben Sie dem Bot, um die Funktion Ende-zu-Ende zu bestätigen, und fragen Sie launchctl direkt ab, um sicherzustellen, dass launchd den Prozess tatsächlich besitzt. Da ein LaunchAgent auf Benutzerebene erst geladen wird, wenn Ihre Benutzersitzung existiert, stellen Sie vor dem Neustart-Test sicher, dass die automatische Anmeldung für Ihren Admin-Benutzer aktiviert ist (Systemeinstellungen > Benutzer & Gruppen > Automatische Anmeldung), andernfalls kommt das Gateway auf einem headless Mac mini nicht zurück. Starten Sie dann einmal neu (sudo reboot) und schreiben Sie dem Bot erneut.

# Confirm launchd owns the gateway (state, PID, last exit code)
launchctl print gui/$(id -u)/ai.hermes.gateway

# Check the PATH that was captured in the plist
/usr/libexec/PlistBuddy -c "Print :EnvironmentVariables:PATH" ~/Library/LaunchAgents/ai.hermes.gateway.plist

# LaunchAgents load at login: enable Automatic login first
# (System Settings > Users & Groups > Automatic login)
# Reboot-test once, then message the bot again
sudo reboot

Hermes Agent aktualisieren

hermes update holt den neuesten Code nach ~/.hermes/hermes-agent, synchronisiert die Abhängigkeiten neu und startet das Gateway drain-first neu: Es nimmt keine neuen Turns mehr an und wartet auf laufende Chat-, Cron- und API-Arbeit (standardmäßig bis zu 30 Minuten), bevor es neu startet. Die Ausgabe wird nach ~/.hermes/logs/update.log gespiegelt. Verwenden Sie --check für eine Vorschau, --backup, um zuerst einen Snapshot von ~/.hermes zu erstellen, und --no-gateway-restart, um den Neustart aufzuschieben.

# Preview what would change
hermes update --check

# Update (snapshot ~/.hermes first, drain-first gateway restart)
hermes update --backup

# Adopt any new configuration options
hermes config check && hermes config migrate

# Confirm the running version
hermes --version

Optional: Von OpenClaw auf demselben Mac migrieren

Sie betreiben bereits OpenClaw aus unserer anderen Anleitung? Der offizielle Migrationsbefehl importiert SOUL.md, Erinnerungen und Benutzerprofile (nach ~/.hermes/memories/) sowie Skills (nach ~/.hermes/skills/openclaw-imports/) aus ~/.openclaw und schreibt zuvor einen Wiederherstellungspunkt pre-migration-*.zip in ~/.hermes/backups/. Geheimnisse werden standardmäßig nicht importiert: Ergänzen Sie explizit --migrate-secrets, um API-Schlüssel und Messaging-Tokens (Telegram, Discord, Slack, Signal, Matrix, Mattermost) zu übernehmen. WhatsApp wird nicht per Token migriert, nur seine Allowlist wird übernommen, und muss mit hermes whatsapp neu gekoppelt werden. Beginnen Sie immer mit einem Dry Run.

# Preview the migration from ~/.openclaw
hermes claw migrate --dry-run

# Migrate (writes a pre-migration-*.zip restore point in ~/.hermes/backups/ first)
# --migrate-secrets is required to carry over API keys and messaging tokens
hermes claw migrate --migrate-secrets

# Later, rename leftover OpenClaw directories to .pre-migration/
hermes claw cleanup

7. Häufige Probleme beheben

# Reload the shell profile the installer edited
source ~/.zshrc

# Or call the binary directly
~/.local/bin/hermes --version

# Still broken? Run the diagnostics
~/.local/bin/hermes doctor --fix

# Allowlist resolution order (official security guide):
# per-platform allow-all -> DM-pairing list -> TELEGRAM_ALLOWED_USERS / DISCORD_ALLOWED_USERS
# -> GATEWAY_ALLOWED_USERS -> GATEWAY_ALLOW_ALL_USERS=true -> deny

# Check what is stored (Telegram IDs are numeric, from @userinfobot)
grep TELEGRAM_ALLOWED_USERS ~/.hermes/.env

# Fix it, then watch the gateway in the foreground while you message the bot
hermes config set TELEGRAM_ALLOWED_USERS 123456789
hermes gateway

# Discord only: confirm Message Content Intent is enabled in the Developer Portal

# See the PATH launchd is using
/usr/libexec/PlistBuddy -c "Print :EnvironmentVariables:PATH" ~/Library/LaunchAgents/ai.hermes.gateway.plist

# Re-capture your current shell PATH and reload the service
hermes gateway install
hermes gateway start

# Check the logs
tail -50 ~/.hermes/logs/gateway.log

# Rebuild the model with a 64k context window
printf 'FROM gemma4:31b\nPARAMETER num_ctx 64000\n' > Modelfile
ollama create gemma4-64k -f Modelfile

# Make sure Hermes targets the 64k variant on the local endpoint
hermes setup   # Custom Endpoint: http://localhost:11434/v1, model gemma4-64k

# Note: the model must also support tool calling (gemma4:31b does, per the official guide)

# Is the LaunchAgent registered and running?
launchctl print gui/$(id -u)/ai.hermes.gateway

# Not listed? Re-register and start it (and check Automatic login is on)
hermes gateway install
hermes gateway start
hermes gateway status

# Then reboot-test again
sudo reboot

8. Kostenanalyse vs. Cloud-VPS

Hermes Agent selbst ist kostenlos (MIT). Sie zahlen für den Host und die LLM-Nutzung. Der Host-Vergleich unten übernimmt die Cloud-VPS-Zahlen aus unserer OpenClaw-Anleitung; die LLM-API-Nutzung wird in beiden Spalten separat von Ihrem Anbieter abgerechnet und ist auf beiden Hosts identisch, es sei denn, Sie betreiben ein lokales Ollama-Modell auf dem Mac mini, dann kostet die Inferenz 0 $.

Annahmen: Die VPS-Preise sind dieselben Spannen, die wir in unseren Anleitungen für GPU-fähige KI-Instanzen verwenden, und keine Angebote eines bestimmten Anbieters; die MyRemoteMac-Preise sind die aktuellen Monatspreise in USD (1 Gbps inklusive). Die Preise des Nous-Portal-Abonnements sind in der Hermes-Dokumentation nicht veröffentlicht und daher nicht enthalten.

9. Hermes Agent vs. OpenClaw

Beide sind quelloffene (MIT), selbst gehostete, dauerhaft laufende persönliche KI-Agenten, die aus Ihren Messaging-Apps gesteuert werden, beide werden mit einem curl-Einzeiler installiert, beide betreiben ein langlebiges Gateway, und beide registrieren ihren eigenen launchd-LaunchAgent (ai.hermes.gateway vs. ai.openclaw.gateway). Die Unterschiede liegen im Stack und in der Ausrichtung. OpenClaw ist TypeScript auf Node.js (26.1+ oder 24.16+ via Homebrew), wird mit npm installiert und hat seinen eigenen Befehl openclaw gateway install service. Hermes ist Python, gebootstrapped durch ein gepinntes uv, lebt vollständig in ~/.hermes, braucht nur git und curl (Node.js nur für die WhatsApp-Bridge) und verwendet hermes gateway install. Die Stärke von Hermes ist die Selbstverbesserung: vom Agenten erstellte Skills, persistente Erinnerungen und SOUL.md, integrierter Cron und sieben Terminal-Backends (lokal, Docker, SSH, Modal, Daytona, Vercel Sandbox, Singularity). Die Stärke von OpenClaw sind die Breite und die größere Community, am 28. September 2026 zeigte GitHub rund 391k Sterne für OpenClaw gegenüber 250k für Hermes.

Wenn Sie bereits OpenClaw betreiben, ist die Migration erstklassig unterstützt: hermes claw migrate (siehe Schritt 4) ist eine Vorwärtsmigration, die zuvor einen Wiederherstellungspunkt pre-migration-*.zip in ~/.hermes/backups/ schreibt. Wenn Sie bei null anfangen, lesen Sie auch unsere Anleitung zu OpenClaw auf dem Mac mini und wählen Sie das Harness, dessen Workflow Ihnen besser liegt, der Mac mini, der launchd-Dienst und die lokale Ollama-Option sind für beide identisch.

10. FAQ

11. Quellen und weiterführende Links

Jeder Befehl und jede Anforderung in dieser Anleitung wurde am 28. September 2026 anhand der offiziellen Hermes-Agent-Dokumentation und des Repositorys geprüft (neuestes Release v2026.9.24). Hermes veröffentlicht datumsbasierte Releases und entwickelt sich schnell weiter, konsultieren Sie daher diese Seiten für die aktuelle Liste der Flags:

• Hermes Agent GitHub-Repository (NousResearch/hermes-agent)
• Offizielle Installationsanleitung
• Quickstart (Anbieter, 64k-Kontextanforderung, Smoke-Test)
• Plattformunterstützung (Tier 1 macOS Apple Silicon, nicht unterstützte Methoden)
• Hermes Agent aktualisieren
• Konfigurationsreferenz (config.yaml, .env, Vorrang)
• Sicherheitsleitfaden (Allowlists, Freigaben, Docker-Backend)
• Messaging-Übersicht (Plattformliste, gateway install/start/stop)
• Telegram einrichten
• Discord einrichten
• WhatsApp einrichten
• Referenz der CLI-Befehle
• FAQ (macOS launchd PATH, gateway.log)
• Anleitung zur lokalen Ollama-Einrichtung (gemma4:31b, num_ctx 64000)
• Von OpenClaw migrieren
• Nous-Portal-Integration
• Ollama-Integrationsseite (ollama launch hermes)

Verwandte Anleitungen