Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw cron
Beheer cron-taken voor de Gateway-planner.
Sessies
--session accepteert main, isolated, current of session:<id>.
Sessiesleutels
Sessiesleutels
mainkoppelt aan de hoofdsessie van de agent.isolatedmaakt voor elke uitvoering een nieuw transcript en sessie-id.currentkoppelt aan de actieve sessie op het moment van aanmaken.session:<id>zet vast op een expliciete persistente sessiesleutel.
Semantiek van geïsoleerde sessies
Semantiek van geïsoleerde sessies
Geïsoleerde uitvoeringen resetten de omgevingscontext van het gesprek. Kanaal- en groepsroutering, verzend-/wachtrijbeleid, elevatie, oorsprong en ACP-runtimebinding worden gereset voor de nieuwe uitvoering. Veilige voorkeuren en expliciete, door de gebruiker geselecteerde model- of auth-overschrijvingen kunnen worden meegenomen tussen uitvoeringen.
Levering
openclaw cron list en openclaw cron show <job-id> tonen vooraf de opgeloste leveringsroute. Voor channel: "last" laat de preview zien of de route is opgelost vanuit de hoofd- of huidige sessie, of gesloten zal mislukken.
Doelen met providerprefix kunnen onopgeloste aankondigingskanalen ondubbelzinnig maken. Bijvoorbeeld: to: "telegram:123" selecteert Telegram wanneer delivery.channel is weggelaten of last is. Alleen prefixes die door de geladen plugin worden geadverteerd, zijn providerselectoren. Als delivery.channel expliciet is, moet de prefix overeenkomen met dat kanaal; channel: "whatsapp" met to: "telegram:123" wordt geweigerd. Serviceprefixes zoals imessage: en sms: blijven kanaaleigen doelsyntaxis.
Geïsoleerde
cron add-taken gebruiken standaard --announce-levering. Gebruik --no-deliver om uitvoer intern te houden. --deliver blijft bestaan als verouderd alias voor --announce.Eigenaarschap van levering
Chatlevering voor geïsoleerde Cron wordt gedeeld tussen de agent en de uitvoerder:- De agent kan rechtstreeks verzenden met de
message-tool wanneer er een chatroute beschikbaar is. announcelevert de uiteindelijke reactie alleen als fallback wanneer de agent niet rechtstreeks naar het opgeloste doel heeft verzonden.webhookplaatst de voltooide payload op een URL.noneschakelt fallbacklevering door de uitvoerder uit.
--announce is fallbacklevering door de uitvoerder voor de uiteindelijke reactie. --no-deliver schakelt die fallback uit, maar verwijdert de message-tool van de agent niet wanneer er een chatroute beschikbaar is.
Herinneringen die vanuit een actieve chat worden gemaakt, behouden het live chatleveringsdoel voor fallback-aankondigingslevering. Interne sessiesleutels kunnen kleine letters zijn; gebruik ze niet als bron van waarheid voor hoofdlettergevoelige provider-ID’s zoals Matrix-ruimte-ID’s.
Levering bij fouten
Foutmeldingen worden in deze volgorde opgelost:delivery.failureDestinationop de taak.- Globale
cron.failureDestination. - Het primaire aankondigingsdoel van de taak (wanneer er geen expliciete foutbestemming is ingesteld).
Taken in de hoofdsessie mogen
delivery.failureDestination alleen gebruiken wanneer de primaire leveringsmodus webhook is. Geïsoleerde taken accepteren dit in alle modi.openclaw cron show
en openclaw cron runs een fasespecifieke fout zoals
setup timed out before runner start of
stalled before first model call (last phase: context-engine).
Voor CLI-ondersteunde providers blijft de watchdog vóór het model actief totdat de externe
CLI-beurt start, zodat vastlopers bij sessieopzoeking, hook, auth, prompt en CLI-installatie
worden gerapporteerd als Cron-fouten vóór het model.
Planning
Eenmalige taken
--at <datetime> plant een eenmalige uitvoering. Datums en tijden zonder offset worden behandeld als UTC, tenzij je ook --tz <iana> meegeeft; dan wordt de wandkloktijd in de opgegeven tijdzone geïnterpreteerd.
Eenmalige taken worden standaard na succes verwijderd. Gebruik
--keep-after-run om ze te bewaren.Terugkerende taken
Terugkerende taken gebruiken exponentiële retry-backoff na opeenvolgende fouten: 30s, 1m, 5m, 15m, 60m. De planning keert terug naar normaal na de volgende succesvolle uitvoering. Overgeslagen uitvoeringen worden apart bijgehouden van uitvoeringsfouten. Ze beïnvloeden de retry-backoff niet, maaropenclaw cron edit <job-id> --failure-alert-include-skipped kan foutmeldingen laten deelnemen aan herhaalde meldingen voor overgeslagen uitvoeringen.
Voor geïsoleerde taken die gericht zijn op een lokaal geconfigureerde modelprovider, voert Cron een lichte providerpreflight uit voordat de agentbeurt wordt gestart. Loopback-, privénetwerk- en .local api: "ollama"-providers worden geprobed op /api/tags; lokale OpenAI-compatibele providers zoals vLLM, SGLang en LM Studio worden geprobed op /models. Als het endpoint onbereikbaar is, wordt de uitvoering geregistreerd als skipped en later opnieuw geprobeerd volgens de planning; overeenkomende dode endpoints worden 5 minuten gecachet om te voorkomen dat veel taken dezelfde lokale server bestoken.
Opmerking: Cron-taakdefinities staan in jobs.json, terwijl de wachtende runtimestatus in jobs-state.json staat. Als jobs.json extern wordt bewerkt, laadt de Gateway gewijzigde planningen opnieuw en wist verouderde wachtende slots; herschrijvingen die alleen de opmaak wijzigen, wissen het wachtende slot niet.
Handmatige uitvoeringen
openclaw cron run keert terug zodra de handmatige uitvoering in de wachtrij staat. Succesvolle reacties bevatten { ok: true, enqueued: true, runId }. Gebruik openclaw cron runs --id <job-id> om de uiteindelijke uitkomst te volgen.
openclaw cron run <job-id> forceert standaard een uitvoering. Gebruik --due om het oudere gedrag “alleen uitvoeren als de taak verschuldigd is” te behouden.Modellen
cron add|edit --model <ref> selecteert een toegestaan model voor de taak.
Cron --model is een primaire taakinstelling, geen /model-overschrijving voor een chatsessie. Dat betekent:
- Geconfigureerde model-fallbacks blijven gelden wanneer het geselecteerde taakmodel mislukt.
- Per-taak-payload
fallbacksvervangt de geconfigureerde fallbacklijst wanneer aanwezig. - Een lege fallbacklijst per taak (
fallbacks: []in de taakpayload/API) maakt de Cron-uitvoering strikt. - Wanneer een taak
--modelheeft maar er geen fallbacklijst is geconfigureerd, geeft OpenClaw een expliciete lege fallbackoverschrijving door, zodat de primaire agent niet als verborgen retry-doel wordt toegevoegd.
Modelprioriteit voor geïsoleerde Cron
Geïsoleerde Cron lost het actieve model in deze volgorde op:- Gmail-hookoverschrijving.
- Per-taak
--model. - Opgeslagen modeloverschrijving voor de Cron-sessie (wanneer de gebruiker er een heeft geselecteerd).
- Agent- of standaard modelselectie.
Snelle modus
De snelle modus van geïsoleerde Cron volgt de opgeloste live modelselectie. Modelconfiguratieparams.fastMode is standaard van toepassing, maar een opgeslagen sessieoverschrijving fastMode wint nog steeds van configuratie.
Retries bij live modelwissels
Als een geïsoleerde uitvoeringLiveSessionModelSwitchError gooit, bewaart Cron de gewisselde provider en het model (en de gewisselde auth-profieloverschrijving wanneer aanwezig) voor de actieve uitvoering voordat opnieuw wordt geprobeerd. De buitenste retry-lus is begrensd op twee wisselretries na de eerste poging en breekt daarna af in plaats van eindeloos te blijven lopen.
Uitvoer van uitvoeringen en weigeringen
Onderdrukking van verouderde bevestigingen
Geïsoleerde Cron-beurten onderdrukken verouderde antwoorden die alleen uit een bevestiging bestaan. Als het eerste resultaat slechts een tussentijdse statusupdate is en er geen afgeleide subagent-uitvoering verantwoordelijk is voor het uiteindelijke antwoord, prompt Cron eenmaal opnieuw om het echte resultaat vóór levering.Onderdrukking van stille tokens
Als een geïsoleerde Cron-uitvoering alleen het stille token (NO_REPLY of no_reply) teruggeeft, onderdrukt Cron zowel directe uitgaande levering als het fallbackpad met samenvatting in de wachtrij, zodat er niets terug naar de chat wordt geplaatst.
Gestructureerde weigeringen
Geïsoleerde Cron-uitvoeringen geven de voorkeur aan gestructureerde metadata voor uitvoeringsweigering uit de ingebedde uitvoering en vallen daarna terug op bekende weigeringsmarkeringen in de uiteindelijke uitvoer, zoalsSYSTEM_RUN_DENIED, INVALID_REQUEST en zinnen voor weigering van goedkeuringsbinding.
cron list en uitvoeringsgeschiedenis tonen de weigeringsreden in plaats van een geblokkeerde opdracht als ok te rapporteren.
Bewaring
Bewaring en opruiming worden in de configuratie geregeld:cron.sessionRetention(standaard24h) ruimt voltooide geïsoleerde uitvoeringssessies op.cron.runLog.maxBytesencron.runLog.keepLinesruimen~/.openclaw/cron/runs/<jobId>.jsonlop.
Oudere taken migreren
Als je Cron-taken hebt van vóór de huidige leverings- en opslagindeling, voer dan
openclaw doctor --fix uit. Doctor normaliseert legacy Cron-velden (jobId, schedule.cron, leveringsvelden op topniveau inclusief legacy threadId, payload-provider-leveringsaliassen) en migreert eenvoudige notify: true-webhookfallbacktaken naar expliciete webhooklevering wanneer cron.webhook is geconfigureerd.Veelvoorkomende bewerkingen
Werk leveringsinstellingen bij zonder het bericht te wijzigen:--light-context is alleen van toepassing op geïsoleerde agentbeurttaken. Voor Cron-uitvoeringen houdt de lichte modus de bootstrapcontext leeg in plaats van de volledige bootstrapset van de werkruimte te injecteren.
Veelvoorkomende beheerdersopdrachten
Handmatige uitvoering en inspectie:openclaw cron list toont standaard alle overeenkomende taken. Geef --agent <id> mee om alleen taken te tonen waarvan de effectieve genormaliseerde agent-id overeenkomt; taken zonder opgeslagen agent-id tellen als de geconfigureerde standaardagent.
openclaw cron get <job-id> geeft de opgeslagen taak-JSON rechtstreeks terug. Gebruik cron show <job-id> wanneer je de menselijk leesbare weergave met preview van de leveringsroute wilt.
cron list --json en cron show <job-id> --json bevatten een top-level status-veld op elke taak, berekend uit enabled, state.runningAtMs en state.lastRunStatus. Waarden: disabled, running, ok, error, skipped of idle. Dit weerspiegelt de menselijk leesbare statuskolom, zodat externe tooling de taakstatus kan lezen zonder die opnieuw af te leiden.
Vermeldingen van cron runs bevatten leveringsdiagnostiek met het beoogde Cron-doel, het opgeloste doel, verzendingen via message-tool, fallbackgebruik en geleverde status.
Agent- en sessieherroutering:
openclaw cron add waarschuwt wanneer --agent wordt weggelaten bij agentbeurttaken en valt terug op de standaardagent (main). Geef --agent <id> mee bij het aanmaken om een specifieke agent vast te zetten.
Leveringsaanpassingen: