Come eseguire Hermes Agent 24/7 su un Mac mini dedicato

1. Perché eseguire Hermes Agent su un Mac mini?

Hermes Agent è progettato per restare attivo: conserva memorie persistenti, esegue attività pianificate con il suo cron integrato e migliora le proprie skill tra una conversazione e l'altra. Niente di tutto questo funziona su un laptop che va in stop o su un VPS condiviso che si riavvia. Un Mac mini dedicato di MyRemoteMac ti offre Apple Silicon (Tier 1 per Hermes), root completo via SSH e VNC, 1 Gbps inclusi e un prezzo mensile fisso, con la possibilità di eseguire un modello Ollama locale sulla stessa macchina, così l'inferenza non costa nulla per token.

2. Prerequisiti

L'installer ufficiale è volutamente leggero. Non ti servono Homebrew, Python o Node.js: Hermes scarica la propria versione fissata di uv e Python 3.14, e Node.js è richiesto solo in seguito se abiliti il bridge WhatsApp. Ecco ciò di cui hai davvero bisogno:

• Un Mac mini dedicato di MyRemoteMac, M4 da $85/mese o M6 da $149/mese. Entrambi sono Apple Silicon, ovvero Tier 1 per Hermes.
• Accesso SSH al tuo Mac mini (incluso nel tuo abbonamento MyRemoteMac)
• git e curl sul Mac (più tar e uno strumento SHA-256, tutti preinstallati su macOS, git tramite gli Xcode Command Line Tools). L'installer si interrompe con errore solo se mancano git o curl.
• Un provider LLM: una chiave API (Anthropic, OpenRouter, OpenAI e oltre 25 altri), un abbonamento Nous Portal o un modello Ollama locale. Il modello deve offrire almeno 64.000 token di contesto e supportare il tool calling.
• Un account di messaggistica su Telegram, Discord o WhatsApp (Telegram è il più rapido da configurare)

3. Passo 1: Connettiti via SSH ed esegui l'installer

Connettiti al tuo Mac mini via SSH con le credenziali della tua dashboard MyRemoteMac. L'installer ha bisogno di git e curl (più tar e uno strumento SHA-256, tutti preinstallati su macOS), poi fa tutto il resto da solo: clona il sorgente in ~/.hermes/hermes-agent, scarica una versione fissata di uv verificata via SHA-256, predispone Python 3.14, installa le dipendenze, crea ~/.hermes/config.yaml e ~/.hermes/.env (chmod 600) e avvia una configurazione interattiva.

Connettiti via SSH e verifica i requisiti

# 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

Esegui l'installer ufficiale in una riga

È lo stesso comando pubblicato dal README ufficiale e dalla pagina di installazione. Non usare Homebrew: brew install hermes-agent è elencato come metodo non supportato nella documentazione ufficiale. Se stai automatizzando l'installazione via SSH, aggiungi --non-interactive (alias --skip-setup) ed esegui tu stesso il wizard in seguito.

# 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

Ricarica la shell e verifica

L'installer aggiunge ~/.local/bin al tuo PATH in ~/.zshrc e ~/.zprofile. Ricarica la shell (o apri una nuova sessione SSH), poi esegui la diagnostica integrata:

# 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. Passo 2: Configura un provider di modelli (API o Ollama locale)

Hermes conserva i segreti in ~/.hermes/.env e tutto il resto in ~/.hermes/config.yaml, ed espone tre modi ufficiali per scegliere un modello. Qualunque sia la tua scelta, il modello deve avere almeno 64.000 token di contesto. Nota che il modello chat Hermes 4 di Nous non è ciò che serve al loop dell'agente, la documentazione di Nous Portal raccomanda invece un modello di frontiera con tool calling.

Opzione A o B: il wizard interattivo o Nous Portal

Il wizard ti guida tra provider, chiavi API e login OAuth. Nous Portal è un abbonamento che dà all'agente accesso a oltre 300 modelli tramite un unico login OAuth (i prezzi sono sul sito di Nous Portal, non nella documentazione).

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

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

Opzione C: imposta chiave e modello in modo non interattivo

Le chiavi in UPPER_SNAKE come ANTHROPIC_API_KEY, OPENROUTER_API_KEY o OPENAI_API_KEY vengono instradate in .env; le chiavi con punti o in minuscolo vanno in config.yaml. L'id del modello qui sotto è l'esempio usato nel quickstart ufficiale, scegli qualsiasi modello attuale offerto dal tuo provider con oltre 64k di contesto e 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

Facoltativo: un modello locale gratuito con Ollama

