Hermes Agent
sul tuo server

Il vendor lock-in dei grossi player è da qualche mese che mi va sempre meno giù. Per questo cercavo qualcosa di open source: Openclaw l'ho provato, ma non mi ha mai convinto. Hermes sì.

Hermes è un agente AI open source fatto da Nous Research. Il codice è pubblico su GitHub, quindi non lo "usi" su un servizio di qualcun altro: te lo installi su una macchina tua.

Tre conseguenze concrete, e sono il motivo di tutta questa guida:

1. Le tue chiavi e le tue conversazioni restano sul tuo server. Non transitano da una piattaforma intermedia.
2. Il modello lo scegli tu e lo cambi in dieci secondi. Oggi Deepseek, domani quello che esce.
3. Nessuno può spegnertelo. Se un provider cambia idea sui termini, tu cambi provider e l'agente resta lì, con la sua memoria e le sue skill.

Ha quattro componenti: memoria (si ricorda chi sei e come lavori), skill (competenze riutilizzabili, ne arriva già con 67 attive), soul (il file con il tuo tono di voce) e cron (compiti che parte da solo a un orario, anche a computer spento).

Questa parte saltala solo se hai già le idee chiare, perché sennò il resto sembra una gara fra i due e non lo è.

Claude Code vive dentro la tua cartella. È ottimo per il lavoro da seduto: scrivere codice, guidare un progetto, avere un secondo cervello mentre sei davanti allo schermo.

Hermes vive sul tuo server. È sempre acceso e lo apri dal telefono. Fa cron job in due righe, gli parli da Telegram, Slack o Teams, e puoi metterlo in un gruppo dove entra anche il tuo team.

Io li uso tutti e due: Claude Code alla scrivania, Hermes ovunque altro.

Puoi installarlo anche su un Mac Mini, ma la VPS è molto più semplice e costa poco: è un computer nel cloud, tuo, sempre acceso. È esattamente il pezzo che ti puoi permettere solo perché Hermes è open source.

1. Prendi la VPS. Io uso Hostinger, che ha già il template di Hermes pronto: hostinger.com/riccardohermes (con il codice RICCARDOHERMES hai il 10% di sconto).
2. Scegli il piano KVM 2. Hermes consuma un po' di RAM e CPU, sotto quel taglio inizi a soffrire.
3. Posizione del server: Germania va benissimo se sei in Italia.
4. Nella scelta del sistema cerca Hermes e prendi la prima opzione, poi Distribuisci.
5. Salva la password che ti mostra. Mettila in un posto sicuro adesso: è quella con cui entri nel pannello, e non te la rimostra.

Finita la configurazione trovi tutto in VPS › Docker Manager › Progetti › Hermes Agent. Clicchi Apri, metti username e password, e sei dentro il pannello.

Sembra un passaggio inutile, ma è la differenza fra chi usa Hermes due giorni e chi lo tiene. Quando qualcosa si rompe, si ripara da qui.

1. Sessions: tutte le chat aperte, incluse quelle che arrivano da Telegram.
2. Model: quale modello sta usando. Lo cambi quando vuoi.
3. Logs: dove leggi l'errore vero quando smette di rispondere.
4. Cron: la lista dei compiti programmati, anche quelli che crei da Telegram.
5. Skills: le 67 competenze già attive (Claude Code, humanizer, diagrammi, immagini, GitHub, computer use e altre).
6. Plugins e MCP: pacchetti di skill e server MCP installabili con un click.
7. Channels: Telegram, Slack, Teams, WhatsApp.
8. Config › Keys: le chiavi API. È il prossimo passo.

C'è anche una Kanban integrata, con le colonne da idea a in progress: torna utile quando gli deleghi compiti lunghi.

Qui la maggior parte dei tutorial ti fa fare la scelta sbagliata. Hermes ti permette di collegare la tua iscrizione Anthropic o OpenAI e di consumare da lì. Funziona, e sembra un affarone.

Ma stai costruendo il tuo assistente personale sopra un rubinetto che qualcun altro può chiudere domani: sono funzionalità che possono togliere, e in mezzo ci sono anche i ban. Soprattutto, ti riporta esattamente dentro il lock-in da cui l'open source ti aveva tirato fuori.

Io uso OpenRouter: colleghi la carta una volta e da lì scegli qualsiasi modello. Con Deepseek V4 Flash hai un milione di token di input e costi bassissimi: per un assistente personale va più che bene. Tutto il setup e le prime skill mi sono costati pochi centesimi.

1. Fai un account su openrouter.ai, poi Profile › Credits e colleghi la carta.
2. API Keys › New key. Chiamala hermes-agent. Per la scadenza: 90 o 180 giorni è la scelta prudente, altrimenti no expiration.
3. Copia la chiave e nel pannello vai su Config › Keys › OpenRouter › Set. Incolla, Save.
4. Vai su Models, cambia il main model, scegli OpenRouter e seleziona Deepseek V4 Flash. Switch and reload.
5. Apri una chat nuova e scrivi "ciao". Se risponde, il pezzo più importante è fatto.

Attenzione a una cosa. Tanti tutorial ti fanno lanciare /setup dalla chat per configurare tutto in automatico. Non farlo: dà una quantità di problemi che poi passi la serata a districare. La configurazione manuale che hai appena fatto ti evita tutti quei mal di testa.

Da qui in poi Hermes ce l'hai in tasca. Uso Telegram perché per WhatsApp servirebbe comprare un numero dedicato. Se invece lo vuoi dare al team, Slack o Teams sono la scelta giusta.

