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

Geheugen

openclaw memory

Beheer semantische geheugenindexering en zoeken. Geleverd door de gebundelde memory-core plugin. De opdracht is beschikbaar wanneer plugins.slots.memory memory-core selecteert (de standaard); andere geheugenplugins bieden hun eigen CLI-naamruimten.

Gerelateerd:

Voorbeelden

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

Opties

memory status en memory index:

  • --agent <id>: beperk tot één agent. Zonder deze optie worden deze opdrachten uitgevoerd voor elke geconfigureerde agent; als er geen agentlijst is geconfigureerd, vallen ze terug op de standaardagent.
  • --verbose: geef gedetailleerde logs tijdens controles en indexering.

memory status:

  • --deep: controleer of de lokale vectoropslag gereed is, of de embedding-provider gereed is en of semantisch vectorzoeken gereed is. Gewone memory status blijft snel en voert geen live embedding- of providerontdekkingswerk uit; een onbekende vectoropslag- of semantische-vectorstatus betekent dat die in die opdracht niet is gecontroleerd. QMD lexicale searchMode: "search" slaat semantische vectorcontroles en embedding-onderhoud over, zelfs met --deep.
  • --index: voer een herindexering uit als de opslag vuil is (impliceert --deep).
  • --fix: herstel verouderde recall-vergrendelingen en normaliseer promotiemetadata.
  • --json: druk JSON-uitvoer af.

Als memory status Dreaming status: blocked toont, is de beheerde dreaming-cron ingeschakeld, maar vuurt de Heartbeat die deze aandrijft niet voor de standaardagent. Zie Dreaming wordt nooit uitgevoerd voor de twee veelvoorkomende oorzaken.

memory index:

  • --force: forceer een volledige herindexering.

memory search:

  • Query-invoer: geef ofwel positioneel [query] of --query <text> door.
  • Als beide zijn opgegeven, wint --query.
  • Als geen van beide is opgegeven, sluit de opdracht af met een fout.
  • --agent <id>: beperk tot één agent (standaard: de standaardagent).
  • --max-results <n>: beperk het aantal geretourneerde resultaten.
  • --min-score <n>: filter overeenkomsten met een lage score weg.
  • --json: druk JSON-resultaten af.

memory promote:

Bekijk en pas kortetermijngeheugenpromoties toe.

bash
openclaw memory promote [--apply] [--limit <n>] [--include-promoted]
  • --apply -- schrijf promoties naar MEMORY.md (standaard: alleen voorbeeldweergave).
  • --limit <n> -- beperk het aantal getoonde kandidaten.
  • --include-promoted -- neem vermeldingen op die in eerdere cycli al zijn gepromoveerd.

Volledige opties:

  • Rangschikt kortetermijnkandidaten uit memory/YYYY-MM-DD.md met gewogen promotiesignalen (frequency, relevance, query diversity, recency, consolidation, conceptual richness).
  • Gebruikt kortetermijnsignalen uit zowel geheugenrecalls als dagelijkse ingestiepasses, plus versterkingssignalen uit light/REM-fasen.
  • Wanneer Dreaming is ingeschakeld, beheert memory-core automatisch één cronjob die op de achtergrond een volledige sweep uitvoert (light -> REM -> deep) (geen handmatige openclaw cron add vereist).
  • --agent <id>: beperk tot één agent (standaard: de standaardagent).
  • --limit <n>: maximaal aantal kandidaten om te retourneren/toe te passen.
  • --min-score <n>: minimale gewogen promotiescore.
  • --min-recall-count <n>: minimaal aantal recalls dat voor een kandidaat vereist is.
  • --min-unique-queries <n>: minimaal aantal verschillende queries dat voor een kandidaat vereist is.
  • --apply: voeg geselecteerde kandidaten toe aan MEMORY.md en markeer ze als gepromoveerd.
  • --include-promoted: neem al gepromoveerde kandidaten op in de uitvoer.
  • --json: druk JSON-uitvoer af.

memory promote-explain:

Leg een specifieke promotiekandidaat en de score-opbouw ervan uit.

bash
openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]
  • <selector>: kandidaatsleutel, padfragment of snippetfragment om op te zoeken.
  • --agent <id>: beperk tot één agent (standaard: de standaardagent).
  • --include-promoted: neem al gepromoveerde kandidaten op.
  • --json: druk JSON-uitvoer af.

memory rem-harness:

Bekijk REM-reflecties, kandidaatwaarheden en diepe promotie-uitvoer zonder iets te schrijven.

