Hermes Agent — la scheda d'insieme

agg. 2026-09-03mappe_concettuali/hermes_scheda_di_insieme.md

Hermes Agent — la scheda d'insieme

La mappa gemella di questa, Come funziona Hermes Agent, mostra il giro: da dove entra una
richiesta e come si muove. Questa mostra l'inventario: cosa c'è dentro, blocco per blocco, con
i numeri. Si leggono insieme — una risponde a come si muove, l'altra a di cosa è fatto.

Hermes Agent di Nous Research, versione 0.20.6, installata sul mini PC in %LOCALAPPDATA%\hermes.
È un sistema agentico completo, della stessa famiglia di OpenClaw — al punto che esiste una guida
ufficiale per migrare da OpenClaw a Hermes.

Fonti: documentazione ufficiale scaricata il 03/09/2026 in
Agente Residente openclaw/spazio-porto/docs-hermes/ (pagina Architecture, sezioni Skills,
Curator, Security). La stessa scheda in versione stampabile, impaginata su una pagina sola, sta
in Agente Residente openclaw/spazio-porto/schema_hermes.html.

1 · Da dove arrivano le richieste

Molte porte d'ingresso, un solo motore dietro: cambia solo chi bussa.

Terminale — la riga di comando, e una versione a finestre dentro il terminale
App desktop — Windows, Mac, Linux
Messaggistica: 21+ piattaforme — Telegram, Discord, Slack, WhatsApp, Signal, email, SMS, Teams, Matrix e altre
Editor di codice — VS Code, Zed, JetBrains
Server API compatibile OpenAI — qualunque programma che sappia parlare con un modello può parlare con lui
Webhook — eventi da GitHub e simili che lo fanno partire da soli
Attività programmate — il suo cron, con consegna del risultato su una chat
Libreria Python — richiamabile dentro altri programmi

2 · Il motore — cinque passi che si ripetono

Passo	Cosa fa	Cosa c'è da sapere
1	Prepara le istruzioni	Mette insieme personalità, memoria, contesto del progetto e catalogo delle skill
2	Sceglie il modello	Se il fornitore non risponde ne prova un altro da solo
3	Chiede al modello	La chiamata è interrompibile: si ferma a metà senza rompere la sessione
4	Esegue gli strumenti	Anche più d'uno insieme; il risultato rientra nel discorso e si torna al passo 3
5	Risponde e salva	Testo all'utente, sessione su disco, memoria aggiornata prima di perdere il contesto

Due automatismi lavorano di nascosto: oltre metà dello spazio disponibile la conversazione
viene riassunta per poter continuare (l'85% se gira sul gateway della messaggistica), e la parte
fissa delle istruzioni viene riciclata per non ripagarla a ogni turno.

3 · Cosa sa — la memoria

File di testo leggibili, che entrano nelle istruzioni a ogni conversazione. I nomi sono gli stessi
che usiamo noi, e non è una coincidenza.

SOUL.md — carattere e tono
USER.md — chi è l'utente
MEMORY.md — i fatti che restano
AGENTS.md e .hermes.md — il contesto del progetto su cui sta lavorando
Ricerca dentro le sessioni passate — archivio con ricerca a testo pieno: può rileggersi

4 · Cosa sa fare — le skill

Schede di procedura in cartelle, formato aperto agentskills.io: lo stesso delle nostre, quindi
una skill scritta per noi si porta di là quasi senza toccarla.

~90 in dotazione più ~60 installabili a parte, e un hub remoto da cui si cercano e si installano
Non le ha tutte in testa: consulta il catalogo e apre solo quella che serve — noi invece paghiamo l'elenco intero a ogni messaggio
Ogni skill installata diventa un comando /nome
Se le crea da solo partendo da un lavoro appena fatto

5 · Con cosa agisce — gli strumenti

70+ strumenti raggruppati in 28 famiglie, che si accendono e si spengono a blocchi.

Terminale su 6 ambienti — locale, Docker, SSH, Modal, Daytona, Singularity
Browser (5 modi, anche browser in cloud) e ricerca web (4 fornitori)
File, immagini, voce — legge PDF e documenti, genera immagini, parla e ascolta
Server MCP esterni — si collega a strumenti di terze parti
Sottoagenti delegati e lavagna kanban condivisa fra più profili

6 · Il ciclo di apprendimento — il suo tratto distintivo

Finito un lavoro si scrive da solo la procedura per rifarlo; quando la riusa la corregge. A tenere
in ordine il mucchio c'è il curatore, che parte da solo ogni 7 giorni, ma solo se l'agente è
fermo da almeno 2 ore.

30 giorni senza usarla → la skill è marcata da rivedere
90 giorni senza usarla → finisce in archivio, mai cancellata
Le skill fissate o usate da un lavoro programmato sono intoccabili
Il riordino più invasivo — fondere skill simili sotto un'unica scheda — è spento di default, perché costa e cambia troppo

7 · Sicurezza — otto barriere, e una che riguarda noi

Le barriere dichiarate dalla documentazione:

Chi può parlargli — liste di autorizzati e accoppiamento della chat privata
Approvazione umana prima dei comandi distruttivi
Protezione in scrittura sui file
Isolamento in container
Isolamento delle chiavi passate ai server esterni
Scansione dei file di contesto contro i tentativi di dirottare l'agente
Sessioni che non si leggono fra loro
Controllo delle cartelle di lavoro contro le iniezioni di comandi

Attenzione nostra. Le schede skill di Hermes non sono testo inerte: un frammento scritto in un
certo modo viene eseguito al solo caricamento della scheda. Per questo la regola di casa — analisi
di sicurezza prima di installare — qui vale doppio, e vale anche per le skill prese dal suo hub.

A cosa serve questa scheda

È il materiale di partenza del progetto P25 Spazio-Porto, il gestionale con cui governeremo
Hermes. Ogni riga qui sopra è una leva che la plancia potrà avere o non avere: quali stanze
costruire si decide guardando questo elenco, non a memoria.

Mappe concettuali