Achtergrondtaken

Achtergrondtaken volgen werk dat buiten je hoofdgesprekssessie wordt uitgevoerd: ACP-runs, subagent-spawns, geïsoleerde Cron-taakuitvoeringen en door de CLI gestarte bewerkingen.

Taken vervangen geen sessies, Cron-taken of heartbeats - ze zijn het activiteitenlogboek dat vastlegt welk losgekoppeld werk is gebeurd, wanneer, en of het is geslaagd.

TL;DR

• Taken zijn records, geen planners - Cron en Heartbeat bepalen wanneer werk wordt uitgevoerd, taken volgen wat er is gebeurd.
• ACP, subagents, alle Cron-taken en CLI-bewerkingen maken taken aan. Heartbeat-beurten doen dat niet.
• Elke taak doorloopt queued → running → terminal (succeeded, failed, timed_out, cancelled of lost).
• Cron-taken blijven actief zolang de Cron-runtime de taak nog beheert; als de runtime-status in het geheugen weg is, controleert taakonderhoud eerst de duurzame Cron- runhistorie voordat een taak als verloren wordt gemarkeerd.
• Voltooiing is push-gestuurd: losgekoppeld werk kan rechtstreeks melden of de aanvragersessie/Heartbeat wekken wanneer het klaar is, waardoor statuspollingloops meestal de verkeerde vorm zijn.
• Geïsoleerde Cron-runs en subagent-voltooiingen proberen best-effort gevolgde browsertabs/processen voor hun child-sessie op te ruimen voordat de laatste opschoonboekhouding plaatsvindt.
• Geïsoleerde Cron-levering onderdrukt verouderde tussentijdse bovenliggende antwoorden terwijl descendant-subagentwerk nog wordt afgehandeld, en geeft de voorkeur aan definitieve descendant-uitvoer wanneer die vóór levering arriveert.
• Voltooiingsmeldingen worden rechtstreeks aan een kanaal geleverd of in de wachtrij gezet voor de volgende Heartbeat.
• openclaw tasks list toont alle taken; openclaw tasks audit brengt problemen naar boven.
• Terminalrecords worden 7 dagen bewaard en daarna automatisch opgeschoond.

Snel aan de slag

# Alle taken tonen (nieuwste eerst)openclaw tasks list # Filteren op runtime of statusopenclaw tasks list --runtime acpopenclaw tasks list --status running

# Details tonen voor een specifieke taak (op ID, run-ID of sessiesleutel)openclaw tasks show <lookup>

# Een lopende taak annuleren (beëindigt de child-sessie)openclaw tasks cancel <lookup> # Meldingsbeleid voor een taak wijzigenopenclaw tasks notify <lookup> state_changes

# Een gezondheidsaudit uitvoerenopenclaw tasks audit # Onderhoud vooraf bekijken of toepassenopenclaw tasks maintenanceopenclaw tasks maintenance --apply

# TaskFlow-status inspecterenopenclaw tasks flow listopenclaw tasks flow show <lookup>openclaw tasks flow cancel <lookup>

Wat maakt een taak aan

Taaklevenscyclus

stateDiagram-v2
    [*] --> queued
    queued --> running : agent starts
    running --> succeeded : completes ok
    running --> failed : error
    running --> timed_out : timeout exceeded
    running --> cancelled : operator cancels
    queued --> lost : session gone > 5 min
    running --> lost : session gone > 5 min

Overgangen gebeuren automatisch - wanneer de bijbehorende agent-run eindigt, wordt de taakstatus bijgewerkt zodat die overeenkomt.

Voltooiing van de agent-run is gezaghebbend voor actieve taakrecords. Een geslaagde losgekoppelde run wordt afgerond als succeeded, gewone runfouten worden afgerond als failed, en time-out- of afbreekresultaten worden afgerond als timed_out. Als een operator de taak al heeft geannuleerd, of als de runtime al een sterkere terminalstatus zoals failed, timed_out of lost heeft vastgelegd, verlaagt een later successignaal die terminalstatus niet.

lost is runtime-bewust:

• ACP-taken: onderliggende ACP-child-sessiemetadata is verdwenen.
• Subagent-taken: onderliggende child-sessie is verdwenen uit de doelagentstore.
• Cron-taken: de Cron-runtime volgt de taak niet langer als actief en duurzame Cron-runhistorie toont geen terminalresultaat voor die run. Offline CLI- audit behandelt de eigen lege in-process Cron-runtime-status niet als autoriteit.
• CLI-taken: taken met een run-ID/source-ID gebruiken de live-runcontext, zodat achterblijvende child-sessie- of chatsessierijen ze niet actief houden nadat de Gateway-beheerde run verdwijnt. Legacy CLI-taken zonder runidentiteit vallen nog steeds terug op de child-sessie. Gateway-ondersteunde openclaw agent-runs worden ook afgerond op basis van hun runresultaat, zodat voltooide runs niet actief blijven totdat de sweeper ze als lost markeert.

