Dove vivono gli agenti

Documento di orientamento: dove sta fisicamente un agente, cosa si può leggere e correggere
a mano, e in cosa un sotto-agente è diverso da un agente vero.
Serve a rispondere senza esitazione alla domanda "dove lo trovo?".

1. Un agente non ha una casa, ne ha tre

Le tre case sono separate apposta: una è leggibile e modificabile, una è di servizio,
una è il collegamento verso l'esterno. Confonderle è la fonte più comune di errori.

Casa 1 — L'anima: la cartella workspace

È ciò che l'agente è. Contiene i file di identità e di regole, che vengono infilati nel
contesto a ogni avvio di sessione:

È l'unica delle tre case che si apre e si corregge a mano. Cambiare SOUL.md cambia
davvero il comportamento dell'agente dalla sessione successiva.

Casa 2 — La memoria di macchina: \.openclaw\agents\<id>\

Dentro:

• sessions\ — un file per ogni conversazione (verbale integrale, formato .jsonl);
• agent\ — stato interno e plugin di quell'agente.

Roba di servizio: non si modifica a mano, ma è qui che si va a ripescare cosa è
successo davvero in una sessione passata.

Casa 3 — La bocca: il canale

Il collegamento a Discord o Telegram: il token del bot e l'elenco delle stanze in cui
l'agente è autorizzato a parlare. Dichiarato in openclaw.json, blocchi
channels.discord / channels.telegram.

Conseguenza pratica: creare una stanza Discord non basta. Finché la stanza non è
aggiunta all'elenco delle stanze autorizzate, l'agente lì dentro è muto.

Il registro che tiene insieme le tre case

Sempre openclaw.json, blocco agents.list: una riga per agente, con identificativo,
cartella workspace e — se si vuole fissarlo — il modello.

2. Chi c'è davvero (verificato 2026-08-24)

Le due marce di Catone. catone e catone-opus condividono **la stessa cartella
workspace**, quindi la stessa anima: stesse regole, stesso carattere, stessa memoria.
Quello che cambia è il motore — Sonnet 5 per il lavoro corrente, Opus 5 per quando serve
testa. Le loro memorie di macchina restano invece separate (agents\catone\ e
agents\catone-opus\). È il modo pulito per avere "lo stesso agente a due velocità"
senza duplicare l'identità.

3. I sotto-agenti: non hanno nessuna delle tre case

Un sotto-agente non è un agente dichiarato. Non ha una riga in agents.list, non ha una
cartella workspace propria, non ha un bot. Nasce a runtime da un agente esistente, lavora,
consegna e muore.

Dove vive, in concreto:

• Gira dentro il padre. Apre una sessione figlia — chiave agent:<idPadre>:subagent:<codice> — ed eredita workspace e strumenti del padre.
• Il suo verbale finisce nelle sessioni del padre, cioè in agents\<idPadre>\sessions\.
• La sua identità sta in un file di protocollo (una skill, o il testo dell'incarico) che gli si mette addosso al lancio. Non è un inquilino: è un vestito che il padre indossa quando serve.
• Consegna nel canale del richiedente: quando finisce, il risultato viene annunciato nella chat da cui è stato lanciato.

Comandi utili in chat: /subagents list per vedere i lavori in corso,
/subagents info <numero> per lo stato e il percorso del verbale integrale su disco.

Il limite da conoscere: un sotto-agente non ha memoria fra un incarico e l'altro.
Riparte da zero ogni volta. La continuità gliela danno solo gli archivi che lascia dietro
di sé — i referti su disco e nella stanza di consegna. Non ricorda: rilegge.

4. Caso concreto — Plinio, il ricercatore

Deciso il 2026-08-24. Plinio è il sotto-agente di ricerca: scompone la domanda,
interroga più motori, incrocia le fonti e consegna un referto con le citazioni.

• Non è un agente dichiarato. Vive dentro Romeo (main).
• La sua testa è il protocollo di ricerca in workspace\skills\ricercatore\ — un testo unico, riusabile anche da Archimede e Creso.
• Consegna nella stanza Discord #ricerche (categoria 🐱 ROMEO - generico) e lascia il referto scritto su disco.
• Gira su Sonnet 5, non su Opus: raccogliere e confrontare fonti è lavoro di braccia, e Opus pesa molto di più sulla finestra di utilizzo condivisa fra tutti gli agenti.

Perché sotto-agente e non quarto agente residente. Il guadagno vero non è la capacità —
cercare lo sanno fare già tutti gli agenti — è l'isolamento del contesto: una ricerca
seria brucia moltissimo spazio di conversazione, e in questo modo al richiedente torna solo
il referto finale, non le venti pagine lette per produrlo. In più non aggiunge manutenzione:
niente bot, niente cartella, niente registro da tenere allineato.

5. Quando promuovere un sotto-agente ad agente vero

Il segnale non è "lo uso spesso", è "mi serve che ricordi". Finché ogni incarico si
chiude in sé, il sotto-agente basta e costa meno. Si passa ad agente dichiarato quando
serve almeno una di queste:

• memoria fra un incarico e l'altro ("questo l'avevo già cercato a marzo, la conclusione era X");
• una sua voce in una stanza, con cui parlare direttamente senza passare dal padre;
• lavoro programmato proprio (cron che parte da solo, senza che nessuno lo chiami).

La promozione costa: una riga in agents.list, una cartella workspace con i suoi file di
identità, un bot e le autorizzazioni sulle stanze. Vale la pena solo con i dati d'uso in mano.
Vedi il caso di Catone, dichiarato a luglio e rimasto a lungo scollegato proprio perché
mancava il pezzo di canale.

Changelog

• 2026-08-24 — prima stesura. Nasce dalla domanda di Ettore "dove vivrà il sotto-agente di ricerca, e dove vivono gli altri agenti". Registro agenti verificato sul file di configurazione lo stesso giorno.