Achtergrondtaken

Achtergrondtaken volgen werk dat buiten je hoofdgesprekssessie wordt uitgevoerd: ACP-runs, het starten van subagents, uitvoeringen van Cron-taken en via de CLI gestarte bewerkingen.

Taken vervangen sessies, Cron-taken of Heartbeats niet: ze vormen het activiteitenregister waarin wordt vastgelegd welk losgekoppeld werk is uitgevoerd, wanneer dat gebeurde en of het is geslaagd.

Kort samengevat

• Taken zijn registraties, geen planners: Cron en Heartbeat bepalen wanneer werk wordt uitgevoerd; taken houden bij 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 (geslaagd, mislukt, verlopen, geannuleerd of verloren).
• Cron-taken blijven actief zolang de Cron-runtime nog eigenaar is van de taak; als de runtimestatus in het geheugen verdwenen is, controleert taakonderhoud eerst de duurzame uitvoeringsgeschiedenis van Cron voordat een taak als verloren wordt gemarkeerd.
• Voltooiing wordt via push afgehandeld: losgekoppeld werk kan rechtstreeks een melding sturen of de sessie/Heartbeat van de aanvrager activeren zodra het klaar is. Lussen die de status blijven opvragen, zijn daarom meestal niet de juiste aanpak.
• Geïsoleerde Cron-runs en voltooide subagents proberen zo goed mogelijk bijgehouden browsertabbladen en -processen van hun kindsessie op te ruimen voordat de laatste opruimadministratie wordt uitgevoerd.
• Bij levering vanuit een geïsoleerde Cron-run worden verouderde tussentijdse antwoorden van de bovenliggende sessie onderdrukt zolang werk van onderliggende subagents nog wordt afgerond. Als de definitieve uitvoer van een onderliggende subagent vóór de levering binnenkomt, krijgt die de voorkeur.
• Voltooiingsmeldingen worden rechtstreeks aan een kanaal geleverd of in de wachtrij geplaatst voor de volgende Heartbeat.
• openclaw tasks list toont alle taken; openclaw tasks audit brengt problemen aan het licht.
• Definitieve registraties worden 7 dagen bewaard (lost-registraties 24 uur) en daarna automatisch opgeschoond.

Snel aan de slag

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

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

# Een actieve taak annuleren (beëindigt de kindsessie)openclaw tasks cancel <lookup> # Het meldingsbeleid voor een taak wijzigenopenclaw tasks notify <lookup> state_changes

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

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

Wat een taak aanmaakt

Levenscyclus van taken

stateDiagram-v2
    [*] --> queued
    queued --> running : agent start
    running --> succeeded : voltooit met succes
    running --> failed : fout
    running --> timed_out : time-out overschreden
    queued --> cancelled : operator annuleert
    running --> cancelled : operator annuleert
    queued --> lost : onderliggende status > 5 min verdwenen
    running --> lost : onderliggende status > 5 min verdwenen

Overgangen vinden automatisch plaats: levenscyclusgebeurtenissen van de agentrun (start, einde, fout) werken de taakstatus bij; je beheert deze niet handmatig.

De voltooiing van de agentrun is gezaghebbend voor actieve taakregistraties. Een geslaagde losgekoppelde run eindigt als succeeded, gewone runfouten eindigen als failed, time-outs eindigen als timed_out en annuleringen/afbrekingen eindigen als cancelled. Zodra een taak definitief is, kunnen latere levenscyclussignalen de status niet meer terugzetten: een door de operator geannuleerde of al failed/timed_out/lost taak behoudt die status, zelfs als daarna een successignaal binnenkomt.

lost houdt rekening met de runtime:

• ACP-taken: alleen een actieve ACP-beurt binnen het Gateway-proces bewijst dat de run nog actief is; alleen persistente sessiemetadata is onvoldoende. Offline CLI-controle blijft terughoudend en neemt ACP-taken nooit terug.
• Subagenttaken: de onderliggende kindsessie is verdwenen uit de opslag van de doelagent (of bevat een grafsteen voor herstel na opnieuw opstarten).
• Cron-taken: de Cron-runtime houdt de taak niet meer als actief bij en de duurzame uitvoeringsgeschiedenis van Cron bevat geen definitief resultaat voor die run. Offline CLI-controle beschouwt de eigen lege Cron-runtimestatus in het proces niet als gezaghebbend.
• CLI-taken: taken met een run-id/bron-id gebruiken de actieve runcontext, zodat achtergebleven rijen voor kindsessies of chatsessies ze niet actief houden nadat de door de Gateway beheerde run verdwijnt. Verouderde CLI-taken zonder runidentiteit vallen nog terug op de kindsessie. Door de Gateway ondersteunde openclaw agent-runs worden ook afgerond op basis van hun runresultaat, zodat voltooide runs niet actief blijven totdat de opruimer ze als lost markeert.

Levering en meldingen

Wanneer een taak een definitieve status bereikt, stelt OpenClaw je daarvan op de hoogte. Er zijn twee leveringspaden:

