Come diventare un operatore Hermes Agent

impara a utilizzare e padroneggiare Hermes Agent. configura il template della control room dell'agente, imposta agenti specializzati e passa da un singolo agente a un'intera azienda di marketing su un unico VPS.

la maggior parte degli strumenti AI risponde a domande. Hermes Agent esegue i tuoi workflow dall'inizio alla fine.

naviga nel tuo browser, esegue comandi nel terminale, pianifica cron job, monitora le tue caselle di posta, abbozza il lavoro e pubblica il risultato dove preferisci: Telegram, Discord, Slack, il thread email in cui ti trovi in questo momento.

creato da @NousResearch, è open source con 150.000 stelle su GitHub. Attualmente è al primo posto su OpenRouter per utilizzo globale di token.

è il framework su cui ho costruito tutta la mia operazione di marketing nelle ultime settimane, e l'articolo che stai per leggere è come lo imposterei se iniziassi oggi.

cosa otterrai da questo articolo

• cos'è Hermes Agent e perché i marketer (non solo gli sviluppatori) dovrebbero interessarsene
• la versione facile da leggere dell'architettura: il cervello, la personalità, le competenze e come vivono tutte in una cartella
• i casi d'uso che sto personalmente eseguendo su Hermes, con i quattro post che ho pubblicato al riguardo
• il modello mentale a quattro parti (tu, control room, agenti, task bus opzionale) e i quattro livelli di configurazione, da "un agente sul tuo laptop" a "un team di agenti completamente automatizzato su un VPS che controlli dal tuo telefono"
• la metodologia prototipo → produzione che uso per portare un workflow di marketing da un'idea confusa a un deployment autonomo
• le risorse che avrei voluto avere dal primo giorno: documentazione, l'atlante della community, le persone da seguire, i meetup in corso in questo momento
• i compromessi onesti e dove ancora si rompe

Non ti sto vendendo nulla in questo articolo. Hermes è open source, Nous Portal ha un tier gratuito, e gran parte dell'ecosistema della community è gratuito. Fai un fork, modifica, rendilo tuo.

cos'è Hermes Agent

versione breve: un agente autonomo che diventa più capace più a lungo funziona.

versione più lunga: Hermes è un framework creato da Nous Research che trasforma un modello in un operatore persistente. Ha una propria memoria che sopravvive tra le sessioni. Scrive le proprie competenze mentre lavora. Viene fornito con 123 competenze già integrate (workflow GitHub, Obsidian, Google Workspace, Linear, Notion, Typefully, Perplexity, Deep Research, più altre 100+). Vive dove lo metti: sul tuo laptop, in un container Docker, su un VPS, in un runtime serverless. E puoi parlargli attraverso oltre 20 superfici: Telegram, Discord, Slack, email, modalità vocale o semplicemente il tuo terminale.

Se hai usato Claude Code o OpenClaw, Hermes ha la stessa forma ma con una filosofia diversa.

Hermes è come avere delle rotaie. Impostazioni predefinite chiare, batterie incluse, produttivo dal primo giorno con una configurazione minima, l'agente fa più pensiero per te.

OpenClaw è Linux. Primitivi, garanzie, controllo esplicito, l'agente fa esattamente quello che gli hai detto e niente di più.

Entrambi sono validi. Io uso Hermes perché le impostazioni predefinite integrate si accumulano. Ogni progetto che avvio con Hermes è uno in cui l'agente sa già fare più di 100 cose prima che io scriva una riga di configurazione. Questo vantaggio iniziale per me vale la pena. Ho anche notato che Hermes non ha lo stesso problema di disconnessione del gateway o di bug.

La prova sta nei numeri che Nous Research ha appena raggiunto:

• #1 su OpenRouter per utilizzo globale di token (tra tutti i modelli e framework sulla piattaforma)
• 150.000 stelle GitHub sul repository di Hermes
• 123 competenze incluse prima che l'agente ne scriva una propria
• oltre 70 strumenti integrati nel gateway, più 300+ modelli con un unico abbonamento
• 6 obiettivi di deployment: locale, Docker, SSH, Daytona, Singularity, Modal
• oltre 20 superfici di messaggistica: Telegram, Discord, Slack, email, voce

