Vai al contenuto principale

​
Panoramica della memoria

OpenClaw ricorda le cose scrivendo semplici file Markdown nel workspace del tuo agente. Il modello “ricorda” solo ciò che viene salvato su disco — non c’è alcuno stato nascosto.

​
Come funziona

Il tuo agente ha due posti in cui archiviare i ricordi:
  • MEMORY.md — memoria a lungo termine. Fatti durevoli, preferenze e decisioni. Viene caricato all’inizio di ogni sessione DM.
  • memory/YYYY-MM-DD.md — note giornaliere. Contesto in evoluzione e osservazioni. Le note di oggi e di ieri vengono caricate automaticamente.
Questi file si trovano nel workspace dell’agente (predefinito ~/.openclaw/workspace).
Se vuoi che il tuo agente ricordi qualcosa, basta chiederglielo: “Ricorda che preferisco TypeScript.” Lo scriverà nel file appropriato.

​
Strumenti di memoria

L’agente dispone di due strumenti per lavorare con la memoria:
  • memory_search — trova note pertinenti usando la ricerca semantica, anche quando la formulazione differisce dall’originale.
  • memory_get — legge un file di memoria specifico o un intervallo di righe.
Entrambi gli strumenti sono forniti dal plugin di memoria attivo (predefinito: memory-core).

​
Ricerca nella memoria

Quando è configurato un provider di embedding, memory_search usa la ricerca ibrida — combinando similarità vettoriale (significato semantico) con corrispondenza per parole chiave (termini esatti come ID e simboli di codice). Funziona subito, una volta che hai una chiave API per qualsiasi provider supportato.
OpenClaw rileva automaticamente il provider di embedding dalle chiavi API disponibili. Se hai configurato una chiave OpenAI, Gemini, Voyage o Mistral, la ricerca nella memoria è abilitata automaticamente.
Per i dettagli su come funziona la ricerca, le opzioni di regolazione e la configurazione del provider, vedi Ricerca nella memoria.

​
Backend di memoria

Integrato (predefinito)

Basato su SQLite. Funziona subito con ricerca per parole chiave, similarità vettoriale e ricerca ibrida. Nessuna dipendenza aggiuntiva.

QMD

Sidecar local-first con reranking, espansione delle query e la possibilità di indicizzare directory esterne al workspace.

Honcho

Memoria cross-session nativa per l’AI con modellazione dell’utente, ricerca semantica e consapevolezza multi-agente. Installazione tramite plugin.

​
Flush automatico della memoria

Prima che la compattazione riassuma la tua conversazione, OpenClaw esegue un turno silenzioso che ricorda all’agente di salvare il contesto importante nei file di memoria. Questa funzione è attiva per impostazione predefinita — non devi configurare nulla.
Il flush della memoria previene la perdita di contesto durante la compattazione. Se il tuo agente ha fatti importanti nella conversazione che non sono ancora stati scritti in un file, verranno salvati automaticamente prima che avvenga il riepilogo.

​
Dreaming (sperimentale)

Dreaming è un passaggio opzionale di consolidamento della memoria in background. Rivisita i richiami a breve termine dai file giornalieri (memory/YYYY-MM-DD.md), li valuta e promuove nella memoria a lungo termine (MEMORY.md) solo gli elementi qualificati. È progettato per mantenere alta la qualità della memoria a lungo termine:
  • Adesione esplicita: disabilitato per impostazione predefinita.
  • Pianificato: quando abilitato, memory-core gestisce automaticamente l’attività ricorrente.
  • Con soglia: le promozioni devono superare soglie di punteggio, frequenza di richiamo e diversità delle query.
Per il comportamento delle modalità (off, core, rem, deep), i segnali di valutazione e i parametri di regolazione, vedi Dreaming (sperimentale).

​
CLI

openclaw memory status          # Controlla lo stato dell'indice e del provider
openclaw memory search "query"  # Cerca dalla riga di comando
openclaw memory index --force   # Ricostruisce l'indice

​
Ulteriori letture