bash
openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]
  • --agent <id>: beperk tot één agent (standaard: de standaardagent).
  • --include-promoted: neem al gepromoveerde diepe kandidaten op.
  • --json: druk JSON-uitvoer af.

Dreaming

Dreaming is het achtergrondssysteem voor geheugenconsolidatie met drie samenwerkende fasen: light (kortetermijnmateriaal sorteren/stagen), deep (duurzame feiten naar MEMORY.md promoveren) en REM (reflecteren en thema's naar boven halen).

  • Schakel in met plugins.entries.memory-core.config.dreaming.enabled: true.
  • Schakel vanuit chat om met /dreaming on|off (of inspecteer met /dreaming status). Kanaalaanroepers moeten eigenaar zijn om de instelling te wijzigen; Gateway-clients hebben operator.admin nodig. Alleen-lezen status en hulp blijven beschikbaar voor geautoriseerde opdrachtverzenders.
  • Dreaming draait volgens één beheerd sweepschema (dreaming.frequency) en voert fasen in deze volgorde uit: light, REM, deep.
  • Alleen de deep-fase schrijft duurzaam geheugen naar MEMORY.md.
  • Menselijk leesbare fase-uitvoer en dagboekvermeldingen worden geschreven naar DREAMS.md (of bestaande dreams.md), met optionele rapporten per fase in memory/dreaming/<phase>/YYYY-MM-DD.md.
  • Rangschikking gebruikt gewogen signalen: recallfrequentie, retrievalrelevantie, querydiversiteit, temporele recentheid, consolidatie over dagen heen en afgeleide conceptrijkdom.
  • Promotie leest de live dagelijkse notitie opnieuw voordat naar MEMORY.md wordt geschreven, zodat bewerkte of verwijderde kortetermijnsnippets niet worden gepromoveerd vanuit verouderde snapshots van de recall-opslag.
  • Geplande en handmatige memory promote-runs delen dezelfde standaardinstellingen voor de deep-fase, tenzij je CLI-drempeloverschrijvingen doorgeeft.
  • Automatische runs waaieren uit over geconfigureerde geheugenwerkruimten.

Standaardplanning:

  • Sweep-cadans: dreaming.frequency = 0 3 * * *
  • Deep-drempels: minScore=0.8, minRecallCount=3, minUniqueQueries=3, recencyHalfLifeDays=14, maxAgeDays=30

Voorbeeld:

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

Opmerkingen:

  • memory index --verbose drukt details per fase af (provider, model, bronnen, batchactiviteit).
  • memory status bevat alle extra paden die via memorySearch.extraPaths zijn geconfigureerd.
  • Als effectief actieve remote API-sleutelvelden voor geheugen zijn geconfigureerd als SecretRefs, lost de opdracht die waarden op vanuit de actieve Gateway-snapshot. Als Gateway niet beschikbaar is, faalt de opdracht snel.
  • Opmerking over Gateway-versieverschil: dit opdrachtpad vereist een Gateway die secrets.resolve ondersteunt; oudere gateways retourneren een fout voor een onbekende methode.
  • Stem de geplande sweep-cadans af met dreaming.frequency. Deep-promotiebeleid is verder intern, behalve dreaming.phases.deep.maxPromotedSnippetTokens, dat de lengte van gepromoveerde snippets begrenst terwijl herkomst zichtbaar blijft. Gebruik CLI-vlaggen op memory promote wanneer je eenmalige handmatige drempeloverschrijvingen nodig hebt.
  • memory rem-harness --path <file-or-dir> --grounded toont een voorbeeld van gegronde What Happened, Reflections en Possible Lasting Updates uit historische dagelijkse notities zonder iets te schrijven.
  • memory rem-backfill --path <file-or-dir> schrijft omkeerbare gegronde dagboekvermeldingen naar DREAMS.md voor UI-beoordeling.
  • memory rem-backfill --path <file-or-dir> --stage-short-term zaait ook gegronde duurzame kandidaten in de live kortetermijnpromotieopslag, zodat de normale deep-fase ze kan rangschikken.
  • memory rem-backfill --rollback verwijdert eerder geschreven gegronde dagboekvermeldingen, en memory rem-backfill --rollback-short-term verwijdert eerder gestagede gegronde kortetermijnkandidaten.
  • Zie Dreaming voor volledige fasebeschrijvingen en configuratiereferentie.

Gerelateerd

Was this useful?
On this page

On this page