Il tuo Mac mini può ospitare il modello da solo. La guida ufficiale Hermes per Ollama usa gemma4:31b (circa 20 GB su disco, 24+ GB di RAM, tool calling supportato), su MyRemoteMac una configurazione da 24 GB (Mac mini M4 24 GB a $129/mese o M6 24 GB a $219/mese) soddisfa quel minimo documentato, con poco margine residuo per macOS e la finestra di contesto da 64k, se vuoi margine su un Mac mini da 24 GB, scegli invece un modello più piccolo con tool calling. La finestra di contesto predefinita di Ollama è molto al di sotto del requisito di 64k di Hermes, quindi la documentazione ti fa creare un Modelfile che aumenta num_ctx. Installa prima Ollama per macOS da ollama.com/download; Ollama documenta anche un percorso guidato con 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 prima di aggiungere altro

Il quickstart è esplicito: se Hermes non riesce a completare una chat normale, non aggiungere ancora gateway, cron o skill. Esegui prima una conversazione pulita:

# Classic CLI chat
hermes

# Or the terminal UI
hermes --tui

5. Passo 3: Collega i canali di messaggistica

Un unico processo gateway Hermes serve tutte le tue piattaforme: la documentazione ufficiale ne conta oltre 20 da un solo gateway, tra cui Telegram, Discord, Slack, WhatsApp, Signal, Google Chat, Microsoft Teams, Matrix, Mattermost e bridge iMessage. Qui sotto trovi le tre che abbiamo verificato sulle pagine dedicate della documentazione. Il gateway è deny-by-default, finché non inserisci il tuo ID utente nell'allowlist, il bot ignora tutti.

Telegram (primo canale consigliato)

Crea un bot con @BotFather (/newbot ti fornisce il token) e ottieni il tuo ID utente numerico da @userinfobot, le allowlist di Telegram usano ID numerici, non @username. Poi esegui il wizard del gateway, che scrive i valori in ~/.hermes/.env. Il long polling è l'impostazione predefinita, quindi non servono porte in ingresso né regole firewall.

# 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 (facoltativo)

Crea un'applicazione nel Discord Developer Portal, copia il token del bot e abilita sia il Message Content Intent sia il Server Members Intent sotto Privileged Gateway Intents, senza il Message Content Intent il bot riceve eventi con testo vuoto. Invita il bot con l'intero di permessi 274878286912, poi inserisci il tuo ID utente nell'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 (facoltativo)

WhatsApp usa un bridge non ufficiale (Baileys) che richiede Node.js v18+ e un numero di telefono dedicato associato tramite codice QR. La documentazione ufficiale avverte che comporta un piccolo rischio di restrizioni dell'account, e la directory di sessione concede accesso completo all'account, non condividerla mai.

# 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

Testa il gateway in primo piano

Avvia il gateway nella tua sessione SSH, invia un messaggio al bot, verifica che risponda, poi premi Ctrl-C. hermes gateway status mostra lo stato del servizio; scrivi al bot per confermare il funzionamento end-to-end.

# 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. Passo 4: Esegui 24/7 con launchd, aggiorna, migra

hermes gateway install registra un LaunchAgent a livello utente in ~/Library/LaunchAgents/ai.hermes.gateway.plist (label ai.hermes.gateway), così il gateway si avvia al login (RunAtLoad) ed è supervisionato da macOS. Un dettaglio importante dalla FAQ ufficiale: il plist fotografa l'intero PATH della tua shell al momento dell'installazione. Installa Node.js, ffmpeg o Ollama prima di questo passo, oppure riesegui hermes gateway install in seguito.

Installa e avvia il servizio

# 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

Verifica che launchd lo supervisioni (e fai un test di riavvio)

hermes gateway status mostra lo stato del servizio; scrivi al bot per confermare il funzionamento end-to-end e interroga direttamente launchctl per verificare che sia davvero launchd a possedere il processo. Poiché un LaunchAgent a livello utente si carica solo quando esiste la tua sessione utente, assicurati che il login automatico sia abilitato per il tuo utente admin (Impostazioni di Sistema > Utenti e Gruppi > Login automatico) prima del test di riavvio, altrimenti il gateway non tornerà attivo su un Mac mini headless. Poi riavvia una volta (sudo reboot) e scrivi di nuovo al bot.

# 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

Aggiorna Hermes Agent

hermes update scarica il codice più recente in ~/.hermes/hermes-agent, risincronizza le dipendenze e riavvia il gateway in modalità drain-first: rifiuta nuovi turni e attende il completamento di chat, cron e chiamate API in corso (fino a 30 minuti per impostazione predefinita) prima di riavviare. L'output è replicato in ~/.hermes/logs/update.log. Usa --check per un'anteprima, --backup per fare prima uno snapshot di ~/.hermes e --no-gateway-restart per rimandare il riavvio.

# 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

