Achtergrondtaken

Achtergrondtaken volgen werk dat buiten je hoofdgesprekssessie wordt uitgevoerd: ACP-runs, het starten van subagents, 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 heeft plaatsgevonden, wanneer dat gebeurde 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 live terwijl de Cron-runtime de taak nog bezit; als de in-memory runtimestatus weg is, controleert taakonderhoud eerst de duurzame Cron-runhistorie voordat een taak als verloren wordt gemarkeerd.
• Voltooiing is push-gedreven: losgekoppeld werk kan rechtstreeks melden of de aanvraagsessie/Heartbeat wekken wanneer het klaar is, dus status-pollinglussen hebben meestal de verkeerde vorm.
• Geïsoleerde Cron-runs en subagent-voltooiingen ruimen best-effort bijgehouden browsertabbladen/processen voor hun child-sessie op voordat de uiteindelijke opschoningsboekhouding plaatsvindt.
• Geïsoleerde Cron-aflevering onderdrukt verouderde tussentijdse parent-antwoorden terwijl afstammend subagent-werk nog wordt afgehandeld, en geeft de voorkeur aan uiteindelijke afstammende uitvoer wanneer die vóór aflevering arriveert.
• Voltooiingsmeldingen worden rechtstreeks aan een kanaal afgeleverd of in de wachtrij gezet voor de volgende Heartbeat.
• openclaw tasks list toont alle taken; openclaw tasks audit brengt problemen naar voren.
• Terminale records worden 7 dagen bewaard en daarna automatisch opgeschoond.

# Snel starten

# List all tasks (newest first)
openclaw tasks list

# Filter by runtime or status
openclaw tasks list --runtime acp
openclaw tasks list --status running

# Show details for a specific task (by ID, run ID, or session key)
openclaw tasks show <lookup>

# Cancel a running task (kills the child session)
openclaw tasks cancel <lookup>

# Change notification policy for a task
openclaw tasks notify <lookup> state_changes

# Run a health audit
openclaw tasks audit

# Preview or apply maintenance
openclaw tasks maintenance
openclaw tasks maintenance --apply

# Inspect TaskFlow state
openclaw tasks flow list
openclaw tasks flow show <lookup>
openclaw tasks flow cancel <lookup>

# Wat een taak aanmaakt

# 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 gekoppelde agent-run eindigt, wordt de taakstatus bijgewerkt zodat die overeenkomt.

Voltooiing van de agent-run is gezaghebbend voor actieve taakrecords. Een succesvolle losgekoppelde run wordt afgerond als succeeded, gewone runfouten worden afgerond als failed, en time-out- of afbreekuitkomsten worden afgerond als timed_out. Als een operator de taak al heeft geannuleerd, of de runtime al een sterkere terminale status heeft vastgelegd zoals failed, timed_out of lost, verlaagt een later successignaal die terminale status 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 de duurzame Cron-runhistorie toont geen terminaal resultaat voor die run. Offline CLI- audit beschouwt de eigen lege in-process Cron-runtimestatus niet als gezaghebbend.
• CLI-taken: geïsoleerde child-sessietaken gebruiken de child-sessie; chatgedragen CLI-taken gebruiken in plaats daarvan de live runcontext, zodat achterblijvende kanaal-/groep-/directe sessierijen ze niet actief houden. Gateway-gedragen openclaw agent-runs worden ook afgerond op basis van hun runresultaat, zodat voltooide runs niet actief blijven totdat de sweeper ze als lost markeert.

# Aflevering en meldingen

Wanneer een taak een terminale status bereikt, meldt OpenClaw je dat. Er zijn twee afleverpaden:

Rechtstreekse aflevering - als de taak een kanaaldoel heeft (de requesterOrigin), gaat het voltooiingsbericht direct naar dat kanaal (Telegram, Discord, Slack, enz.). Voor subagent-voltooiingen behoudt OpenClaw ook gebonden thread-/topic-routering wanneer beschikbaar en kan een ontbrekende to / account invullen vanuit de opgeslagen route van de aanvraagsessie (lastChannel / lastTo / lastAccountId) voordat rechtstreekse aflevering wordt opgegeven.

Sessie-wachtrijaflevering - als rechtstreekse aflevering mislukt of er geen origin is ingesteld, wordt de update als systeemgebeurtenis in de sessie van de aanvrager in de wachtrij gezet en verschijnt die bij de volgende Heartbeat.

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

# Meldingsbeleid

Bepaal hoeveel je over elke taak hoort:

Wijzig het beleid terwijl een taak actief is:

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 taaktellingen, zodat je nog steeds een overzicht krijgt zonder details uit andere sessies te lekken.

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

# Statusintegratie (taakdruk)

openclaw status bevat een taaksamenvatting in één oogopslag:

Tasks: 3 queued · 2 running · 1 issues

De samenvatting rapporteert:

• active - aantal queued + running
• failures - aantal failed + timed_out + lost
• byRuntime - uitsplitsing per acp, subagent, cron, cli

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

# Opslag en onderhoud

# Waar taken staan

Taakrecords blijven bewaard in SQLite op:

$OPENCLAW_STATE_DIR/tasks/runs.sqlite

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

# Automatisch onderhoud

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

# Hoe taken zich verhouden tot andere systemen

# Gerelateerd

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