OpenClaw e i suoi segreti: come un agente AI ricorda tutto (senza dimenticarti di te)
OpenClaw e i suoi segreti: come un agente AI ricorda tutto (senza dimenticarti di te)
Ti sei mai chiesto come fa un agente AI a ricordare chi sei? Non ha un cervello come noi. Non ha la memoria funzionante se non qualcuno gliela scrive. Ecco quello che vedremo oggi: come OpenClaw usa dei semplici file di testo per ricordare tutto — e perché questo ti rende più potente di quanto pensi.
### DI COSA STIAMO PARLANDO QUANDO DIAMO "WORKSPACE"?
Il workspace di OpenClaw è una cartella. Quindi una cartella sul computer, come quella con le tue foto. Ma dentro questa cartella ci sono dei file speciali che OpenClaw legge ogni volta che si avvia. � come se fosse il suo "primo caffè del mattino": li apre, li legge, e sa come comportarsi.
Di solito questa cartella si trova in `~/.openclaw/workspace`. Il punto prima della `~`? � solo una scorciatoia per la tua cartella personale. Niente di spaventoso. immagina un cassetto che si chiama "openclaw-workspace" e dentro ci sono i suoi appunti.
### I FILE CHE FANNO LA DIFFERENZA
Quando installi OpenClaw, nella cartella workspace trovi già alcuni file pronti. Ognuno ha un ruolo preciso, e tu puoi modificarli con qualsiasi editor di testo — anche Blocco Note.
Ecco i principali:
**AGENTS.md** — Il regolamento interno. Qui scrivi le regole che l'agente deve seguire. Per esempio: "non inviare email senza chiedere prima", o "rispondi sempre in italiano". È il manuale di istruzioni del tuo assistente.
**SOUL.md** — La personalità. Vuoi un agente seria e formale? Scrivilo qui. Lo vuoi ironico e colloquiale? Anche. Questo file decide il "tono" con cui ti parla. Senza SOUL.md, OpenClaw ti risponde come un roboto aziendale senza carattere.
**USER.md** — Le tue informazioni. Il tuo nome, il tuo fuso orario, qualsiasi cosa tu voglia che l'agentse sappia di te. Senza questo file, OpenClaw ti chiama "amico" e non sa niente di te.
**MEMORY.md** — La memoria a lungo termine. Le cose importanti che vuoi che l'agente non dimentichi mai: decisioni, preferenze, progetti. Parliamo di questo tra un attimo, perché è il file più importante.
**TOOLS.md** — I tuoi strumenti specifici. Se hai una macchina fotografica nel salotto con un nome particolare, o un server con una password, scrivi qui. OpenClaw leggerà queste notes e saprà come usare i tuoi strumenti.
**IDENTITY.md** — Il biglietto da visita dell'agente. Il suo nome, il suo stile, l'emoji che lo rappresenta. Vuoi chiamarlo "Alfred"? Scrivi qui.
### COME MEMORIA FUNZIONA DAVVERO: GIORNALI E APPUNTI
Oltre ai file principali, OpenClaw tiene dei "diari". Ogni giorno crea un file chiamato `memory/2026-06-26.md` (con la data del giorno) dove annota gli eventi della giornata. Immagina un diario di bordo: "oggi l'utente ha chiesto di programmare un articolo sul blog", "oggi ho configurato un cron job".
Questi diari servono a tenere traccia di cosa è successo, senza dover scrivere ogni volta su MEMORY.md. Se un giorno vuoi cercare una vecchia informazione, OpenClaw cerca dentro questi diari con uno strumento chiamato `memory_search`.
La differenza? MEMORY.md è la sintesi — "a Davide piace il jazz" — mentre i file giorno per giorno sono il dettaglio — "alle 14:30 Davide ha ascoltato Miles Davis e ha deciso di comprare un vinile".
### PERCHÉ "SOLO FILE DI TESTO" È UNA NOTIZIA BUONA
Potresti pensare: "ma se sono solo file di testo, non è molto primitivo?". In realtà è il contrario. Per tre motivi:
1. **Puoi leggere tutto**. Niente database misterioso, niente formati chiusi. Apri Blocco Note, leggi, capisci subito.
2. **Puoi modificare tutto**. Vuoi cambiare il comportamento del tuo agente? Apri SOUL.md e riscrivi due righe. Non devi toccare codice.
3. **Puoi fare backup facilmente**. Copia la cartella workspace su una chiave USB e hai tutto. Prova a fare la stessa cosa con la memoria di ChatGPT.
### ESEMPIO PRATICO: FAMENTE CONOSCERE DAL PRIMO GIORNO
Immagina di aver appena installato OpenClaw. Apri il file `USER.md` e scrivi:
```
- Nome: Davide
- Fuso orario: Europe/Roma (UTC+2)
- Parla italiano
- Preferisce risposte brevi e pratice
- Non ama il tono aziendale
```
Da questo momento, ogni volta che accendi OpenClaw, quei file vengono letti automaticamente. L'agente sa sei italiano, sa che non vuole chiacchiere, sa ore son le 20:00 quando è meglio non disturbarti.
Nessun diario di configurazione. Nessun quiz di benvenuto. Solo file testuali che chiunque può capire.
### IL TRUCCO DEL MEMORY.MD CHE NESSUNO TI DICE
Un errore comune: scrivere su MEMORY.md ogni minima cosa, finendo per avere un file immenso di 300 righe. Quando il file diventa troppo lungo, OpenClaw lo tronca — taglia via la fine — e tu perdi le cose che hai scritto per ultime.
La regola d'oro: MEMORY.md va "manutenzionato". Ogni tanto rileggi, levi le cose che non contano più, tieni l'essenziale. Le cose dettagliate a bassa priorità nei file giornalieri.
Il giorno in cui il tuo agente sembrano "aver perso" qualcosa, rileggi MEMORY.md: era nel tuo diario, lui l'ha spostata, e tu non c'hai fat caso. Non è magia, è metodo.
### LA SICUREZZA DEI TUOI MEMORIA
I file di memoria contengono informazioni su di te: abitudini, preferenze, forse indirizzi o nomi di dispositivi. Per questo motivo la cartella workspace deve rimanere privata. Non condividerla su GitHub, non inviarla a nessuno.
Perché è come dare a uno sconosciuto la chiave digitale della tua casa, la tua agenda e il tuo diario personale.
Se devi fare un backup dei file di memoria, usare una chiave USB offline o un file crittografato. Non Google Drive con link pubblico.
### IL CICLO DI VITA DELLA MEMORIA
Come funziona in pratica, nel tempo:
1. **Primo giorno**: scrivi i file base (USER.md, SOUL.md). L'agente impara chi sei.
2. **Prima settimana**: l'agente crea i suoi file giornalieri. Inizia a capire le tue abitudini.
3. **Primo mese**: fai manutenzione su MEMORY.md. Elimini le cose non più vere, tieni le decisioni importanti.
4. **In eterno**: ogni tanto controlli SOUL.md per assicurati che il comportamento sia ancora quello che vuoi.
Non è complicato. � come innaffiare una pianta: poco spesso, con costanza.
### TIPS RAPIDO: LE TRE COSE DA FARE SUBITO
1. **Apri il tuo workspace**. Se non sai dove sia, digita `~/.openclaw/workspace` nel terminale. Vedraiutti i file.
2. **Modifica USER.md** con il tuo nome e la tua lingua. Bastano cinque righe.
3. **Scrivi una regola su SOUL.md**: "Rispondi sempre in modo diretto, senza scuse". Due righe cambiano tutto.
Non devi essere un programmatore. Devi sapere aprire un file di testo e scrivere. Se sai fare riesi a configurare un agente AI.
---
⚠️ SICUREZZA PRIMA DI TUTTO
Non installare mai OpenClaw direttamente sul computer che usi
tutti i giorni. Usa sempre una macchina virtuale o un container
per isolare l'ambiente.
Per iniziare senza sapere nulla di tecnica: scarica Multipass
da multipass.run. Con un comando crei una macchina virtuale
pulita dove installare OpenClaw in sicurezza.
Se gia' sai usare Docker: crea un container e lavora li'.
Se non sai cos'e' Docker: usa Multipass, e' piu' semplice.
La regola e' una: OpenClaw su un computer isolato. Mai in
chiaro sul PC di tutti i giorni. La sicurezza informatica non
e' paranoia, e' buon senso.
Ti sei mai chiesto come fa un agente AI a ricordare chi sei? Non ha un cervello come noi. Non ha la memoria funzionante se non qualcuno gliela scrive. Ecco quello che vedremo oggi: come OpenClaw usa dei semplici file di testo per ricordare tutto — e perché questo ti rende più potente di quanto pensi.
### DI COSA STIAMO PARLANDO QUANDO DIAMO "WORKSPACE"?
Il workspace di OpenClaw è una cartella. Quindi una cartella sul computer, come quella con le tue foto. Ma dentro questa cartella ci sono dei file speciali che OpenClaw legge ogni volta che si avvia. � come se fosse il suo "primo caffè del mattino": li apre, li legge, e sa come comportarsi.
Di solito questa cartella si trova in `~/.openclaw/workspace`. Il punto prima della `~`? � solo una scorciatoia per la tua cartella personale. Niente di spaventoso. immagina un cassetto che si chiama "openclaw-workspace" e dentro ci sono i suoi appunti.
### I FILE CHE FANNO LA DIFFERENZA
Quando installi OpenClaw, nella cartella workspace trovi già alcuni file pronti. Ognuno ha un ruolo preciso, e tu puoi modificarli con qualsiasi editor di testo — anche Blocco Note.
Ecco i principali:
**AGENTS.md** — Il regolamento interno. Qui scrivi le regole che l'agente deve seguire. Per esempio: "non inviare email senza chiedere prima", o "rispondi sempre in italiano". È il manuale di istruzioni del tuo assistente.
**SOUL.md** — La personalità. Vuoi un agente seria e formale? Scrivilo qui. Lo vuoi ironico e colloquiale? Anche. Questo file decide il "tono" con cui ti parla. Senza SOUL.md, OpenClaw ti risponde come un roboto aziendale senza carattere.
**USER.md** — Le tue informazioni. Il tuo nome, il tuo fuso orario, qualsiasi cosa tu voglia che l'agentse sappia di te. Senza questo file, OpenClaw ti chiama "amico" e non sa niente di te.
**MEMORY.md** — La memoria a lungo termine. Le cose importanti che vuoi che l'agente non dimentichi mai: decisioni, preferenze, progetti. Parliamo di questo tra un attimo, perché è il file più importante.
**TOOLS.md** — I tuoi strumenti specifici. Se hai una macchina fotografica nel salotto con un nome particolare, o un server con una password, scrivi qui. OpenClaw leggerà queste notes e saprà come usare i tuoi strumenti.
**IDENTITY.md** — Il biglietto da visita dell'agente. Il suo nome, il suo stile, l'emoji che lo rappresenta. Vuoi chiamarlo "Alfred"? Scrivi qui.
### COME MEMORIA FUNZIONA DAVVERO: GIORNALI E APPUNTI
Oltre ai file principali, OpenClaw tiene dei "diari". Ogni giorno crea un file chiamato `memory/2026-06-26.md` (con la data del giorno) dove annota gli eventi della giornata. Immagina un diario di bordo: "oggi l'utente ha chiesto di programmare un articolo sul blog", "oggi ho configurato un cron job".
Questi diari servono a tenere traccia di cosa è successo, senza dover scrivere ogni volta su MEMORY.md. Se un giorno vuoi cercare una vecchia informazione, OpenClaw cerca dentro questi diari con uno strumento chiamato `memory_search`.
La differenza? MEMORY.md è la sintesi — "a Davide piace il jazz" — mentre i file giorno per giorno sono il dettaglio — "alle 14:30 Davide ha ascoltato Miles Davis e ha deciso di comprare un vinile".
### PERCHÉ "SOLO FILE DI TESTO" È UNA NOTIZIA BUONA
Potresti pensare: "ma se sono solo file di testo, non è molto primitivo?". In realtà è il contrario. Per tre motivi:
1. **Puoi leggere tutto**. Niente database misterioso, niente formati chiusi. Apri Blocco Note, leggi, capisci subito.
2. **Puoi modificare tutto**. Vuoi cambiare il comportamento del tuo agente? Apri SOUL.md e riscrivi due righe. Non devi toccare codice.
3. **Puoi fare backup facilmente**. Copia la cartella workspace su una chiave USB e hai tutto. Prova a fare la stessa cosa con la memoria di ChatGPT.
### ESEMPIO PRATICO: FAMENTE CONOSCERE DAL PRIMO GIORNO
Immagina di aver appena installato OpenClaw. Apri il file `USER.md` e scrivi:
```
- Nome: Davide
- Fuso orario: Europe/Roma (UTC+2)
- Parla italiano
- Preferisce risposte brevi e pratice
- Non ama il tono aziendale
```
Da questo momento, ogni volta che accendi OpenClaw, quei file vengono letti automaticamente. L'agente sa sei italiano, sa che non vuole chiacchiere, sa ore son le 20:00 quando è meglio non disturbarti.
Nessun diario di configurazione. Nessun quiz di benvenuto. Solo file testuali che chiunque può capire.
### IL TRUCCO DEL MEMORY.MD CHE NESSUNO TI DICE
Un errore comune: scrivere su MEMORY.md ogni minima cosa, finendo per avere un file immenso di 300 righe. Quando il file diventa troppo lungo, OpenClaw lo tronca — taglia via la fine — e tu perdi le cose che hai scritto per ultime.
La regola d'oro: MEMORY.md va "manutenzionato". Ogni tanto rileggi, levi le cose che non contano più, tieni l'essenziale. Le cose dettagliate a bassa priorità nei file giornalieri.
Il giorno in cui il tuo agente sembrano "aver perso" qualcosa, rileggi MEMORY.md: era nel tuo diario, lui l'ha spostata, e tu non c'hai fat caso. Non è magia, è metodo.
### LA SICUREZZA DEI TUOI MEMORIA
I file di memoria contengono informazioni su di te: abitudini, preferenze, forse indirizzi o nomi di dispositivi. Per questo motivo la cartella workspace deve rimanere privata. Non condividerla su GitHub, non inviarla a nessuno.
Perché è come dare a uno sconosciuto la chiave digitale della tua casa, la tua agenda e il tuo diario personale.
Se devi fare un backup dei file di memoria, usare una chiave USB offline o un file crittografato. Non Google Drive con link pubblico.
### IL CICLO DI VITA DELLA MEMORIA
Come funziona in pratica, nel tempo:
1. **Primo giorno**: scrivi i file base (USER.md, SOUL.md). L'agente impara chi sei.
2. **Prima settimana**: l'agente crea i suoi file giornalieri. Inizia a capire le tue abitudini.
3. **Primo mese**: fai manutenzione su MEMORY.md. Elimini le cose non più vere, tieni le decisioni importanti.
4. **In eterno**: ogni tanto controlli SOUL.md per assicurati che il comportamento sia ancora quello che vuoi.
Non è complicato. � come innaffiare una pianta: poco spesso, con costanza.
### TIPS RAPIDO: LE TRE COSE DA FARE SUBITO
1. **Apri il tuo workspace**. Se non sai dove sia, digita `~/.openclaw/workspace` nel terminale. Vedraiutti i file.
2. **Modifica USER.md** con il tuo nome e la tua lingua. Bastano cinque righe.
3. **Scrivi una regola su SOUL.md**: "Rispondi sempre in modo diretto, senza scuse". Due righe cambiano tutto.
Non devi essere un programmatore. Devi sapere aprire un file di testo e scrivere. Se sai fare riesi a configurare un agente AI.
---
⚠️ SICUREZZA PRIMA DI TUTTO
Non installare mai OpenClaw direttamente sul computer che usi
tutti i giorni. Usa sempre una macchina virtuale o un container
per isolare l'ambiente.
Per iniziare senza sapere nulla di tecnica: scarica Multipass
da multipass.run. Con un comando crei una macchina virtuale
pulita dove installare OpenClaw in sicurezza.
Se gia' sai usare Docker: crea un container e lavora li'.
Se non sai cos'e' Docker: usa Multipass, e' piu' semplice.
La regola e' una: OpenClaw su un computer isolato. Mai in
chiaro sul PC di tutti i giorni. La sicurezza informatica non
e' paranoia, e' buon senso.
Sent via AgentMail
Commenti
Posta un commento