Levering en meldingen

Wanneer een taak een terminalstatus bereikt, meldt OpenClaw je dat. Er zijn twee leveringspaden:

Rechtstreekse levering - als de taak een kanaaldoel heeft (de requesterOrigin), gaat het voltooiingsbericht rechtstreeks naar dat kanaal (Telegram, Discord, Slack, enz.). Voltooiingen van groeps- en kanaaltaken worden in plaats daarvan via de aanvragersessie gerouteerd, zodat de parent-agent het zichtbare antwoord kan schrijven. Voor subagent-voltooiingen behoudt OpenClaw ook gebonden thread-/topic-routering wanneer beschikbaar en kan het een ontbrekende to / account invullen uit de opgeslagen route van de aanvragersessie (lastChannel / lastTo / lastAccountId) voordat rechtstreekse levering wordt opgegeven.

Sessie-gequeueerde levering - als rechtstreekse levering mislukt of geen origin is ingesteld, wordt de update als systeemgebeurtenis in de sessie van de aanvrager in de wachtrij gezet en verschijnt deze bij de volgende Heartbeat.

Dat betekent dat de gebruikelijke workflow push-gebaseerd is: start losgekoppeld werk één keer en laat de runtime je wekken of melden wanneer het is voltooid. Poll taakstatus alleen wanneer je debugging, interventie of een expliciete audit nodig hebt.

Meldingsbeleid

Bepaal hoeveel je over elke taak hoort:

Wijzig het beleid terwijl een taak draait:

openclaw tasks notify <lookup> state_changes

CLI-referentie

openclaw tasks list [--runtime <acp|subagent|cron|cli>] [--status <status>] [--json]

openclaw tasks show <lookup>

openclaw tasks cancel <lookup>

openclaw tasks notify <lookup> <done_only|state_changes|silent>

openclaw tasks audit [--json]

openclaw tasks maintenance [--json]openclaw tasks maintenance --apply [--json]

openclaw tasks flow list [--status <status>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>

Chattaakbord (/tasks)

Gebruik /tasks in elke chatsessie om achtergrondtaken te zien die aan die sessie zijn gekoppeld. Het bord toont actieve en recent voltooide taken met runtime, status, timing en voortgangs- of foutdetails.

Wanneer de huidige sessie geen zichtbare gekoppelde taken heeft, valt /tasks terug op agent-lokale taakaantallen, zodat u toch een overzicht krijgt zonder details uit andere sessies te lekken.

Gebruik voor het volledige operatorlogboek de CLI: openclaw tasks list.

Statusintegratie (taakdruk)

openclaw status bevat een taakoverzicht in één oogopslag:

Tasks: 3 queued · 2 running · 1 issues

Het overzicht rapporteert:

• actief - aantal queued + running
• mislukkingen - aantal failed + timed_out + lost
• byRuntime - uitsplitsing naar acp, subagent, cron, cli

Zowel /status als de tool session_status gebruiken een opschoonbewuste taaksnapshot: actieve taken krijgen de voorkeur, verouderde voltooide rijen worden verborgen, en recente mislukkingen verschijnen alleen wanneer er geen actief werk overblijft. Zo blijft de statuskaart gericht op wat er nu toe doet.

Opslag en onderhoud

Waar taken staan

Taakrecords blijven bestaan in SQLite op:

$OPENCLAW_STATE_DIR/tasks/runs.sqlite

Het register wordt bij het starten van de Gateway in het geheugen geladen en synchroniseert schrijfbewerkingen naar SQLite voor duurzaamheid over herstarts heen. De Gateway houdt het SQLite write-ahead log begrensd door SQLite's standaard autocheckpoint-drempel te gebruiken plus periodieke TRUNCATE-checkpoints en checkpoints bij afsluiten.

Automatisch onderhoud

Elke 60 seconden draait er een sweeper die vier dingen afhandelt:

Hoe taken zich verhouden tot andere systemen

Gerelateerd

• Automatisering - alle automatiseringsmechanismen in één oogopslag
• CLI: Tasks - CLI-commandoreferentie
• Heartbeat - periodieke main-session-beurten
• Geplande taken - achtergrondwerk plannen
• Task Flow - flow-orkestratie boven taken