Mappa concettuale — Come funziona Hermes Agent

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

Mappa concettuale — Come funziona Hermes Agent

Il giro che fa una richiesta dentro Hermes Agent di Nous Research (versione 0.20.6, installata
sul mini PC): da dove entra, come gira nel motore, cosa lo alimenta, con cosa agisce e cosa lascia
dietro di sé. Ordine di lettura: dall'alto verso il basso; le frecce tratteggiate sono i
ritorni, cioè le cose che rientrano nel giro successivo.

Serve al progetto P25 Spazio-Porto, il gestionale con cui governeremo Hermes: per costruire la
plancia bisogna sapere quali leve esistono davvero.

Fonti: documentazione ufficiale scaricata il 03/09/2026 in
Agente Residente openclaw/spazio-porto/docs-hermes/ (pagina Architecture, sezioni Skills,
Curator, Security) · installazione reale in %LOCALAPPDATA%\hermes.

graph TD
  IN["<b>LE PORTE D'INGRESSO</b><br/>terminale · app desktop<br/>21+ piattaforme di messaggistica<br/>editor di codice · API · webhook<br/>attività programmate"]:::ingresso
  IN --> G{{"Chi bussa<br/>è autorizzato?"}}:::guardia
  G -->|no| STOP["Richiesta scartata"]:::blocco
  G -->|sì| SES[["Sessione<br/>ripresa dov'era rimasta"]]:::dato

  SES --> P1["<b>1 · Prepara le istruzioni</b>"]:::motore
  MEM["<b>MEMORIA</b><br/>SOUL.md · USER.md<br/>MEMORY.md · AGENTS.md"]:::sapere -.-> P1
  SKILL["<b>SKILL</b><br/>schede di procedura<br/>~90 + ~60 + hub remoto"]:::sapere -.-> P1

  P1 --> P2["<b>2 · Sceglie il modello</b><br/>se non risponde, ne prova un altro"]:::motore
  P2 --> P3["<b>3 · Chiede al modello</b>"]:::motore
  P3 --> SC{"La risposta è<br/>testo o un ordine?"}:::scelta

  SC -->|"ordine"| APP{{"Il comando<br/>è pericoloso?"}}:::guardia
  APP -->|sì| OK["Chiede il permesso<br/>all'umano"]:::blocco
  APP -->|no| P4
  OK --> P4["<b>4 · Esegue gli strumenti</b>"]:::motore
  P4 --> ATTR["terminale su 6 ambienti · browser<br/>ricerca web · file · immagini · voce<br/>server MCP · sottoagenti · kanban"]:::attrezzo
  ATTR -.->|"il risultato rientra nel discorso"| P3

  SC -->|"testo"| P5["<b>5 · Risponde e salva</b>"]:::motore
  P5 --> ARCH[("Archivio sessioni<br/>ricerca a testo pieno")]:::dato
  ARCH -.->|"rilegge il passato"| P1

  P5 --> NEW["<b>Impara</b><br/>si salva una skill nuova<br/>o corregge quella usata"]:::ciclo
  NEW --> SKILL
  NEW --> CUR{{"Curatore<br/>ogni 7 giorni, se fermo da 2 ore"}}:::guardia
  CUR -->|"30 giorni senza usarla"| ST["Marcata da rivedere"]:::ciclo
  CUR -->|"90 giorni senza usarla"| AR["In archivio<br/>mai cancellata"]:::ciclo

  classDef ingresso fill:#3a2a0a,stroke:#e08a2e,color:#f5e6d0
  classDef motore fill:#0f2233,stroke:#3a86c8,color:#dbeafe
  classDef dato fill:#2a1420,stroke:#c85a8a,color:#f7dbe8
  classDef sapere fill:#132a1e,stroke:#3fb27f,color:#d7f5e6
  classDef attrezzo fill:#22201a,stroke:#c8a13a,color:#f7ecd0
  classDef scelta fill:#22201a,stroke:#c8a13a,color:#f7ecd0
  classDef guardia fill:#2e1414,stroke:#c85a5a,color:#f7dada
  classDef blocco fill:#2e1414,stroke:#c85a5a,color:#f7dada
  classDef ciclo fill:#12291c,stroke:#3fb27f,color:#d7f5e6

Le regole che si leggono dal disegno

Le porte d'ingresso sono tante, il motore è uno solo. Terminale, app desktop, ventun piattaforme di messaggistica, editor, API, webhook e attività programmate finiscono tutte nello stesso ciclo. Una plancia che comanda Hermes non deve inventare un canale nuovo: le basta parlare a una di quelle porte.
Il giro si chiude su sé stesso finché il lavoro non è finito. Se il modello chiede uno strumento, il risultato rientra nella conversazione e si ricomincia dal passo 3. È il motivo per cui un singolo comando può durare minuti e costare parecchio: dentro ci sono molti giri.
Due automatismi lavorano di nascosto (non sono nel disegno perché non hanno una casella propria: succedono dentro i passi 1 e 2). Oltre metà dello spazio disponibile la conversazione viene riassunta per continuare; se il fornitore del modello non risponde, ne prova un altro da solo. Sono comodi, ma vuol dire che quello che l'agente ricorda a metà lavoro non è più quello che gli avevi dato.
L'approvazione dei comandi pericolosi è l'unico punto in cui l'umano entra nel giro. Sta fra la decisione e l'esecuzione: se la si allarga, non resta nessun freno prima del disco.
Impara scrivendosi le procedure, e le taglia da solo col tempo. Trenta giorni senza usarla e una skill è marcata da rivedere, novanta e finisce in archivio — ma non viene mai cancellata, e quelle fissate o usate da un lavoro programmato sono intoccabili.
La memoria è fatta di file di testo con gli stessi nomi dei nostri (SOUL, USER, MEMORY, AGENTS). Non è una coincidenza: esiste una guida ufficiale per migrare da OpenClaw a Hermes, quindi i due sistemi sono cugini, non mondi separati.
Attenzione prima di installare skill dal suo catalogo: le schede di Hermes non sono testo inerte, un frammento scritto in un certo modo viene eseguito al solo caricamento della scheda. La regola di casa — analisi di sicurezza prima di installare — qui vale doppio.

Mappe concettuali