Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.
Dreaming è opt-in ed è disabilitato per impostazione predefinita.

​
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:
FaseScopoScrittura durevole
LightOrdinare e predisporre materiale recente a breve termineNo
DeepValutare e promuovere candidati durevoliSì (MEMORY.md)
REMRiflettere su temi e idee ricorrentiNo
Queste fasi sono dettagli interni di implementazione, non “modalità” separate configurate dall’utente.
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.
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.
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.
Questo diario è destinato alla lettura umana nell’interfaccia Dreams, non è una fonte di promozione. Gli artefatti di diario/report generati da Dreaming sono esclusi dalla promozione a breve termine. Solo gli snippet di memoria fondati su evidenze sono idonei alla promozione in MEMORY.md.
Esiste anche una corsia di backfill storico fondata su evidenze per attività di revisione e recupero:
  • 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:
SegnalePesoDescrizione
Frequenza0.24Quanti segnali a breve termine ha accumulato la voce
Rilevanza0.30Qualità media del recupero per la voce
Diversità delle query0.15Contesti distinti di query/giorno che l’hanno fatta emergere
Recenza0.15Punteggio di freschezza con decadimento temporale
Consolidamento0.10Forza della ricorrenza su più giorni
Ricchezza concettuale0.06Densità 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:
ImpostazionePredefinito
dreaming.frequency0 3 * * *
dreaming.modelmodello predefinito

​
Avvio rapido

{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true
          }
        }
      }
    }
  }
}

​
Comando slash

/dreaming status
/dreaming on
/dreaming off
/dreaming help

​
Flusso di lavoro CLI

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.

​
Valori predefiniti principali

Tutte le impostazioni si trovano sotto plugins.entries.memory-core.config.dreaming.
​
enabled
boolean
predefinito:"false"
Abilita o disabilita la sweep di Dreaming.
​
frequency
string
predefinito:"0 3 * * *"
Cadenza Cron per la sweep completa di Dreaming.
​
model
string
Override opzionale del modello subagent del Diario dei sogni. Usa un valore canonico provider/model quando imposti anche una allowlist subagent allowedModels.
dreaming.model richiede plugins.entries.memory-core.subagent.allowModelOverride: true. Per limitarlo, imposta anche plugins.entries.memory-core.subagent.allowedModels. Gli errori di trust o allowlist restano visibili invece di ripiegare silenziosamente; il retry copre solo gli errori di modello non disponibile.
La policy di fase, le soglie e il comportamento di archiviazione sono dettagli interni di implementazione (non configurazione rivolta all’utente). Consulta il riferimento alla configurazione della memoria per l’elenco completo delle chiavi.

​
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