Skip to main content

openclaw memory

Beheer semantische geheugenindexering, zoeken en promotie naar MEMORY.md. Geleverd door de gebundelde Plugin memory-core, beschikbaar wanneer plugins.slots.memory memory-core selecteert (de standaardinstelling). Andere geheugenplugins bieden hun eigen CLI-naamruimten. Gerelateerd: het concept Geheugen, Dreaming, Referentie voor geheugenconfiguratie, Geheugenwiki, wiki, Plugins.

memory status

Zonder --agent wordt de opdracht uitgevoerd voor elke agent in agents.entries; als er geen agentenlijst is geconfigureerd, wordt teruggevallen op de standaardagent. Als de regel Dreaming zelfs met dreaming.enabled: true op off blijft staan, of geplande sweeps nooit lijken te worden uitgevoerd, is de beheerde Dreaming-Cron afhankelijk van het activeren van de Heartbeat van de standaardagent om reconciliatie te starten. Zie Dreaming voor planningsdetails. De status vermeldt ook eventuele extra zoekpaden uit memory.search.extraPaths.

memory index

Dezelfde afbakening per agent als status. --force voert een volledige herindexering uit in plaats van een incrementele. --verbose toont per agent de provider, het model, de bronnen en details over extra paden voordat de voortgang van het indexeren wordt weergegeven.
  • Zoekopdracht: positionele [query] of --query <text>. Als beide zijn ingesteld, heeft --query voorrang. Als geen van beide is ingesteld, geeft de opdracht een fout.
  • --agent <id>: gebruikt standaard de standaardagent (niet de volledige agentenlijst).
  • --max-results <n>: beperk het aantal resultaten (positief geheel getal).
  • --min-score <n>: filter overeenkomsten onder deze score weg.

memory promote

Rangschik kortetermijnkandidaten uit memory/YYYY-MM-DD.md en voeg desgewenst de beste vermeldingen toe aan MEMORY.md.
Deze CLI-standaardwaarden verschillen van de drempelwaarden voor de diepe fase van de geplande Dreaming-sweep (zie Dreaming hieronder); geef expliciete vlaggen door om het sweepgedrag te evenaren voor een eenmalige handmatige uitvoering. Rangschikkingssignalen: recallfrequentie, relevantie van opgehaalde gegevens, diversiteit van zoekopdrachten, temporele recentheid, consolidatie over meerdere dagen en rijkdom van afgeleide concepten, verkregen uit zowel geheugenrecalls als dagelijkse opnamepassages, plus een lichte versterkingsbonus voor de lichte/REM-fase bij herhaalde Dreaming-herbezoeken. Vóór het schrijven leest de promotie de actuele dagelijkse notitie opnieuw, zodat wijzigingen of verwijderingen van kortetermijnfragmenten sinds de rangschikking worden gerespecteerd in plaats van uit een verouderde momentopname te promoveren.

memory promote-explain

Leg de opbouw van de score van één promotiekandidaat uit.
<selector> komt overeen met de sleutel (exact of als subtekenreeks), het pad of de fragmenttekst van een kandidaat.

memory rem-harness

Bekijk REM-reflecties, kandidaatwaarheden en promotie-uitvoer van de diepe fase zonder iets te schrijven.
  • --path <file-or-dir>: vul de harness vanuit historische dagelijkse bestanden van YYYY-MM-DD.md in plaats van de actuele werkruimte.
  • --grounded: geef ook een onderbouwd voorbeeld van What Happened / Reflections / Possible Lasting Updates weer op basis van de historische notities.

memory rem-backfill

Schrijf onderbouwde historische REM-samenvattingen naar DREAMS.md voor beoordeling in de gebruikersinterface. Omkeerbaar.
  • --path <file-or-dir>: vereist tenzij --rollback/--rollback-short-term is ingesteld. Historische dagelijkse geheugenbestanden of map waaruit gegevens worden aangevuld.
  • --stage-short-term: vul ook onderbouwde duurzame kandidaten in de actuele kortetermijnpromotieopslag in, zodat de normale diepe fase ze kan rangschikken.
  • --rollback: verwijder eerder geschreven onderbouwde dagboekvermeldingen uit DREAMS.md.
  • --rollback-short-term: verwijder eerder klaargezette onderbouwde kortetermijnkandidaten.

Dreaming

Dreaming is het systeem voor geheugenconsolidatie op de achtergrond met drie samenwerkende fasen, die in volgorde volgens één planning worden uitgevoerd: licht (kortetermijnmateriaal sorteren/klaarzetten), REM (reflecteren en thema’s naar voren brengen), diep (duurzame feiten promoveren naar MEMORY.md). Alleen de diepe fase schrijft naar MEMORY.md.
  • Schakel in met plugins.entries.memory-core.config.dreaming.enabled: true (standaard false); memory-core beheert de Cron-taak voor de sweep automatisch, geen handmatige openclaw cron add vereist.
  • Schakel vanuit de chat met /dreaming on|off; inspecteer met /dreaming status (of /dreaming//dreaming help). on/off vereist de status van kanaaleigenaar of Gateway-operator.admin; status en hulp blijven beschikbaar voor iedereen die de opdracht kan aanroepen.
  • Menselijk leesbare fase-uitvoer gaat naar DREAMS.md (of een bestaande dreams.md). Standaard (dreaming.storage.mode: "separate") schrijft elke fase ook een zelfstandig rapport naar memory/dreaming/<phase>/YYYY-MM-DD.md; stel mode: "inline" in om rapporten in plaats daarvan in het dagelijkse geheugenbestand op te nemen, of "both" voor beide.
  • Geplande en handmatige uitvoeringen van memory promote gebruiken dezelfde rangschikkingssignalen voor de diepe fase; alleen de standaarddrempelwaarden verschillen (zie de tabel hierboven tegenover de geplande standaardwaarden hieronder).
  • Geplande uitvoeringen worden verdeeld over de geheugenwerkruimte van elke geconfigureerde agent.
Geplande standaardwaarden (plugins.entries.memory-core.config.dreaming):
Volledige lijst met sleutels en fasedetails: Dreaming, Referentie voor geheugenconfiguratie.

SecretRef-afhankelijkheid van de Gateway

Als externe API-sleutelvelden voor Active Memory zijn geconfigureerd als SecretRefs, lossen memory-opdrachten deze op vanuit de actieve Gateway-momentopname; als de Gateway niet beschikbaar is, mislukt de opdracht onmiddellijk. Hiervoor is een Gateway vereist die de methode secrets.resolve ondersteunt; oudere Gateways retourneren een fout voor een onbekende methode.

Gerelateerd