Se sei un marketer AI e non hai ancora iniziato a usare Hermes, stai lasciando sul tavolo capacità che si accumulano ogni settimana.

come funziona (la versione facile da leggere)

Ogni agente Hermes ha tre cose.

Un cervello. La memoria vive in ~/.hermes/memories/. Due file, MEMORY.md e USER.md, vengono iniettati all'inizio della sessione. La tua rubrica vocale, le tue note sul brand, il linguaggio dei clienti, le correzioni della scorsa settimana, tutto viene caricato prima del primo prompt. Le sessioni sono archiviate in SQLite, la ricerca tra le sessioni è full-text.

Una personalità. soul.md è dove vive il tono. Conciso. Sarcastico. Dritto. Formale. Veloce o riflessivo. Puoi creare sei agenti e dare a ciascuno un'anima diversa, con lo stesso cervello sottostante. Uno è il tuo rappresentante per le vendite con l'energia di un chiusore. Un altro è il tuo ricercatore a cui piacciono le frasi lunghe. Un altro è il tuo assistente che tiene tutto breve.

un set di competenze.

123 competenze pronte all'uso: PR GitHub, Obsidian, Google Workspace, Linear, Notion, Typefully, Perplexity, Deep Research, controllo browser, web scraping, visione, voce, pianificazione. E il ciclo di apprendimento chiuso: mentre l'agente lavora, scrive nuove competenze lungo il percorso. La tua libreria di competenze personali cresce sopra le 123 senza che tu debba scriverne nessuna.

Poi c'è ciò con cui l'agente può parlare.

• Il gateway degli strumenti: un abbonamento, 300+ modelli, più web scraping e automazione del browser integrati
• Integrazione MCP: qualsiasi servizio esterno che parli Model Context Protocol diventa uno strumento che il tuo agente può usare
• oltre 20 superfici di messaggistica: Telegram, Discord, Slack, email, voce, più la CLI stessa

E dove l'agente può vivere.