Rechtstreekse levering: als de taak een kanaaldoel heeft (de requesterOrigin), gaat het voltooiingsbericht rechtstreeks naar dat kanaal (Discord, Slack, Telegram enzovoort). Voltooiingen van groeps- en kanaaltaken worden in plaats daarvan via de aanvragende sessie geleid, zodat de bovenliggende agent het zichtbare antwoord kan schrijven. Voor voltooide subagents behoudt OpenClaw indien beschikbaar ook de gekoppelde thread-/onderwerproutering en kan het een ontbrekende to / account aanvullen vanuit de opgeslagen route van de aanvragende sessie (lastChannel / lastTo / lastAccountId) voordat rechtstreekse levering wordt opgegeven.

Levering via de sessiewachtrij: als rechtstreekse levering mislukt of geen oorsprong is ingesteld, wordt de update als systeemgebeurtenis in de sessie van de aanvrager in de wachtrij geplaatst en verschijnt deze bij de volgende Heartbeat.

Dit betekent dat de gebruikelijke workflow op push is gebaseerd: start losgekoppeld werk één keer en laat de runtime je vervolgens bij voltooiing activeren of informeren. Vraag de taakstatus alleen op wanneer je moet debuggen, ingrijpen of een expliciete controle moet uitvoeren.

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> [--json]

openclaw tasks cancel <lookup>

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

openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--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 bekijken die aan die sessie zijn gekoppeld. Het bord toont maximaal vijf actieve en onlangs voltooide taken met runtime, status, timing en voortgangs- of foutdetails.

Wanneer de huidige sessie geen zichtbare gekoppelde taken heeft, valt /tasks terug op agentlokale taakaantallen, zodat je toch een overzicht krijgt zonder details van andere sessies prijs te geven.

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

Control UI

De Control UI op het web heeft in de zijbalk een pagina Taken met actuele actieve en recente achtergrondtaken. Gebruik deze om de voortgang te bekijken, gekoppelde sessies te openen, het logboek te vernieuwen of taken in de wachtrij en actieve taken te annuleren.

Chatvensters hebben ook een inklapbare rail Achtergrondtaken, beperkt tot de agent van het venster: actieve taken en subagents met een stopknop, een sectie met voltooide taken en links Transcript bekijken naar de kindsessie van elke taak. Open deze via de activiteitsschakelaar in de koptekst van het venster (of via de zwevende activiteitsknop in een chat met één venster).

Selecteer een taak in de rail om de afgebakende invoerprompt en de meest recente uitvoer of foutsamenvatting te bekijken. Actief werk blijft gescheiden van voltooid werk en voltooide rijen geven aan of de taak is voltooid of mislukt. Open op iOS Chat actions → Background Tasks; open op Android het overloopmenu van Chat en selecteer Background tasks. Beide mobiele weergaven gebruiken dezelfde groepering Running en Finished en openen taakdetails wanneer je een taak selecteert.

Statusintegratie (taakdruk)

openclaw status bevat een taakregel die in één oogopslag inzicht geeft:

Taken    2 actief · 1 in wachtrij · 1 wordt uitgevoerd · 1 probleem · audit schoon · 6 bijgehouden

De samenvatting telt actief werk (queued + running), fouten (failed + timed_out + lost), auditbevindingen en het totale aantal bijgehouden records; de JSON-payload splitst de aantallen ook uit per runtime (acp, subagent, cron, cli).

Zowel /status als de tool session_status gebruikt een taakmomentopname die rekening houdt met opschoning: actieve taken hebben voorrang, verlopen rijen worden verborgen en afgesloten taken verschijnen slechts gedurende een kort recent tijdvenster (5 minuten), waarbij fouten worden uitgelicht als er geen actief werk overblijft. Hierdoor richt de statuskaart zich op wat nu belangrijk is.

Opslag en onderhoud

Waar taken worden opgeslagen

Taakrecords en bezorgingsstatus worden permanent opgeslagen in de gedeelde SQLite-statusdatabase van OpenClaw:

~/.openclaw/state/openclaw.sqlite   (tabellen: task_runs, task_delivery_state, flow_runs)

Stel OPENCLAW_STATE_DIR in om de volledige statushoofdmap (standaard ~/.openclaw) elders te plaatsen; het pad naar de gedeelde database verhuist mee.

Het register wordt bij het eerste gebruik in het geheugen geladen en elke schrijfactie wordt permanent naar SQLite weggeschreven, zodat records herstarts van de Gateway overleven. De groei van WAL blijft begrensd door de standaarddrempel voor automatische checkpoints van SQLite plus periodieke PASSIVE-checkpoints; checkpoints bij afsluiten en expliciet onderhoud gebruiken TRUNCATE, zodat bij normale afsluiting WAL-ruimte wordt teruggewonnen zonder dat de achtergrondsweeper op actieve lezers hoeft te wachten.

Verouderde sidecar-opslagplaatsen uit oudere installaties (tasks/runs.sqlite, flows/registry.sqlite) worden door openclaw doctor in de gedeelde database geïmporteerd.

Automatisch onderhoud

Elke 60 seconden wordt een sweeper uitgevoerd (de eerste keer ongeveer 5 seconden nadat de Gateway is gestart), die vier zaken afhandelt:

Relatie tussen taken en andere systemen

Gerelateerd

• Automatisering - alle automatiseringsmechanismen in één oogopslag
• CLI: Taken - naslaginformatie voor CLI-opdrachten
• Heartbeat - periodieke beurten in de hoofdsessie
• Geplande taken - achtergrondwerk plannen
• Taakflow - floworkestratie boven op taken