OpenClaw Heartbeat e Memoria: come il tuo agente AI ricorda chi sei (e non impazzisce)
# OpenClaw Heartbeat e Memoria: come il tuo agente AI ricorda chi sei (e non impazzisce)
**Ti è mai capitato di chiedere qualcosa al tuo assistente AI e lui ti risponde come se non si fosse mai sentito?** Come se ogni conversazione partisse da zero, ogni volta, senza sapere chi sei o cosa hai detto prima?
Noi umani abbiamo la memoria. La svegliamo la mattina e sappiamo chi siamo, cosa dobbiamo fare, chi abbiamo parlato ieri. Un assistente AI, invece, nasce "pulito" ogni volta. È come un collega nuovo ogni giorno, finché non gli dai un sistema per ricordare.
**Ecco dove entrano in gioco due funzioni di OpenClaw che cambiano tutto: il sistema di memoria (MEMORY.md) e l'Heartbeat.**
Ti spiego come funzion passo dopo passo, senza dare nulla per scontato.
---
## Perché il tuo agente AI dimentica tutto (e non è colpa sua)
Ogni volta che parli con OpenClaw, quella conversazione vive in una "sessione". Immagina una sessione come un appuntamento: dura un certo poi finisce. Quando il prossimo appuntamento inizia, il tuo agente non ha il diario del precedente. Parte da zero.
**Non è un bug. È il funzionamento normale dell'AI.**
Il problema è che senza memoria, il tuo agente non sa:
- Come ti chiami
- Quali sono le tue preferenze
- Cosa hai chiesto ieri
- Qual hai detto di fare la settimana scorsa
È come spiegare ogni giorno al tuo postino chi sei. Stancante, no?
OpenClaw risolve questo con due strumenti: i **file di memoria** e l'**Heartbeat**. Due cose semplici che, messe insieme, creano un assistente che impara e cresce con te.
---
## Il sistema di memoria: il diario del tuo agente
OpenClaw usa dei file di testo (sì, dei semplici file, come quelli che apri con il Blocco Note) per salvare informazioni tra una sessione e l'altra.
I due file principali sono:
### 1. MEMORY.md — La memoria a lungo termine
Pensa a questo file come il quaderno principale del tuo agente. Qui salvi le cose importanti, quelle che non devono mai perdersi:
- Il tuo nome e come vuoi essere chiamato
- Le tue preferenze (lingua, tono, cose che non sopporti)
- Decisioni importanti che avete preso insieme
- Lezioni apprese ("la volta che ho sbagliato perché...")
**Un esempio concreto:**
Se dici al tuo agente "mi chiamo Davide, odiano le risposte lunghe, parla in modo informale", queste informazioni finiscono in MEMORY.md. La prossima volta che apri una conversazione, il tuo agente legge quel file e sa già come comportarsi.
### 2. memory/YYYY-MM-DD.md — Il diario quotidiano
Ogni giorno, OpenClaw crea un nuovo file nella cartella "memory" (memoria in inglese). È come un diario di bordo: cosa è successo oggi, cosa avete fatto, cosa è da fare domani.
**Un esempio concreto:**
```
memory/2026-06-24.md
- Davide ha chiesto di configurare le email
- Abbiamo deciso di usare AgentMail invece di Gmail diretto
- Da fare: verificare che l'invio funzioni con Telegram
```
Quando il tuo agente si sveglia e legge il diario di oggi e la memoria a lungo termine, ha tutto il contesto. Non devi ripetere nulla.
---
## Come funziona la memoria nella pratica
Ecco il flusso semplice:
1. **Tu parli con l'agente** → gli chiedi qualcosa o gli dai un'informazione
2. **L'agente scrive** → salva l'informazione importante nei file di memoria
3. **La prossima volta** → l'agente legge quei file prima di rispondere
4. **Risponde con contesto** → sa chi sei, sa cosa hai detto, non parti da zero
**Niente magia, niente database complicati.** Solo file di testo che si leggono e si scrivono. Semplice, trasparente, controllabile.
Puoi aprire quei file quando vuoi. Leggerli, modificarli, cancellare quello che non ti piace. Tu hai il controllo.
---
## L'Heartbeat: il tuo agente che si "sveglia" da solo
Ora hai un agente che ricorda chi sei. Ma come fa a fare cose senza che tu gli parli ogni volta?
**Immagina un impiegato che ogni mezz'ora controlla la sua scrivania:** "C'è posta nuova? Qualcuno mi ha scritto? C'è qualcosa da fare?" Se non c'è nulla, torna a sedersi. Se c'è qualcosa, si attiva.
Questo è l'Heartbeat di OpenClaw.
L'Heartbeat è un "battito cardiaco" che l'agente riceve a intervalli regolari (ogni 30 minuti, più o meno). Quando lo riceve, si sveglia e controlla:
- **Email** → arrivato qualcosa di urgente?
- **Calendario** → appuntamento tra poco?
- **Notifiche** → qualcosa di interessante?
- **Compiti programmati** → qualcosa da fare ora?
Se trova qualcosa di importante, ti contatta. Se non c'è nulla, torna a dormire. Senza disturbarti.
**Perché è utile?**
Perché il tuo agente può essere proattivo. Non devi tu controllare ogni cosa: lui ti avvisa quando serve. Come un buon assistente che ti dice "hey, tra 20 minuti hai quella riunione" senza che tu gli chieda.
---
## Heartbeat vs Cron: qual è la differenza?
Hai sentito parlare dei Cron Job (articolo scorso) e ti stai chiedendo: "Heartbeat e Cron sono la stessa cosa?"
**No, ma sono parenti.**
| | Heartbeat | Cron Job |
|---|---|---|
| **Frequenza** | Ogni ~30 minuti | Quando vuoi tu (ogni lunedì, ogni ora, una volta sola) |
| **Controlla** | Email, calendario, notifiche | Qualsiasi cosa tu gli abbia chiesto di fare |
| **Si sveglia da solo** | Sì, sempre | Solo quando programmato |
| **Ti avvisa** | Solo se trova qualcosa | Sempre (o solo se dici) |
**La regola semplice:**
- **Heartbeat** = controllo generale, periodico, "c'è qualcosa di interessante?"
- **Cron Job** = compito specifico, programmato, "fai questa cosa a quest'ora"
---
## Come attivare e configurare l'Heartbeat
L'Heartbeat in OpenClaw si gestisce con un file chiamato `HEARTBEAT.md`. Sì, hai capito bene: un file che dice al tuo agente cosa controllare quando si sveglia.
**Ecco un esempio semplice:**
```markdown
# HEARTBEAT.md
## Cose da controllare (2-3 volte al giorno)
- Email: arrivato qualcosa di urgente?
- Calendario: appuntamenti nelle prossime 24-48 ore?
- Meteo: pioggia prevista oggi?
## Quando stare zitto
- Tra le 23:00 e le 08:00, non disturbare
- Se non c'è nulla di nuovo dall'ultimo controllo
- Se ho già scritto a Davide negli ultimi 30 minuti
```
Vedi? Scri in linguaggio normale. Non è codice, non è un programma. È una lista di cose da fare, scritta come la scriveresti su un post-it.
**Dove si mette questo file?** Nella cartella principale del tuo workspace OpenClaw, insieme a MEMORY.md. Lo trovi facilmente.
---
## Un esempio concreto di giornata con Heartbeat
Immagina una giornata tipo:
**07:00** — L'Heartbeat si attiva. Controlla il calendario: "Alle 10:00 Davide ha una riunione importante". Ti manda un messaggio: "Buongiorno! Alle 10 hai la riunione con il cliente X. Vuoi che ti prepari un riassunto?"
**12:30** — L'Heartbeat si attiva. Controlla le email: niente di urgente. Non ti scrive.
**15:00** — L'Heartbeat si attiva. Trova un'email importante che era arrivata a mezzogiorno. Ti avvisa: "Hai un'email urgente dal tuo commercialista. Vuoi che la legga?"
**23:30** — L'Heartbeat si attivo. Controlla l'orario: è tardi. Non ti scrive. Buonanotte.
**Non hai dovuto chiedere nulla.** Il tuo agente ti ha avvisato solo quando serviva.
---
## La memoria che cresce: come il tuo agente migliora nel tempo
Questa è la parte che mi piace di più.
Man mano che usi OpenClaw, il file MEMORY.md si arricchisce. Il tuo agente impara:
- **Settimana 1:** Sa il tuo nome e la tua lingua
- **Settimana 2:** Sa che preferisci risposte brevi e tono informale
- **Settimana 3:** Sa che ogni lunedì devi fare un report, e te lo chiede
- **Settimana 4:** Sa che non sopporti certi tipi di risposte, e li evita
**Non è magia. È memoria.**
E il bello è che tutto è trasparente. Puoi aprire MEMORY.md e vedere esattamente cosa il tuo agente "sa" di te. Puoi correggere, aggiungere, cancellare. Se il tuo agente sta imparando qualcosa di sbagliato, basta una modifica al file e il problema è risolto.
---
## Trucchi pratici per la memoria
Qualche consiglio per usare al meglio la memoria di OpenClaw:
**1. Non aspettare che l'agente indovini**
Se hai un'informazione importante, dilla esplicitamente. "Scrivi a memoria che il mio commercialista è Rossi e risponde entro 2 giorni." L'agente non è un indovino.
**2. Usa il diario quotidiano**
Il file `memory/YYYY-MM-DD.md` è perfetto per note temporanee. "Oggi ho cambiato password email" o "Domani è il compleanno di Marco". Cose che servono oggi ma che tra un mese non serviranno più.
**3. Rivedi MEMORY.md ogni tanto**
Apri il file, leggi, cancella quello che non serve più. La memoria va curata, come un giardino. Se cresci troppe erbacce, il tuo agente si confonde.
**4. L'Heartbeat non è un babysitter**
L'Heartbeat controlla, non agisce. Se vuoi che il tuo agente faccia qualcosa di specifico in automatico, usa un Cron Job. L'Heartbeat è per monitorare, non per compiere azioni complesse.
---
## Domande frequenti
**"L'agente può leggere i miei file personali?"**
Solo quelli nella cartella workspace di OpenClaw. Non può andare a leggere il tuo desktop o i tuoi documenti personali, a meno che tu non glielo permetta esplicitamente.
**"Se cancello MEMORY.md, perdo tutto?"**
Sì, per questo è importante fare un backup. Ma cancellando MEMORY.md il tuo agente torna a essere "nuovo", non si rompe nulla. Semplicemente non sa più nulla di te.
**"L'Heartbeat consuma molto?"**
No. È un controllo leggero. Se non c'è nulla da fare, l'agente si riaddormenta in fretta. Non è come tenere acceso un programma pesante.
**"Posso disattivare l'Heartbeat?"**
Sì. Se non ti interessa che il tuo agente ti contatti in automatico, puoi non configurare HEARTBEAT.md. L'agente risponde solo quando gli parli.
---
## In sintesi
- **MEMORY.md** = la memoria a lungo termine, dove salvi chi sei e cosa è importante
- **memory/YYYY-MM-DD.md** = il diario di bordo di ogni giorno
- **Heartbeat** = il controllo periodico che fa l'agente per vedere se c'è qualcosa di interessante
- **Tu controlli tutto** = puoi leggere, modificare, cancellare i file di memoria quando vuoi
Non servono competenze tecniche. Servono un po' di pazienza e la consapevolezza che il tuo agente AI è come un assistente molto intelligente ma senza memoria naturale: tocca a te dargli un sistema per ricordare.
E OpenClaw te lo dà, semplice e trasparente.
---
⚠️ 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 già sai usare Docker: crea un container e lavora lì.
Se non sai cos'è Docker: usa Multipass, è più semplice.
La regola è una: OpenClaw su un computer isolato. Mai in chiaro sul PC di tutti i giorni. La sicurezza informatica non è paranoia, è buon senso.
**Ti è mai capitato di chiedere qualcosa al tuo assistente AI e lui ti risponde come se non si fosse mai sentito?** Come se ogni conversazione partisse da zero, ogni volta, senza sapere chi sei o cosa hai detto prima?
Noi umani abbiamo la memoria. La svegliamo la mattina e sappiamo chi siamo, cosa dobbiamo fare, chi abbiamo parlato ieri. Un assistente AI, invece, nasce "pulito" ogni volta. È come un collega nuovo ogni giorno, finché non gli dai un sistema per ricordare.
**Ecco dove entrano in gioco due funzioni di OpenClaw che cambiano tutto: il sistema di memoria (MEMORY.md) e l'Heartbeat.**
Ti spiego come funzion passo dopo passo, senza dare nulla per scontato.
---
## Perché il tuo agente AI dimentica tutto (e non è colpa sua)
Ogni volta che parli con OpenClaw, quella conversazione vive in una "sessione". Immagina una sessione come un appuntamento: dura un certo poi finisce. Quando il prossimo appuntamento inizia, il tuo agente non ha il diario del precedente. Parte da zero.
**Non è un bug. È il funzionamento normale dell'AI.**
Il problema è che senza memoria, il tuo agente non sa:
- Come ti chiami
- Quali sono le tue preferenze
- Cosa hai chiesto ieri
- Qual hai detto di fare la settimana scorsa
È come spiegare ogni giorno al tuo postino chi sei. Stancante, no?
OpenClaw risolve questo con due strumenti: i **file di memoria** e l'**Heartbeat**. Due cose semplici che, messe insieme, creano un assistente che impara e cresce con te.
---
## Il sistema di memoria: il diario del tuo agente
OpenClaw usa dei file di testo (sì, dei semplici file, come quelli che apri con il Blocco Note) per salvare informazioni tra una sessione e l'altra.
I due file principali sono:
### 1. MEMORY.md — La memoria a lungo termine
Pensa a questo file come il quaderno principale del tuo agente. Qui salvi le cose importanti, quelle che non devono mai perdersi:
- Il tuo nome e come vuoi essere chiamato
- Le tue preferenze (lingua, tono, cose che non sopporti)
- Decisioni importanti che avete preso insieme
- Lezioni apprese ("la volta che ho sbagliato perché...")
**Un esempio concreto:**
Se dici al tuo agente "mi chiamo Davide, odiano le risposte lunghe, parla in modo informale", queste informazioni finiscono in MEMORY.md. La prossima volta che apri una conversazione, il tuo agente legge quel file e sa già come comportarsi.
### 2. memory/YYYY-MM-DD.md — Il diario quotidiano
Ogni giorno, OpenClaw crea un nuovo file nella cartella "memory" (memoria in inglese). È come un diario di bordo: cosa è successo oggi, cosa avete fatto, cosa è da fare domani.
**Un esempio concreto:**
```
memory/2026-06-24.md
- Davide ha chiesto di configurare le email
- Abbiamo deciso di usare AgentMail invece di Gmail diretto
- Da fare: verificare che l'invio funzioni con Telegram
```
Quando il tuo agente si sveglia e legge il diario di oggi e la memoria a lungo termine, ha tutto il contesto. Non devi ripetere nulla.
---
## Come funziona la memoria nella pratica
Ecco il flusso semplice:
1. **Tu parli con l'agente** → gli chiedi qualcosa o gli dai un'informazione
2. **L'agente scrive** → salva l'informazione importante nei file di memoria
3. **La prossima volta** → l'agente legge quei file prima di rispondere
4. **Risponde con contesto** → sa chi sei, sa cosa hai detto, non parti da zero
**Niente magia, niente database complicati.** Solo file di testo che si leggono e si scrivono. Semplice, trasparente, controllabile.
Puoi aprire quei file quando vuoi. Leggerli, modificarli, cancellare quello che non ti piace. Tu hai il controllo.
---
## L'Heartbeat: il tuo agente che si "sveglia" da solo
Ora hai un agente che ricorda chi sei. Ma come fa a fare cose senza che tu gli parli ogni volta?
**Immagina un impiegato che ogni mezz'ora controlla la sua scrivania:** "C'è posta nuova? Qualcuno mi ha scritto? C'è qualcosa da fare?" Se non c'è nulla, torna a sedersi. Se c'è qualcosa, si attiva.
Questo è l'Heartbeat di OpenClaw.
L'Heartbeat è un "battito cardiaco" che l'agente riceve a intervalli regolari (ogni 30 minuti, più o meno). Quando lo riceve, si sveglia e controlla:
- **Email** → arrivato qualcosa di urgente?
- **Calendario** → appuntamento tra poco?
- **Notifiche** → qualcosa di interessante?
- **Compiti programmati** → qualcosa da fare ora?
Se trova qualcosa di importante, ti contatta. Se non c'è nulla, torna a dormire. Senza disturbarti.
**Perché è utile?**
Perché il tuo agente può essere proattivo. Non devi tu controllare ogni cosa: lui ti avvisa quando serve. Come un buon assistente che ti dice "hey, tra 20 minuti hai quella riunione" senza che tu gli chieda.
---
## Heartbeat vs Cron: qual è la differenza?
Hai sentito parlare dei Cron Job (articolo scorso) e ti stai chiedendo: "Heartbeat e Cron sono la stessa cosa?"
**No, ma sono parenti.**
| | Heartbeat | Cron Job |
|---|---|---|
| **Frequenza** | Ogni ~30 minuti | Quando vuoi tu (ogni lunedì, ogni ora, una volta sola) |
| **Controlla** | Email, calendario, notifiche | Qualsiasi cosa tu gli abbia chiesto di fare |
| **Si sveglia da solo** | Sì, sempre | Solo quando programmato |
| **Ti avvisa** | Solo se trova qualcosa | Sempre (o solo se dici) |
**La regola semplice:**
- **Heartbeat** = controllo generale, periodico, "c'è qualcosa di interessante?"
- **Cron Job** = compito specifico, programmato, "fai questa cosa a quest'ora"
---
## Come attivare e configurare l'Heartbeat
L'Heartbeat in OpenClaw si gestisce con un file chiamato `HEARTBEAT.md`. Sì, hai capito bene: un file che dice al tuo agente cosa controllare quando si sveglia.
**Ecco un esempio semplice:**
```markdown
# HEARTBEAT.md
## Cose da controllare (2-3 volte al giorno)
- Email: arrivato qualcosa di urgente?
- Calendario: appuntamenti nelle prossime 24-48 ore?
- Meteo: pioggia prevista oggi?
## Quando stare zitto
- Tra le 23:00 e le 08:00, non disturbare
- Se non c'è nulla di nuovo dall'ultimo controllo
- Se ho già scritto a Davide negli ultimi 30 minuti
```
Vedi? Scri in linguaggio normale. Non è codice, non è un programma. È una lista di cose da fare, scritta come la scriveresti su un post-it.
**Dove si mette questo file?** Nella cartella principale del tuo workspace OpenClaw, insieme a MEMORY.md. Lo trovi facilmente.
---
## Un esempio concreto di giornata con Heartbeat
Immagina una giornata tipo:
**07:00** — L'Heartbeat si attiva. Controlla il calendario: "Alle 10:00 Davide ha una riunione importante". Ti manda un messaggio: "Buongiorno! Alle 10 hai la riunione con il cliente X. Vuoi che ti prepari un riassunto?"
**12:30** — L'Heartbeat si attiva. Controlla le email: niente di urgente. Non ti scrive.
**15:00** — L'Heartbeat si attiva. Trova un'email importante che era arrivata a mezzogiorno. Ti avvisa: "Hai un'email urgente dal tuo commercialista. Vuoi che la legga?"
**23:30** — L'Heartbeat si attivo. Controlla l'orario: è tardi. Non ti scrive. Buonanotte.
**Non hai dovuto chiedere nulla.** Il tuo agente ti ha avvisato solo quando serviva.
---
## La memoria che cresce: come il tuo agente migliora nel tempo
Questa è la parte che mi piace di più.
Man mano che usi OpenClaw, il file MEMORY.md si arricchisce. Il tuo agente impara:
- **Settimana 1:** Sa il tuo nome e la tua lingua
- **Settimana 2:** Sa che preferisci risposte brevi e tono informale
- **Settimana 3:** Sa che ogni lunedì devi fare un report, e te lo chiede
- **Settimana 4:** Sa che non sopporti certi tipi di risposte, e li evita
**Non è magia. È memoria.**
E il bello è che tutto è trasparente. Puoi aprire MEMORY.md e vedere esattamente cosa il tuo agente "sa" di te. Puoi correggere, aggiungere, cancellare. Se il tuo agente sta imparando qualcosa di sbagliato, basta una modifica al file e il problema è risolto.
---
## Trucchi pratici per la memoria
Qualche consiglio per usare al meglio la memoria di OpenClaw:
**1. Non aspettare che l'agente indovini**
Se hai un'informazione importante, dilla esplicitamente. "Scrivi a memoria che il mio commercialista è Rossi e risponde entro 2 giorni." L'agente non è un indovino.
**2. Usa il diario quotidiano**
Il file `memory/YYYY-MM-DD.md` è perfetto per note temporanee. "Oggi ho cambiato password email" o "Domani è il compleanno di Marco". Cose che servono oggi ma che tra un mese non serviranno più.
**3. Rivedi MEMORY.md ogni tanto**
Apri il file, leggi, cancella quello che non serve più. La memoria va curata, come un giardino. Se cresci troppe erbacce, il tuo agente si confonde.
**4. L'Heartbeat non è un babysitter**
L'Heartbeat controlla, non agisce. Se vuoi che il tuo agente faccia qualcosa di specifico in automatico, usa un Cron Job. L'Heartbeat è per monitorare, non per compiere azioni complesse.
---
## Domande frequenti
**"L'agente può leggere i miei file personali?"**
Solo quelli nella cartella workspace di OpenClaw. Non può andare a leggere il tuo desktop o i tuoi documenti personali, a meno che tu non glielo permetta esplicitamente.
**"Se cancello MEMORY.md, perdo tutto?"**
Sì, per questo è importante fare un backup. Ma cancellando MEMORY.md il tuo agente torna a essere "nuovo", non si rompe nulla. Semplicemente non sa più nulla di te.
**"L'Heartbeat consuma molto?"**
No. È un controllo leggero. Se non c'è nulla da fare, l'agente si riaddormenta in fretta. Non è come tenere acceso un programma pesante.
**"Posso disattivare l'Heartbeat?"**
Sì. Se non ti interessa che il tuo agente ti contatti in automatico, puoi non configurare HEARTBEAT.md. L'agente risponde solo quando gli parli.
---
## In sintesi
- **MEMORY.md** = la memoria a lungo termine, dove salvi chi sei e cosa è importante
- **memory/YYYY-MM-DD.md** = il diario di bordo di ogni giorno
- **Heartbeat** = il controllo periodico che fa l'agente per vedere se c'è qualcosa di interessante
- **Tu controlli tutto** = puoi leggere, modificare, cancellare i file di memoria quando vuoi
Non servono competenze tecniche. Servono un po' di pazienza e la consapevolezza che il tuo agente AI è come un assistente molto intelligente ma senza memoria naturale: tocca a te dargli un sistema per ricordare.
E OpenClaw te lo dà, semplice e trasparente.
---
⚠️ 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 già sai usare Docker: crea un container e lavora lì.
Se non sai cos'è Docker: usa Multipass, è più semplice.
La regola è una: OpenClaw su un computer isolato. Mai in chiaro sul PC di tutti i giorni. La sicurezza informatica non è paranoia, è buon senso.
Sent via AgentMail
Commenti
Posta un commento