Sessions and memory
Dreaming
Dreaming è il sistema di consolidamento della memoria in background in memory-core. Aiuta OpenClaw a spostare segnali forti a breve termine nella memoria durevole mantenendo il processo spiegabile e revisionabile.
Cosa scrive Dreaming
Dreaming mantiene due tipi di output:
- Stato macchina in
memory/.dreams/(archivio di recall, segnali di fase, checkpoint di ingestione, lock). - Output leggibile dall’uomo in
DREAMS.md(o nel file esistentedreams.md) e file opzionali di report di fase sottomemory/dreaming/<phase>/YYYY-MM-DD.md.
La promozione a lungo termine scrive ancora solo in MEMORY.md.
Modello a fasi
Dreaming usa tre fasi cooperative:
| Fase | Scopo | Scrittura durevole |
|---|---|---|
| Light | Ordinare e predisporre materiale recente a breve termine | No |
| Deep | Valutare e promuovere candidati durevoli | Sì (MEMORY.md) |
| REM | Riflettere su temi e idee ricorrenti | No |
Queste fasi sono dettagli interni di implementazione, non "modalità" separate configurate dall’utente.
Light phase
La fase Light ingerisce segnali recenti di memoria giornaliera e tracce di recall, li deduplica e predispone righe candidate.
- Legge dallo stato di recall a breve termine, dai file recenti di memoria giornaliera e dalle trascrizioni di sessione redatte quando disponibili.
- Scrive un blocco gestito
## Light Sleepquando l’archiviazione include output inline. - Registra segnali di rinforzo per il successivo ranking Deep.
- Non scrive mai in
MEMORY.md.
Deep phase
La fase Deep decide cosa diventa memoria a lungo termine.
- Classifica i candidati usando punteggi ponderati e soglie di accesso.
- Richiede il superamento di
minScore,minRecallCounteminUniqueQueries. - Reidrata gli snippet dai file giornalieri live prima di scrivere, quindi gli snippet obsoleti/eliminati vengono saltati.
- Aggiunge le voci promosse a
MEMORY.md. - Scrive un riepilogo
## Deep SleepinDREAMS.mde, opzionalmente, scrivememory/dreaming/deep/YYYY-MM-DD.md.
REM phase
La fase REM estrae pattern e segnali riflessivi.
- Crea riepiloghi di temi e riflessioni dalle tracce recenti a breve termine.
- Scrive un blocco gestito
## REM Sleepquando l’archiviazione include output inline. - Registra segnali di rinforzo REM usati dal ranking Deep.
- Non scrive mai in
MEMORY.md.
Ingestione delle trascrizioni di sessione
Dreaming può ingerire trascrizioni di sessione redatte nel corpus di Dreaming. Quando le trascrizioni sono disponibili, vengono passate alla fase Light insieme ai segnali di memoria giornaliera e alle tracce di recall. I contenuti personali e sensibili vengono redatti prima dell’ingestione.
Diario dei sogni
Dreaming mantiene anche un Diario dei sogni narrativo in DREAMS.md. Dopo che ogni fase ha abbastanza materiale, memory-core esegue in background un turno subagent best-effort e aggiunge una breve voce di diario. Usa il modello runtime predefinito a meno che dreaming.model non sia configurato. Se il modello configurato non è disponibile, il Diario dei sogni riprova una volta con il modello predefinito della sessione.
Esiste anche una corsia di backfill storico fondata su evidenze per attività di revisione e recupero:
Backfill commands
memory rem-harness --path ... --groundedmostra in anteprima l’output di diario fondato su evidenze da note storicheYYYY-MM-DD.md.memory rem-backfill --path ...scrive voci di diario reversibili fondate su evidenze inDREAMS.md.memory rem-backfill --path ... --stage-short-termpredispone candidati durevoli fondati su evidenze nello stesso archivio di evidenze a breve termine già usato dalla normale fase Deep.memory rem-backfill --rollbacke--rollback-short-termrimuovono quegli artefatti di backfill predisposti senza toccare le normali voci di diario o il recall live a breve termine.
La Control UI espone lo stesso flusso di backfill/reset del diario, così puoi ispezionare i risultati nella scena Dreams prima di decidere se i candidati fondati su evidenze meritano la promozione. La Scene mostra anche una corsia distinta per contenuti fondati su evidenze, così puoi vedere quali voci a breve termine predisposte provengono dalla riesecuzione storica, quali elementi promossi sono stati guidati da evidenze, e cancellare solo le voci predisposte esclusivamente fondate su evidenze senza toccare il normale stato live a breve termine.
Segnali del ranking Deep
Il ranking Deep usa sei segnali di base ponderati più il rinforzo di fase:
| Segnale | Peso | Descrizione |
|---|---|---|
| Frequenza | 0.24 | Quanti segnali a breve termine ha accumulato la voce |
| Rilevanza | 0.30 | Qualità media del recupero per la voce |
| Diversità delle query | 0.15 | Contesti distinti di query/giorno che l’hanno fatta emergere |
| Recenza | 0.15 | Punteggio di freschezza con decadimento temporale |
| Consolidamento | 0.10 | Forza della ricorrenza su più giorni |
| Ricchezza concettuale | 0.06 | Densità dei tag concettuali da snippet/percorso |
Le occorrenze delle fasi Light e REM aggiungono un piccolo boost con decadimento di recenza da memory/.dreams/phase-signals.json.
Pianificazione
Quando abilitato, memory-core gestisce automaticamente un job cron per una sweep completa di Dreaming. Ogni sweep esegue le fasi in ordine: Light → REM → Deep.
La sweep include il workspace runtime primario e tutti i workspace agente configurati, deduplicati per percorso, così il fan-out dei workspace subagent non esclude il DREAMS.md e lo stato di memoria dell’agente principale.
Comportamento della cadenza predefinita:
| Impostazione | Predefinito |
|---|---|
dreaming.frequency |
0 3 * * * |
dreaming.model |
modello predefinito |
Avvio rapido
Enable dreaming
{
"plugins": {
"entries": {
"memory-core": {
"config": {
"dreaming": {
"enabled": true
}
}
}
}
}
}
Custom sweep cadence
{
"plugins": {
"entries": {
"memory-core": {
"config": {
"dreaming": {
"enabled": true,
"timezone": "America/Los_Angeles",
"frequency": "0 */6 * * *"
}
}
}
}
}
}
Comando slash
/dreaming status
/dreaming on
/dreaming off
/dreaming help
Flusso di lavoro CLI
Promotion preview / apply
openclaw memory promote
openclaw memory promote --apply
openclaw memory promote --limit 5
openclaw memory status --deep
memory promote manuale usa per impostazione predefinita le soglie della fase Deep, a meno che non vengano sovrascritte con flag CLI.
Explain promotion
Spiega perché uno specifico candidato verrebbe o non verrebbe promosso:
openclaw memory promote-explain "router vlan"
openclaw memory promote-explain "router vlan" --json
REM harness preview
Visualizza in anteprima riflessioni REM, verità candidate e output di promozione Deep senza scrivere nulla:
openclaw memory rem-harness
openclaw memory rem-harness --json
Valori predefiniti principali
Tutte le impostazioni si trovano sotto plugins.entries.memory-core.config.dreaming.
enabledbooleanAbilita o disabilita la sweep di Dreaming.
frequencystringCadenza Cron per la sweep completa di Dreaming.
modelstringOverride opzionale del modello subagent del Diario dei sogni. Usa un valore canonico provider/model quando imposti anche una allowlist subagent allowedModels.
Interfaccia Dreams
Quando abilitata, la scheda Dreams del Gateway mostra:
- stato attuale di abilitazione di Dreaming
- stato a livello di fase e presenza della sweep gestita
- conteggi a breve termine, fondati su evidenze, di segnali e promossi oggi
- tempi della prossima esecuzione pianificata
- una corsia Scene distinta per le voci di riesecuzione storica predisposte
- un lettore espandibile del Diario dei sogni supportato da
doctor.memory.dreamDiary
Dreaming non viene mai eseguito: lo stato mostra bloccato
Se openclaw memory status riporta Dreaming status: blocked, il Cron gestito esiste ma l’Heartbeat dell’agente predefinito non sta scattando. Verifica che Heartbeat sia abilitato per l’agente predefinito e che la sua destinazione non sia none, quindi esegui di nuovo openclaw memory status --deep dopo il successivo intervallo di Heartbeat.