Sessions and memory

Afgeleide toezeggingen

Commitments zijn kortdurende herinneringen voor opvolging. Wanneer deze functie is ingeschakeld, kan OpenClaw opmerken dat een gesprek aanleiding geeft tot een toekomstig contactmoment en onthouden om er later op terug te komen.

Voorbeelden:

  • Je noemt een sollicitatiegesprek dat morgen plaatsvindt. OpenClaw kan daarna vragen hoe het ging.
  • Je zegt dat je uitgeput bent. OpenClaw kan later vragen of je hebt geslapen.
  • De agent zegt dat deze iets zal opvolgen nadat er iets verandert. OpenClaw kan die openstaande kwestie bijhouden.

Commitments zijn geen duurzame feiten zoals MEMORY.md en ook geen exacte herinneringen. Ze bevinden zich tussen geheugen en automatisering: OpenClaw onthoudt een gespreksgebonden verplichting, waarna Heartbeat deze aflevert wanneer het moment daarvoor is aangebroken.

Commitments inschakelen

Commitments zijn standaard uitgeschakeld (commitments.enabled: false). Schakel ze in de configuratie in:

bash
openclaw config set commitments.enabled trueopenclaw config set commitments.maxPerDay 3

Gelijkwaardige openclaw.json:

json
{  "commitments": {    "enabled": true,    "maxPerDay": 3  }}

commitments.maxPerDay beperkt hoeveel afgeleide opvolgingen per agentsessie binnen een voortschrijdende dag kunnen worden afgeleverd. De standaardwaarde is 3.

Werking

Na een antwoord van een agent kan OpenClaw een verborgen extractieronde op de achtergrond uitvoeren in een afzonderlijke context, waarbij tools zijn uitgeschakeld. Die ronde zoekt uitsluitend naar afgeleide opvolgverplichtingen. Deze schrijft niets naar het zichtbare gesprek en vraagt de hoofdagent niet om over de extractie te redeneren.

Wanneer een kandidaat met hoge betrouwbaarheid wordt gevonden, slaat OpenClaw een Commitment op met:

  • de agent-id
  • de sessiesleutel
  • het oorspronkelijke kanaal en afleverdoel
  • een tijdvenster voor uitvoering
  • een korte voorgestelde navraag
  • niet-instruerende metagegevens waarmee Heartbeat bepaalt of deze moet worden verzonden

Aflevering vindt plaats via Heartbeat. Wanneer het tijdstip voor een Commitment is aangebroken, voegt Heartbeat de Commitment toe aan de Heartbeat-beurt voor dezelfde agent- en kanaalcontext. De prompt waarschuwt expliciet dat de metagegevens van de Commitment niet worden vertrouwd en instrueert het model om instructies daarin niet te volgen en er geen tools vanwege te gebruiken. Het model kan één natuurlijke navraag verzenden of met HEARTBEAT_OK antwoorden om deze te negeren. Als Heartbeat is geconfigureerd met target: "none", blijven vervallen Commitments intern en worden er geen externe contactmomenten verzonden. Prompts voor het afleveren van Commitments herhalen de oorspronkelijke gesprekstekst niet, maar bevatten alleen de voorgestelde navraag en metagegevens. Heartbeat-beurten voor vervallen Commitments worden zonder OpenClaw-tools uitgevoerd.

OpenClaw levert een afgeleide Commitment nooit onmiddellijk na het opslaan af. Het tijdstip wordt begrensd op minimaal één Heartbeat-interval nadat de Commitment is aangemaakt, zodat de opvolging niet op hetzelfde moment wordt teruggestuurd als waarop deze werd afgeleid.

Bereik

Commitments zijn beperkt tot exact de agent- en kanaalcontext waarin ze zijn aangemaakt. Een opvolging die is afgeleid tijdens een gesprek met één agent in Discord wordt niet afgeleverd door een andere agent, een ander kanaal of een niet-gerelateerde sessie.

Dit bereik maakt deel uit van de functie. Natuurlijke contactmomenten moeten aanvoelen alsof hetzelfde gesprek wordt voortgezet, niet als een wereldwijd herinneringssysteem.

Commitments versus herinneringen

Behoefte Gebruik
"Herinner me om 15.00 uur" Geplande taken
"Stuur me over 20 minuten een bericht" Geplande taken
"Voer dit rapport elke werkdag uit" Geplande taken
"Ik heb morgen een sollicitatiegesprek" Commitments
"Ik ben de hele nacht wakker geweest" Commitments
"Volg dit openstaande gesprek op als ik niet antwoord" Commitments

Exacte verzoeken van gebruikers horen al bij het pad van de planner. Commitments zijn uitsluitend bedoeld voor afgeleide opvolgingen: momenten waarop de gebruiker niet om een herinnering heeft gevraagd, maar het gesprek duidelijk aanleiding gaf tot een nuttig toekomstig contactmoment.

Commitments beheren

Gebruik de CLI om opgeslagen Commitments te bekijken en te wissen:

bash
openclaw commitmentsopenclaw commitments --allopenclaw commitments --agent mainopenclaw commitments --status snoozedopenclaw commitments dismiss cm_abc123

Zie openclaw commitments voor de volledige opdrachtreferentie.

Privacy en kosten

Voor het extraheren van Commitments wordt een LLM-ronde gebruikt. Als je deze functie inschakelt, leidt dat dus tot extra modelgebruik op de achtergrond na geschikte beurten. De ronde is verborgen in het voor de gebruiker zichtbare gesprek, maar kan de recente uitwisseling lezen die nodig is om te bepalen of er een opvolging bestaat.

Opgeslagen Commitments zijn lokale OpenClaw-statusgegevens. Ze zijn operationeel geheugen, geen langetermijngeheugen. Schakel de functie uit met:

bash
openclaw config set commitments.enabled false

Probleemoplossing

Als verwachte opvolgingen niet verschijnen:

  • Controleer of commitments.enabled true is.
  • Controleer met openclaw commitments --all op wachtende, genegeerde, uitgestelde of verlopen vermeldingen.
  • Controleer of Heartbeat actief is voor de agent.
  • Controleer of commitments.maxPerDay voor die agentsessie al is bereikt.
  • Onthoud dat exacte herinneringen bij de extractie van Commitments worden overgeslagen en in plaats daarvan onder geplande taken moeten verschijnen.

Gerelateerd

Was this useful?
On this page

On this page