English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

CLI commands

Memoria

openclaw memory

Gestisci l'indicizzazione e la ricerca della memoria semantica. Fornito dal Plugin incluso memory-core. Il comando è disponibile quando plugins.slots.memory seleziona memory-core (impostazione predefinita); altri Plugin di memoria espongono i propri namespace CLI.

Correlati:

Esempi

bash
openclaw memory statusopenclaw memory status --deepopenclaw memory status --fixopenclaw memory index --forceopenclaw memory search "meeting notes"openclaw memory search --query "deployment" --max-results 20openclaw memory promote --limit 10 --min-score 0.75openclaw memory promote --applyopenclaw memory promote --json --min-recall-count 0 --min-unique-queries 0openclaw memory promote-explain "router vlan"openclaw memory promote-explain "router vlan" --jsonopenclaw memory rem-harnessopenclaw memory rem-harness --jsonopenclaw memory status --jsonopenclaw memory status --deep --indexopenclaw memory status --deep --index --verboseopenclaw memory status --agent mainopenclaw memory index --agent main --verbose

Opzioni

memory status e memory index:

  • --agent <id>: limita l'ambito a un singolo agente. Senza questa opzione, questi comandi vengono eseguiti per ogni agente configurato; se non è configurato alcun elenco di agenti, ripiegano sull'agente predefinito.
  • --verbose: emette log dettagliati durante i controlli e l'indicizzazione.

memory status:

  • --deep: verifica la prontezza del vector store locale, la prontezza del provider di embedding e la prontezza della ricerca vettoriale semantica. Il semplice memory status resta veloce e non esegue lavori live di embedding o di individuazione dei provider; uno stato sconosciuto del vector store o del vettore semantico significa che non è stato verificato in quel comando. La ricerca lessicale QMD searchMode: "search" salta i controlli vettoriali semantici e la manutenzione degli embedding anche con --deep.
  • --index: esegue una reindicizzazione se lo store è dirty (implica --deep).
  • --fix: ripara lock di richiamo obsoleti e normalizza i metadati di promozione.
  • --json: stampa output JSON.

Se memory status mostra Dreaming status: blocked, il Cron di dreaming gestito è abilitato ma l'Heartbeat che lo guida non viene eseguito per l'agente predefinito. Vedi Dreaming non viene mai eseguito per le due cause comuni.

memory index:

  • --force: forza una reindicizzazione completa.

memory search:

  • Input della query: passa [query] posizionale oppure --query <text>.
  • Se sono forniti entrambi, --query ha la precedenza.
  • Se nessuno dei due è fornito, il comando termina con un errore.
  • --agent <id>: limita l'ambito a un singolo agente (predefinito: l'agente predefinito).
  • --max-results <n>: limita il numero di risultati restituiti.
  • --min-score <n>: filtra le corrispondenze con punteggio basso.
  • --json: stampa risultati JSON.

memory promote:

Visualizza in anteprima e applica promozioni della memoria a breve termine.

bash
openclaw memory promote [--apply] [--limit <n>] [--include-promoted]
  • --apply -- scrive le promozioni in MEMORY.md (predefinito: solo anteprima).
  • --limit <n> -- limita il numero di candidati mostrati.
  • --include-promoted -- include voci già promosse nei cicli precedenti.

Opzioni complete:

  • Classifica i candidati a breve termine da memory/YYYY-MM-DD.md usando segnali di promozione ponderati (frequency, relevance, query diversity, recency, consolidation, conceptual richness).
  • Usa segnali a breve termine sia dai richiami di memoria sia dai passaggi di ingestione giornaliera, oltre ai segnali di rinforzo delle fasi light/REM.
  • Quando Dreaming è abilitato, memory-core gestisce automaticamente un job Cron che esegue una scansione completa (light -> REM -> deep) in background (non è richiesto alcun openclaw cron add manuale).
  • --agent <id>: limita l'ambito a un singolo agente (predefinito: l'agente predefinito).
  • --limit <n>: numero massimo di candidati da restituire/applicare.
  • --min-score <n>: punteggio minimo ponderato di promozione.
  • --min-recall-count <n>: conteggio minimo di richiami richiesto per un candidato.
  • --min-unique-queries <n>: conteggio minimo di query distinte richiesto per un candidato.
  • --apply: aggiunge i candidati selezionati a MEMORY.md e li contrassegna come promossi.
  • --include-promoted: include nell'output i candidati già promossi.
  • --json: stampa output JSON.

memory promote-explain:

Spiega uno specifico candidato alla promozione e la scomposizione del suo punteggio.

bash
openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]
  • <selector>: chiave del candidato, frammento di percorso o frammento di snippet da cercare.
  • --agent <id>: limita l'ambito a un singolo agente (predefinito: l'agente predefinito).
  • --include-promoted: include candidati già promossi.
  • --json: stampa output JSON.

memory rem-harness:

Visualizza in anteprima riflessioni REM, verità candidate e output di promozione profonda senza scrivere nulla.

bash
openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]
  • --agent <id>: limita l'ambito a un singolo agente (predefinito: l'agente predefinito).
  • --include-promoted: include candidati profondi già promossi.
  • --json: stampa output JSON.

Dreaming

Dreaming è il sistema di consolidamento della memoria in background con tre fasi cooperative: light (ordina/prepara il materiale a breve termine), deep (promuove fatti durevoli in MEMORY.md) e REM (riflette e fa emergere temi).

  • Abilita con plugins.entries.memory-core.config.dreaming.enabled: true.
  • Attiva/disattiva dalla chat con /dreaming on|off (oppure ispeziona con /dreaming status). I chiamanti del canale devono essere proprietari per modificare l'impostazione; i client Gateway richiedono operator.admin. Lo stato e l'aiuto in sola lettura restano disponibili ai mittenti di comandi autorizzati.
  • Dreaming viene eseguito su una pianificazione di scansione gestita (dreaming.frequency) ed esegue le fasi in ordine: light, REM, deep.
  • Solo la fase deep scrive memoria durevole in MEMORY.md.
  • L'output delle fasi leggibile da persone e le voci di diario vengono scritti in DREAMS.md (o in un dreams.md esistente), con report opzionali per fase in memory/dreaming/<phase>/YYYY-MM-DD.md.
  • La classificazione usa segnali ponderati: frequenza di richiamo, rilevanza del recupero, diversità delle query, recenza temporale, consolidamento tra giorni e ricchezza concettuale derivata.
  • La promozione rilegge la nota giornaliera live prima di scrivere in MEMORY.md, quindi snippet a breve termine modificati o eliminati non vengono promossi da snapshot obsoleti dello store di richiamo.
  • Le esecuzioni pianificate e manuali di memory promote condividono gli stessi valori predefiniti della fase deep, a meno che non passi override CLI delle soglie.
  • Le esecuzioni automatiche si distribuiscono su tutti i workspace di memoria configurati.

Pianificazione predefinita:

  • Cadenza di scansione: dreaming.frequency = 0 3 * * *
  • Soglie deep: minScore=0.8, minRecallCount=3, minUniqueQueries=3, recencyHalfLifeDays=14, maxAgeDays=30

Esempio:

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

Note:

  • memory index --verbose stampa dettagli per fase (provider, modello, sorgenti, attività batch).
  • memory status include eventuali percorsi extra configurati tramite memorySearch.extraPaths.
  • Se i campi della chiave API remota della memoria effettivamente attiva sono configurati come SecretRefs, il comando risolve quei valori dallo snapshot Gateway attivo. Se Gateway non è disponibile, il comando fallisce rapidamente.
  • Nota sul disallineamento di versione del Gateway: questo percorso di comando richiede un gateway che supporti secrets.resolve; gateway più vecchi restituiscono un errore di metodo sconosciuto.
  • Regola la cadenza della scansione pianificata con dreaming.frequency. La policy di promozione deep è altrimenti interna, tranne per dreaming.phases.deep.maxPromotedSnippetTokens, che limita la lunghezza degli snippet promossi mantenendo visibile la provenienza. Usa i flag CLI su memory promote quando ti servono override manuali una tantum delle soglie.
  • memory rem-harness --path <file-or-dir> --grounded visualizza in anteprima What Happened, Reflections e Possible Lasting Updates fondati su note giornaliere storiche senza scrivere nulla.
  • memory rem-backfill --path <file-or-dir> scrive voci di diario fondate e reversibili in DREAMS.md per la revisione nell'interfaccia utente.
  • memory rem-backfill --path <file-or-dir> --stage-short-term inserisce anche candidati durevoli fondati nello store live di promozione a breve termine, così la normale fase deep può classificarli.
  • memory rem-backfill --rollback rimuove le voci di diario fondate scritte in precedenza, e memory rem-backfill --rollback-short-term rimuove i candidati a breve termine fondati preparati in precedenza.
  • Vedi Dreaming per descrizioni complete delle fasi e riferimento di configurazione.

Correlati

Was this useful?
On this page

On this page