1. Pannello › Channels › Quick Setup. Ti mostra un QR code.
2. Scansionalo col telefono: si apre BotFather e ti propone di creare il bot. Fatti uno screenshot con nome e username del bot, poi Crea.
3. Si apre la chat col tuo bot. Clicca Avvia: parte in automatico lo /start.
4. Torna sulla dashboard e clicca Save.
5. Nella chat scrivi /set-home. Serve a dirgli "mandami qui tutte le notifiche": è il canale dove ti arriveranno i risultati dei cron job.

Il ponte fra Telegram e la tua VPS si chiama gateway. Nel pannello deve risultare running: se un giorno il bot tace, guarda prima lì.

Se ti risponde lento, non è il modello. Deepseek V4 Flash è piccolo e veloce. Il tempo se ne va nel ragionamento: disattiva show reasoning tokens e le risposte diventano immediate.

Il file soul.md è dove Hermes tiene il modo in cui deve scrivere. Non è obbligatorio, ma è la differenza fra un assistente che suona come un manuale e uno che suona come te.

Prima ti serve una descrizione onesta del tuo stile. Chiedila a Claude o a ChatGPT, che ti hanno già letto per mesi:

Sto configurando il file soul.md di un mio agente AI personale.

Analizza il modo in cui scrivo, basandoti su tutte le nostre
conversazioni, e restituiscimi nel modo più dettagliato possibile:

- come costruisco le frasi (lunghezza, punteggiatura, maiuscole)
- il registro che uso e quanto sono formale
- le parole e le espressioni che uso spesso
- quelle che non uso mai
- come apro e come chiudo un messaggio

Alla fine dammi 10 esempi reali di miei messaggi che rappresentino
bene questo stile.

Poi passi tutto a Hermes, da Telegram o dal pannello:

Voglio passarti il mio stile di scrittura così che tu possa parlare
come parlo io.

Prima carica la tua skill su Hermes per capire esattamente come
funziona il file soul.md e dove si trova.

Poi riscrivilo usando la descrizione e gli esempi che ti incollo qui
sotto. Di default parlami in italiano.

[incolla qui la descrizione e i 10 esempi]

Quando ha finito ti chiede di ricaricare: apri una sessione nuova con /new e da lì in poi scrive come te. Se non hai esempi sottomano, esporta una chat WhatsApp con un amico e passagli quella.

Il cron è il motivo per cui lontano dalla scrivania uso Hermes più di Claude Code. Gli dici a che ora svegliarsi e cosa fare, e lo fa: anche col tuo computer spento.

Non serve nessuna sintassi. Glielo scrivi a parole, in chat, e se ne occupa lui. Questo è quello che uso io per i contenuti:

Voglio creare un cron job.

Ogni mattina alle 9:30 fai scraping degli ultimi post e reel di
questi account:

X: [lista account]
Instagram: [lista account]

Estrai solo le novità rispetto al giorno prima. Su X ti basta il
testo del post; su Instagram devi entrare nel reel e prendere la
trascrizione.

Poi portami un report con le idee di short che ne escono, e io ti
dico quali mi piacciono. Su quelle mi scrivi lo script.

Ti allego qui sotto tre miei script già fatti, così capisci lo stile.

Partiamo da domani, ma facciamo un test adesso per capire se
funziona su X e Instagram.

X e Instagram bloccano lo scraping diretto, quindi a un certo punto ti chiederà un servizio esterno. Fai un account su apify.com, vai su Settings › API, crea un token e incollaglielo: i 5 dollari di credito gratis bastano e avanzano per il primo mese.

Da lì in poi ogni mattina mi porta le novità migliori, filtrate come gli ho detto io, con le idee per i video già pronte. Io non gli chiedo niente: lo trovo già fatto. I reel che nascono da qui vanno quasi sempre virali.

La parte migliore arriva dopo. Quando ha finito, Hermes rilegge quello che ha fatto e si scrive da solo la skill per rifarlo, aggiornandosi anche la memoria. A me si è creato da zero una skill di social scraping mentre facevo altro.

Questa è la parte che quasi nessuno spiega, ed è quella che trasforma Hermes da giocattolo a strumento di lavoro. I topic di Telegram diventano sessioni separate: più agenti che lavorano in parallelo, tutti dal tuo telefono.

1. Su Telegram crea un nuovo gruppo. Anche da solo, per ora.
2. Aggiungi il tuo bot Hermes al gruppo come amministratore.
3. Impostazioni del gruppo › Modifica › attiva i Topic. Mettili come schede.
4. Torna sui permessi del bot e attiva "Gestisci topic". Senza questo ti dirà che il gruppo non è in modalità forum e non riuscirà a creare niente. È l'unico punto in cui ci si incarta.
5. Chiedigli tu i topic che vuoi: "creami due topic, uno Contenuti e uno Analisi Sales".

Nel primo messaggio di ogni topic tagga il bot, poi vai liscio. Da lì apri un thread per i contenuti, uno per l'analisi delle chiamate commerciali, uno per gli investimenti, uno per le news filtrate sui tuoi progetti.

E dato che è un gruppo, ci metti dentro chi vuoi: ogni persona del team usa lo stesso agente, con la stessa memoria e le stesse skill.

Succede, ed è normale. Il bello è che il server è tuo, quindi l'errore vero lo puoi leggere invece di aspettare che qualcuno lo sistemi.

1. Pannello › Logs. Copia il blocco dove compare l'errore.
2. Aprilo dentro Claude Code e fatti dire cosa è successo.
3. Se ha smesso di rispondere a metà: quasi sempre è rimasto in attesa di un tuo click su un pulsante in chat. Rispondi e riparte.
4. Se vuoi ripartire pulito: Config › System › reset memory.

Il mio Hermes Agent gira su una VPS e ha smesso di funzionare.

Questi sono i log del container. Dimmi qual è la causa e i comandi
esatti per sistemarla, uno alla volta.

[incolla qui i log]

Tutto quello che ho citato, in un posto solo.