• Il tuo laptop (locale)
• Un container Docker (isolato, portatile, il modo in cui lo uso io)
• Una sessione SSH su un VPS (così funziona anche quando il tuo laptop è chiuso)
• Daytona, Singularity, Modal (serverless se non vuoi gestire l'infrastruttura)

Il ciclo di apprendimento chiuso è ciò che rende questo diverso da un chatbot intelligente. L'agente si osserva mentre lavora, scrive nuove competenze mentre impara la forma del tuo lavoro, perfeziona periodicamente la sua memoria e richiama il contesto passato tra le sessioni usando una combinazione di ricerca full-text e riepilogo LLM. Non devi re-insegnargli la prossima settimana.

La regola che dico alle persone nuove a Hermes è questa: non cercare di scrivere le tue competenze il primo giorno. Esegui lavoro reale, lascia che l'agente osservi e lascia che il telaio scriva le competenze. Costruisci una libreria di competenze personalizzate più velocemente lavorando che scrivendo prompt.

cosa sto eseguendo su Hermes

Sono un marketer AI, non un programmatore. La maggior parte di ciò che eseguo su Hermes è infrastruttura di marketing con qualche strumento interno occasionale. Ecco l'elenco reale:

• un assistente personale che gestisce affari e privato, vive su Telegram, segnala ogni mattina le quattro email che vale la pena leggere, pianifica i miei promemoria, riassume le riunioni che mi sono perso
• un banco di prova per la prototipazione di workflow di marketing dove testare nuovi flussi (lead magnet, revisione creatività pubblicitaria, sprint di contenuti) contro lavoro reale per 2-3 esecuzioni prima di promuoverli
• agenti di marketing specializzati: SEO, outbound/BD, revisione design, scrittura contenuti, ciascuno con la propria anima e il proprio ambito
• un cervello aziendale che monitora Slack, chat, email, trascrizioni, memo vocali e rende tutto interrogabile. Quando chiedo "cosa abbiamo detto a quel cliente sui prezzi il mese scorso?" ottengo la risposta in 3 secondi invece di 30 minuti di ricerca
• un agente SEO che esegue l'intera pipeline dalla parola chiave seme all'articolo pubblicato in un unico container Docker, 21 passaggi, nessun umano in mezzo fino alla revisione finale
• un agente di distribuzione dei contenuti che prende un pezzo long-form (questo articolo, per esempio) e lo atomizza su LinkedIn, X, Threads, con hook specifici per piattaforma
• un agente orchestratore che non produce lavoro da solo, ma instrada le richieste allo specialista giusto in base a ciò che sto chiedendo

Il blueprint che ho pubblicato e che lo riassumeva:

l'agente SEO in particolare merita uno zoom, perché è quello che ho rilasciato pubblicamente e quello che si allinea meglio all'architettura nel resto di questo articolo. Cinque livelli, tutti all'interno di un container Docker, 21 passaggi dalla parola chiave seme all'articolo pubblicato.

I 21 passaggi appaiono così nel terminale:

I livelli sopra questa pipeline:

1. cervello aziendale in cima: visione, brand, pubblico, prodotti. Ogni agente legge da questo
2. agente orchestratore Hermes: prende l'argomento o la parola chiave seme e lo instrada all'agente SEO
3. cervello SEO: playbook di ranking, regole vocali, formati di contenuto, guida di stile visivo, criteri di successo per formato. Tutto il contesto specifico per SEO vive qui
4. tre sotto-agenti all'interno dell'agente SEO, ciascuno gestisce una fase:
5. ricerca + ideazione: parola chiave seme, snapshot SERP, estrazione concorrenti, analisi intenti e formato, gap di contenuto e visivo, validazione interna ed esterna
6. produzione: brief di angolazione e posizionamento, brief di strategia visiva, schema, bozza, generazione immagini, generazione diagrammi di flusso, QA visivo e articolo
7. distribuzione: preparazione pubblicazione, schema, linking interno, syndication, analisi, monitoraggio
8. un container Docker contiene tutti e tre i sotto-agenti. Condividono env, memoria e strumenti. I sotto-profili cambiano contesto per fase. Un processo, un filesystem, un set di credenziali.

Perché un container invece di tre: il lavoro SEO è sequenziale. La ricerca alimenta il brief, il brief alimenta la produzione, la produzione alimenta la distribuzione. Ogni passaggio ha bisogno della memoria di ciò che è stato deciso a monte. Dividere in tre container significa trasportare lo stato attraverso i confini, il che diventa costoso e rompe la catena.

Ogni altro agente specializzato nell'azienda funziona sullo stesso template. Clona il template dell'agente SEO, sostituisci il cervello (cervello SEO → cervello outbound, o → cervello design, o → cervello supporto) e hai un nuovo agente per qualsiasi funzione con la stessa forma a cinque livelli.

I livelli non sono decorazione. Sono la ragione per cui l'agente non perde contesto mentre il lavoro si specializza. Il cervello aziendale rimane stabile mentre il lavoratore itera. I livelli del cervello rendono il lavoratore sostituibile.

Ho anche ospitato Nous Research presso il nostro quartier generale @EspressioAI a Lisbona per una serata su Hermes Agent di recente. @yeahfortommy di Nous ha tenuto un Q&A, Simao di noticed .so ha mostrato un telaio per agenti con ricerca automatica, e io ho spiegato come stiamo usando Hermes per la crescita in Espressio.

Se sei a Lisbona e vuoi venire al prossimo, posterò quando sarà programmato.

da un agente a un'intera flotta

Prima dei livelli, il modello mentale.

La configurazione ha quattro parti:

• tu sei l'operatore. Hai accesso diretto a ogni parte del sistema.
• la control room dell'agente è il piano di controllo laterale. Non è un agente con cui chatti. È una cartella in /root/vps-agents che documenta e governa l'intera flotta. La apri, la modifichi, la ispezioni, o chiedi a Claude, Codex o Hermes di usarla quando stai gestendo il sistema.
• gli agenti Hermes sono i lavoratori. Alcuni sono specialisti (SEO, dev, CMO, operazioni). Uno di essi può opzionalmente essere un orchestratore.
• il task bus dell'agente è un desk di passaggio opzionale che si trova tra l'orchestratore e gli specialisti. Ti serve solo quando hai un orchestratore in gioco.

Il tutto appare così:

La suddivisione dell'archiviazione è più importante di quanto si pensi:

la control room contiene le risposte a domande come: quali agenti esistono, cosa fanno, quali porte usano, a quali credenziali fanno riferimento, cosa ogni agente può e non può fare, e come riavviare, fare debug o ricostruire ciascuno di essi. Il runtime live contiene il funzionamento effettivo.

La control room è il cervello che definisce il sistema. Il runtime live è il corpo che lo esegue. Puoi ricostruire il corpo dal cervello. Non puoi ricostruire il cervello dal corpo.

All'interno della control room:

E all'interno del runtime di ogni agente in /srv/<nome-agente>/data/:

tre modi in cui interagisci

• il percorso di controllo è il meta-livello. Usato quando aggiungi agenti, rivedi documenti, controlli le porte, ruoti le chiavi, fai debug della configurazione.
• il percorso diretto è il più veloce. Usato quando sai già quale agente fa il lavoro.
• il percorso orchestrato è il sintetizzatore. Usato quando vuoi una porta d'ingresso che instradi e combini il lavoro tra più specialisti.

livello 1: un agente

Hai un agente Hermes. Tutto qui. La control room può comunque esistere (consigliato) ma documenta solo quell'agente.

Ideale per: configurazione iniziale, il tuo Hermes personale, documentazione di installazione root, semplice migrazione Docker.

Un agente, vissuto, con una personalità che hai ottimizzato e una memoria che ha iniziato a costruirsi. Compila SOUL.md con la voce che vuoi, MEMORY.md con i fatti stabili sulla tua attività e USER.md con i fatti stabili su di te. Collegalo a Telegram o Discord in modo che viva dove sei tu. Inizia a usarlo per compiti reali. Lascia che tocchi i tuoi strumenti. Lascia che scriva le proprie competenze lungo il percorso.

MEMORY.md contiene i fatti stabili (cos'è la tua attività, chi sono i tuoi clienti, cosa fanno i tuoi prodotti). USER.md contiene i fatti stabili su di te (fuso orario, ore lavorative, progetti ricorrenti, formati di output preferiti). Entrambi vengono perfezionati ogni settimana mentre correggi l'agente nelle conversazioni reali.

livello 2: agenti specialisti diretti

Hai più agenti specializzati, ma parli ancora direttamente con ciascuno. Nessun orchestratore ancora.

La control room li documenta tutti.

Ideale per: chiara separazione dei ruoli, testare quali agenti sono utili, evitare orchestrazione prematura, mantenere le credenziali con ambito per agente.

La trappola da evitare qui è cercare un orchestratore prima di aver dimostrato che i tuoi specialisti sono utili. Avviane due o tre, eseguili direttamente e aggiungi un orchestratore solo quando ti ritrovi a volere una porta d'ingresso.

Quando creare un nuovo agente vs rimanere con ciò che hai:

Modello sbagliato: un mega-agente con ogni credenziale e ogni livello di memoria mischiati insieme. Perdi isolamento, perdi la capacità di revocare l'accesso in modo pulito e l'agente si confonde su quale voce usare.

livello 3: orchestratore + specialisti

Aggiungi hermes-orchestrator come porta d'ingresso. Puoi ancora parlare direttamente con gli specialisti, ma l'orchestratore può instradare il lavoro e sintetizzare i risultati.

L'orchestratore legge la control room per sapere quali agenti esistono, cosa fa ciascuno, dove vivono le code di attività, cosa richiede approvazione, quali azioni sono vietate e dove sono documenti e runbook. Non ha bisogno di chiedertelo, lo legge.

Ideale per: lavoro interfunzionale, delega, riepilogo e sintesi, un'interfaccia principale per workflow multi-agente.

L'orchestratore è il momento in cui la tua configurazione smette di essere una collezione di agenti e inizia a essere un team. È anche il momento in cui la control room guadagna la sua importanza, perché l'orchestratore è valido solo quanto i documenti che legge.

Come appare un rapido check-in sulla flotta dal mio laptop o telefono:

livello 4: team di agenti automatizzato

Stessa forma del livello 3, ma con workflow ricorrenti e automazione più forte. Rapporti SEO settimanali eseguiti su cron. Controlli di integrità del server giornalieri. Verifica del backup eseguita senza che tu lo chieda. Workflow aziendali tra agenti avviati su pianificazione.

Ideale per: rapporti SEO settimanali, operazioni di contenuti, controlli di integrità del server, verifica del backup, workflow aziendali tra agenti.

Il livello 4 è come appare un reparto marketing nel tuo terminale. Non ha bisogno che tu inizi la giornata. Si presenta al lavoro da solo, produce rapporti, si controlla e ti contatta solo per le decisioni che richiedono gusto.

la gerarchia di controllo

Un principio da tenere a mente mentre sali di livello.

La control room è per configurazione, documenti, runbook e governance. Documenta quali agenti esistono, cosa fanno, dove girano, a quali credenziali fanno riferimento, cosa ogni agente può e non può fare. È il pannello di amministrazione per la flotta, incluso l'orchestratore. Non è dove vai per lavorare.

Per lavorare, parli direttamente con gli agenti. O uno specialista (quando sai quale agente possiede il compito) o l'orchestratore (quando vuoi una porta d'ingresso per instradare tra specialisti).

la guida alla configurazione: punta il tuo agente al repository

Ora capisci l'architettura. Ecco come la costruisci.

Ho rilasciato un template pubblico che contiene la struttura esatta descritta sopra, più le competenze di cui il tuo agente ha bisogno per impostarla per te.

Si trova su github.com/shannhk/hermes-agent-control-room.

Puoi clonarlo manualmente, ma il punto è che non è necessario. Se hai Claude Code o Codex sul tuo laptop, gli agenti fanno la maggior parte del lavoro dopo che gli hai fornito una chiave API di Hetzner.

Il flusso automatizzato:

In dieci-quindici minuti hai:

• un nuovo VPS Hetzner con gli strumenti giusti installati
• la control room clonata in /root/agent-control-room sul VPS
• le competenze incluse collegate in ~/.claude/skills sul VPS
• un agente Hermes registrato, runbook compilato, env-map scritta
• un alias SSH sul tuo laptop così ssh hermes si connette immediatamente

la metodologia prototipo → produzione

La maggior parte dei workflow non inizia come quelli di produzione. Iniziano disordinati. Un flusso che esegue ricerca SEO, abbozza un articolo, lo pianifica in Typefully e lo pubblica su LinkedIn non esiste nella tua testa già completo. Lo scopri eseguendolo.

Hermes è l'ambiente di prototipazione per questo. Ecco il percorso in quattro passaggi che uso per portare qualsiasi nuovo workflow di marketing dall'idea al deployment autonomo:

1. prototipo in Hermes. Apri il tuo agente Hermes principale, descrivi cosa vuoi che accada e lascia che ci provi. Sbaglierà la maggior parte delle cose al primo tentativo. Va bene.
2. eseguilo 2-3 volte su lavoro reale, correggendo la deriva ogni volta. Il telaio osserva ogni correzione e inizia a scrivere la competenza mentre impara la forma. Al terzo tentativo l'agente fa quasi tutto ciò che vuoi senza istruzioni.
3. perfeziona in uno spazio di lavoro dedicato. Sposta il workflow in uno spazio di lavoro separato di Claude Code (o un nuovo agente Hermes se preferisci), stringi i prompt, blocca il routing, aggiungi gestione degli errori, decidi cosa dovrebbe girare su cron e cosa dovrebbe essere attivato.
4. distribuisci su un VPS con una pianificazione. Una volta che sopravvive a una settimana di esecuzioni reali senza che tu lo sorvegli, spingilo nel suo container Docker sul tuo VPS, imposta il cron e allontanati.

Ho imparato questo schema dopo aver perso alcuni weekend cercando di scrivere agenti di produzione da zero. Non puoi scrivere un agente di produzione da zero. Devi farne crescere uno. Hermes rende veloce la parte della crescita.

1. prototipo in Hermes
2. perfeziona in uno spazio di lavoro dedicato
3. distribuisci autonomamente su un VPS

i modelli che eseguo su Hermes

Hermes ti dà il framework. Il modello sottostante è una tua scelta. Attraverso il gateway degli strumenti puoi instradare a 300+ modelli con un unico abbonamento, cambiando per agente o per compito.

Cosa eseguo personalmente oggi:

• claude opus 4.7 per il lavoro creativo: copywriting, voce, generazione di hook, bozze di contenuti, tutto ciò in cui il gusto e la qualità della scrittura contano
• codex (gpt 5.5) per il lavoro strutturato: programmazione, pianificazione, workflow multi-fase, automazione browser, scraping, tutto ciò in cui i passaggi devono essere precisi e l'output prevedibile

Eseguo entrambi. Opus scrive. Codex costruisce e pianifica. Hermes rende facile il routing: punti ogni agente al modello che si adatta al lavoro che fa.

Se puoi eseguirne solo uno, la risposta dipende dal tipo di lavoro che fa la tua flotta. Molto incentrato su contenuti e copy? Inizia con claude opus 4.7. Molto incentrato su infrastruttura, automazione e workflow di ingegneria? Inizia con codex. Puoi sempre aggiungere il secondo modello più tardi attraverso lo stesso gateway degli strumenti.

compromessi onesti

Non ho intenzione di fingere che Hermes sia perfetto. Tre compromessi reali.

1. Le impostazioni predefinite incluse sono anche opinioni. Hermes viene fornito con impostazioni predefinite forti su come funziona la memoria, come vengono scritte le competenze, come l'agente usa gli strumenti. Questo è il punto centrale. Ma significa anche che se vuoi primitivi con controllo esplicito su ogni passaggio, Hermes ti sembrerà pesante. OpenClaw è la scelta migliore per quel gusto. Scegli lo strumento che corrisponde alla tua filosofia.

1. I livelli 3 e 4 hanno una vera curva di apprendimento. Docker, VPS, SSH, la struttura di cartelle della control room, le competenze dell'orchestratore, niente di tutto questo è "installa e via". Non dovresti saltare al livello 3 se non stai già usando Hermes al livello 1 quotidianamente.

1. Il modello è ancora importante. Hermes è un framework che rende un buon modello eccezionale. Non rende un modello piccolo uno stratega. Usa i modelli più potenti che puoi permetterti per il lavoro importante (il tuo orchestratore, il tuo agente strategico, il tuo cervello). Scendi a modelli più economici per il lavoro che non lo richiede (scraping di ricerca, generazione di bozze, elaborazione batch).

Niente di tutto questo è magia. È un framework che ripaga perché la memoria persiste, le competenze si accumulano e gli agenti rimangono con un ambito definito. Applicalo al modello di dimensione sbagliata e ottieni un team confuso. Applicalo a quello giusto e ottieni un team.

risorse

Se stai iniziando oggi, ecco cosa leggerei in ordine.

• la documentazione ufficiale: hermes-agent.nousresearch.com/docs. Inizia con la guida all'installazione, poi leggi la pagina delle competenze per capire cosa viene fornito già pronto
• il template della control room (il mio repository): github.com/shannhk/hermes-agent-control-room. La struttura esatta che ho descritto sopra, pronta per essere clonata. Template control-room-first per gestire agenti Hermes da un agente VPS a team di specialisti e workflow orchestrati. Fai un fork e rendilo tuo
• hermesatlas.com: la mappa curata dalla community di oltre 100 strumenti open source, plugin, spazi di lavoro e integrazioni costruite su Hermes. Categorizzata per dominio (provider di memoria, spazi di lavoro, registry di competenze, deployment, orchestrazione). Include anche l'Hermes Handbook, una guida per principianti. Aggiornamenti settimanali, newsletter gratuita
• @Teknium su X: fondatore di Nous Research. Pubblica aggiornamenti su Hermes quasi quotidianamente. L'integrazione del runtime Codex, il tier gratuito DeepSeek V4 Flash su Nous Portal, le competenze pretext, tutto è arrivato prima dal suo feed
• @NousResearch su X: l'account ufficiale, annunci ufficiali delle funzionalità
• i meetup: ci sono meetup di Hermes in presenza ora (Lisbona, Ventura, altre città). Vale la pena presentarsi se ce n'è uno vicino a te. Impari di più in 90 minuti di conversazioni informali che in una settimana di letture

Spero che tu abbia trovato utile questo articolo, grazie per averlo letto fino in fondo.

-- Shann