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 esistente dreams.md) e file opzionali di report di fase sotto memory/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 Sleep quando 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, minRecallCount e minUniqueQueries.
  • 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 Sleep in DREAMS.md e, opzionalmente, scrive memory/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 Sleep quando 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 ... --grounded mostra in anteprima l’output di diario fondato su evidenze da note storiche YYYY-MM-DD.md.
  • memory rem-backfill --path ... scrive voci di diario reversibili fondate su evidenze in DREAMS.md.
  • memory rem-backfill --path ... --stage-short-term predispone candidati durevoli fondati su evidenze nello stesso archivio di evidenze a breve termine già usato dalla normale fase Deep.
  • memory rem-backfill --rollback e --rollback-short-term rimuovono 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.

enabledboolean

Abilita o disabilita la sweep di Dreaming.

frequencystring

Cadenza Cron per la sweep completa di Dreaming.

modelstring

Override 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.

Correlati