Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw voert werk op de achtergrond uit via taken, geplande jobs, afgeleide toezeggingen, event hooks en vaste instructies. Deze pagina helpt je het juiste mechanisme te kiezen en te begrijpen hoe ze samenhangen.

Snelle beslisgids

GebruikssituatieAanbevolenWaarom
Dagelijks rapport precies om 9:00 verzendenGeplande taken (Cron)Exacte timing, geïsoleerde uitvoering
Herinner me over 20 minutenGeplande taken (Cron)Eenmalig met precieze timing (--at)
Wekelijkse diepgaande analyse uitvoerenGeplande taken (Cron)Zelfstandige taak, kan een ander model gebruiken
Inbox elke 30 min controlerenHeartbeatBundelt met andere controles, contextbewust
Agenda monitoren op aankomende gebeurtenissenHeartbeatPast natuurlijk bij periodiek bewustzijn
Navragen na een genoemd interviewAfgeleide toezeggingenGeheugenachtige follow-up, geen exact herinneringsverzoek
Voorzichtige check-in na gebruikerscontextAfgeleide toezeggingenBeperkt tot dezelfde agent en hetzelfde kanaal
Status van een subagent of ACP-run inspecterenAchtergrondtakenTakenregister volgt al het losgekoppelde werk
Controleren wat wanneer is uitgevoerdAchtergrondtakenopenclaw tasks list en openclaw tasks audit
Meertraps onderzoek en daarna samenvattenTask FlowDuurzame orkestratie met revisietracking
Een script uitvoeren bij sessieresetHooksEventgestuurd, wordt uitgevoerd bij lifecycle-events
Code uitvoeren bij elke toolaanroepPlugin hooksIn-process hooks kunnen toolaanroepen onderscheppen
Altijd compliance controleren vóór antwoordenVaste instructiesAutomatisch in elke sessie geïnjecteerd

Geplande taken (Cron) versus Heartbeat

DimensieGeplande taken (Cron)Heartbeat
TimingExact (cronexpressies, eenmalig)Bij benadering (standaard elke 30 min)
SessiecontextNieuw (geïsoleerd) of gedeeldVolledige hoofdsessiecontext
TaakrecordsAltijd aangemaaktNooit aangemaakt
LeveringKanaal, webhook of stilInline in hoofdsessie
Beste voorRapporten, herinneringen, achtergrondjobsInboxcontroles, agenda, meldingen
Gebruik geplande taken (Cron) wanneer je precieze timing of geïsoleerde uitvoering nodig hebt. Gebruik Heartbeat wanneer het werk baat heeft bij volledige sessiecontext en timing bij benadering volstaat.

Kernconcepten

Geplande taken (cron)

Cron is de ingebouwde planner van de Gateway voor precieze timing. Het bewaart jobs, wekt de agent op het juiste moment en kan output leveren aan een chatkanaal of webhook-endpoint. Ondersteunt eenmalige herinneringen, terugkerende expressies en inkomende webhook-triggers. Zie Geplande taken.

Taken

Het achtergrondtakenregister volgt al het losgekoppelde werk: ACP-runs, subagent-spawns, geïsoleerde cronuitvoeringen en CLI-bewerkingen. Taken zijn records, geen planners. Gebruik openclaw tasks list en openclaw tasks audit om ze te inspecteren. Zie Achtergrondtaken.

Afgeleide toezeggingen

Toezeggingen zijn opt-in, kortlevende follow-upherinneringen. OpenClaw leidt ze af uit normale gesprekken, beperkt ze tot dezelfde agent en hetzelfde kanaal, en levert check-ins wanneer ze verschuldigd zijn via Heartbeat. Exacte door gebruikers gevraagde herinneringen horen nog steeds bij Cron. Zie Afgeleide toezeggingen.

Task Flow

Task Flow is de floworkestratielaag boven achtergrondtaken. Het beheert duurzame meertraps flows met beheerde en gespiegelde synchronisatiemodi, revisietracking en openclaw tasks flow list|show|cancel voor inspectie. Zie Task Flow.

Vaste instructies

Vaste instructies geven de agent permanente uitvoeringsbevoegdheid voor gedefinieerde programma’s. Ze staan in werkruimtebestanden (meestal AGENTS.md) en worden in elke sessie geïnjecteerd. Combineer met Cron voor tijdgebaseerde handhaving. Zie Vaste instructies.

Hooks

Interne hooks zijn eventgestuurde scripts die worden getriggerd door lifecycle-events van de agent (/new, /reset, /stop), sessie-Compaction, het opstarten van de Gateway en bericht- flow. Ze worden automatisch ontdekt vanuit mappen en kunnen worden beheerd met openclaw hooks. Gebruik voor onderschepping van toolaanroepen binnen het proces Plugin hooks. Zie Hooks.

Heartbeat

Heartbeat is een periodieke hoofdsessiebeurt (standaard elke 30 minuten). Het bundelt meerdere controles (inbox, agenda, meldingen) in één agentbeurt met volledige sessiecontext. Heartbeat-beurten maken geen taakrecords aan en verlengen de versheid voor dagelijkse/inactieve sessieresets niet. Gebruik HEARTBEAT.md voor een kleine checklist, of een tasks:-blok wanneer je periodieke controles die alleen bij vervaldatum lopen binnen Heartbeat zelf wilt. Lege Heartbeat-bestanden worden overgeslagen als empty-heartbeat-file; modus voor alleen vervallen taken wordt overgeslagen als no-tasks-due. Heartbeats worden uitgesteld terwijl cronwerk actief is of in de wachtrij staat, en heartbeat.skipWhenBusy kan ze ook uitstellen terwijl subagent- of geneste lanes bezig zijn. Zie Heartbeat.

Hoe ze samenwerken

  • Cron verwerkt precieze planningen (dagelijkse rapporten, wekelijkse reviews) en eenmalige herinneringen. Alle cronuitvoeringen maken taakrecords aan.
  • Heartbeat verwerkt routinematige monitoring (inbox, agenda, meldingen) in één gebundelde beurt elke 30 minuten.
  • Hooks reageren op specifieke events (sessieresets, Compaction, berichtenflow) met aangepaste scripts. Plugin hooks dekken toolaanroepen.
  • Vaste instructies geven de agent persistente context en bevoegdheidsgrenzen.
  • Task Flow coördineert meertraps flows boven individuele taken.
  • Taken volgen automatisch al het losgekoppelde werk zodat je het kunt inspecteren en auditen.

Gerelateerd