Facoltativo: migra da OpenClaw sullo stesso Mac

Esegui già OpenClaw seguendo la nostra altra guida? Il comando di migrazione ufficiale importa SOUL.md, memorie e profili utente (in ~/.hermes/memories/), skill (in ~/.hermes/skills/openclaw-imports/) da ~/.openclaw, e prima scrive un punto di ripristino pre-migration-*.zip in ~/.hermes/backups/. I segreti non vengono importati per impostazione predefinita: aggiungi esplicitamente --migrate-secrets per trasferire chiavi API e token di messaggistica (Telegram, Discord, Slack, Signal, Matrix, Mattermost). WhatsApp non viene migrato a livello di token, viene mappata solo la sua allowlist, e deve essere riassociato con hermes whatsapp. Inizia sempre con un 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. Risoluzione dei problemi comuni

# 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. Analisi dei costi vs. VPS cloud

Hermes Agent in sé è gratuito (MIT). Ciò che paghi è l'host e l'utilizzo dell'LLM. Il confronto degli host qui sotto riutilizza le cifre dei VPS cloud della nostra guida OpenClaw; l'utilizzo dell'API LLM è fatturato separatamente dal tuo provider in entrambe le colonne ed è identico su entrambi gli host, a meno che tu non esegua un modello Ollama locale sul Mac mini, nel qual caso l'inferenza costa $0.

Ipotesi: i prezzi dei VPS sono le stesse fasce usate in tutte le nostre guide per istanze tier AI con GPU e non sono preventivi di un provider specifico; i prezzi MyRemoteMac sono le tariffe mensili attuali in USD (1 Gbps inclusi). Il prezzo dell'abbonamento Nous Portal non è pubblicato nella documentazione Hermes, quindi non è incluso.

9. Hermes Agent vs. OpenClaw

Entrambi sono agenti AI personali open source (MIT), self-hosted e always-on pilotati dalle tue app di messaggistica, entrambi si installano con un comando curl in una riga, entrambi eseguono un gateway persistente ed entrambi registrano il proprio LaunchAgent launchd (ai.hermes.gateway vs ai.openclaw.gateway). Le differenze stanno nello stack e nella proposta. OpenClaw è TypeScript su Node.js (26.1+ o 24.16+ via Homebrew), si installa con npm e ha il proprio comando di servizio openclaw gateway install. Hermes è Python avviato da una versione fissata di uv, vive interamente in ~/.hermes, richiede solo git e curl (Node.js solo per il bridge WhatsApp) e usa hermes gateway install. La proposta di Hermes è l'auto-miglioramento: skill create dall'agente, memorie persistenti e SOUL.md, cron integrato e sette backend terminale (locale, Docker, SSH, Modal, Daytona, Vercel Sandbox, Singularity). La proposta di OpenClaw è l'ampiezza e la community più grande, il 28 settembre 2026 GitHub mostrava circa 391k stelle per OpenClaw contro 250k per Hermes.

Se esegui già OpenClaw, la migrazione è di prima classe: hermes claw migrate (vedi Passo 4) è una migrazione in avanti che scrive prima un punto di ripristino pre-migration-*.zip in ~/.hermes/backups/. Se parti da zero, leggi anche la nostra guida OpenClaw su Mac mini e scegli l'harness con il flusso di lavoro che preferisci, il Mac mini, il servizio launchd e l'opzione Ollama locale sono identici per entrambi.

10. FAQ

11. Fonti e approfondimenti

Ogni comando e requisito di questa guida è stato verificato il 28 settembre 2026 sulla documentazione e sul repository ufficiali di Hermes Agent (ultima release v2026.9.24). Hermes pubblica release datate ed evolve rapidamente, quindi consulta queste pagine per l'elenco aggiornato dei flag:

• Repository GitHub di Hermes Agent (NousResearch/hermes-agent)
• Guida di installazione ufficiale
• Quickstart (provider, requisito di contesto 64k, smoke test)
• Piattaforme supportate (Tier 1 macOS Apple Silicon, metodi non supportati)
• Aggiornare Hermes Agent
• Riferimento di configurazione (config.yaml, .env, precedenza)
• Guida alla sicurezza (allowlist, approvazioni, backend Docker)
• Panoramica messaggistica (elenco piattaforme, gateway install/start/stop)
• Configurazione Telegram
• Configurazione Discord
• Configurazione WhatsApp
• Riferimento dei comandi CLI
• FAQ (PATH di launchd su macOS, gateway.log)
• Guida alla configurazione di Ollama locale (gemma4:31b, num_ctx 64000)
• Migrare da OpenClaw
• Integrazione Nous Portal
• Pagina di integrazione Ollama (ollama launch hermes)

Guide correlate