निर्धारित कार्य

Cron Gateway का अंतर्निहित scheduler है। यह jobs को persist करता है, सही समय पर agent को जगाता है, और output को वापस chat channel या Webhook endpoint तक पहुंचा सकता है।

तुरंत शुरू करें

openclaw cron create "2026-02-01T16:00:00Z" \  --name "Reminder" \  --session main \  --system-event "Reminder: check the cron docs draft" \  --wake now \  --delete-after-run

openclaw cron listopenclaw cron get <job-id>openclaw cron show <job-id>

openclaw cron runs --id <job-id>

cron कैसे काम करता है

• Cron Gateway के अंदर process में चलता है (model के अंदर नहीं)।
• Job definitions, runtime state, और run history OpenClaw के shared SQLite state database में persist होते हैं, इसलिए restarts schedules नहीं खोते।
• upgrade पर, legacy ~/.openclaw/cron/jobs.json, jobs-state.json, और runs/*.jsonl files को SQLite में import करने और उन्हें .migrated suffix के साथ rename करने के लिए openclaw doctor --fix चलाएं। Malformed job rows runtime से skip किए जाते हैं और बाद की repair या review के लिए jobs-quarantine.json में copy किए जाते हैं।
• cron.store अभी भी logical cron store key और doctor import path का नाम देता है। import के बाद, उस JSON file को edit करने से active cron jobs नहीं बदलते; इसके बजाय openclaw cron add|edit|remove या Gateway cron RPC methods का उपयोग करें।
• सभी cron executions background task records बनाते हैं।
• Gateway startup पर, overdue isolated agent-turn jobs को तुरंत replay करने के बजाय channel-connect window से बाहर reschedule किया जाता है, ताकि restarts के बाद Discord/Telegram startup और native-command setup responsive रहें।
• One-shot jobs (--at) default रूप से success के बाद auto-delete होते हैं।
• Isolated cron runs अपनी cron:<jobId> session के लिए tracked browser tabs/processes को run पूरा होने पर best-effort close करते हैं, ताकि detached browser automation orphaned processes पीछे न छोड़े।
• Isolated cron runs जिन्हें narrow cron self-cleanup grant मिलता है, फिर भी scheduler status, अपने current job की self-filtered list, और उस job की run history पढ़ सकते हैं, ताकि status/Heartbeat checks व्यापक cron mutation access पाए बिना अपनी schedule inspect कर सकें।
• Isolated cron runs stale acknowledgement replies से भी guard करते हैं। अगर पहला result केवल interim status update (on it, pulling everything together, और समान hints) है और कोई descendant subagent run final answer के लिए अब भी जिम्मेदार नहीं है, तो OpenClaw delivery से पहले actual result के लिए एक बार re-prompt करता है।
• Isolated cron runs embedded run से structured execution-denial metadata का उपयोग करते हैं, जिसमें node-host UNAVAILABLE wrappers शामिल हैं जिनका nested error message SYSTEM_RUN_DENIED या INVALID_REQUEST से शुरू होता है, ताकि blocked command को green run के रूप में report न किया जाए जबकि ordinary assistant prose को denial न माना जाए।
• Isolated cron runs run-level agent failures को भी job errors मानते हैं, भले ही कोई reply payload produce न हो, ताकि model/provider failures error counters increment करें और job को successful clear करने के बजाय failure notifications trigger करें।
• जब isolated agent-turn job timeoutSeconds तक पहुंचता है, cron underlying agent run को abort करता है और उसे छोटी cleanup window देता है। अगर run drain नहीं होता, तो Gateway-owned cleanup उस run की session ownership को force-clear करता है, फिर cron timeout record करता है, ताकि queued chat work stale processing session के पीछे न छूटे।
• अगर isolated agent-turn runner start होने से पहले या first model call से पहले stall हो जाता है, तो cron phase-specific timeout record करता है, जैसे setup timed out before runner start या stalled before first model call (last phase: context-engine)। ये watchdogs embedded providers और CLI-backed providers को उनके external CLI process के वास्तव में start होने से पहले cover करते हैं, और long timeoutSeconds values से independently capped होते हैं ताकि cold-start/auth/context failures full job budget की प्रतीक्षा करने के बजाय जल्दी surface हों।
• अगर आप openclaw agent चलाने के लिए system cron या कोई अन्य external scheduler उपयोग करते हैं, तो CLI के SIGTERM/SIGINT handle करने के बावजूद उसे hard-kill escalation के साथ wrap करें। Gateway-backed runs accepted runs को abort करने के लिए Gateway से कहते हैं; local और embedded fallback runs को वही abort signal मिलता है। GNU timeout के लिए plain timeout 600 ... के बजाय timeout -k 60 600 openclaw agent ... prefer करें; -k value supervisor backstop है अगर process drain नहीं हो पाता। systemd units के लिए, final kill से पहले TimeoutStopSec जैसी grace window के साथ SIGTERM stop signal का उपयोग करके वही shape रखें। अगर retry वही --run-id reuse करता है जबकि original Gateway run अभी भी active है, तो duplicate second run start करने के बजाय in-flight के रूप में report होता है।

Schedule types

timezone के बिना timestamps को UTC माना जाता है। local wall-clock scheduling के लिए --tz America/New_York जोड़ें।

Recurring top-of-hour expressions load spikes घटाने के लिए automatically 5 minutes तक stagger किए जाते हैं। precise timing force करने के लिए --exact या explicit window के लिए --stagger 30s उपयोग करें।

Day-of-month और day-of-week OR logic का उपयोग करते हैं

Cron expressions croner द्वारा parse किए जाते हैं। जब day-of-month और day-of-week दोनों fields non-wildcard होते हैं, croner तब match करता है जब कोई भी field match हो — दोनों नहीं। यह standard Vixie cron behavior है।

# Intended: "9 AM on the 15th, only if it's a Monday"# Actual:   "9 AM on every 15th, AND 9 AM on every Monday"0 9 15 * 1

यह प्रति month 0–1 बार के बजाय ~5–6 बार fire होता है। OpenClaw यहां Croner के default OR behavior का उपयोग करता है। दोनों conditions require करने के लिए, Croner का + day-of-week modifier (0 9 15 * +1) उपयोग करें या एक field पर schedule करें और दूसरे को अपने job के prompt या command में guard करें।

Execution styles

Command payloads

Command payloads उन deterministic scripts के लिए उपयोग करें जिन्हें model-backed isolated agent turn start किए बिना Gateway scheduler के अंदर चलना चाहिए। Command jobs Gateway host पर execute होते हैं, stdout/stderr capture करते हैं, run को cron history में record करते हैं, और isolated jobs जैसे ही announce, webhook, और none delivery modes reuse करते हैं।

openclaw cron create "*/15 * * * *" \  --name "Queue depth probe" \  --command "scripts/check-queue.sh" \  --command-cwd "/srv/app" \  --announce \  --channel telegram \  --to "-1001234567890"

--command <shell> argv: ["sh", "-lc", <shell>] store करता है। जब आप shell parsing के बिना exact argv execution चाहते हैं, तो --command-argv '["node","scripts/report.mjs"]' उपयोग करें। Optional --command-env KEY=VALUE, --command-input, --timeout-seconds, --no-output-timeout-seconds, और --output-max-bytes fields process environment, stdin, और output bounds control करते हैं।

यदि stdout रिक्त नहीं है, तो वही पाठ वितरित परिणाम होता है। यदि stdout रिक्त है और stderr रिक्त नहीं है, तो stderr वितरित होता है। यदि दोनों स्ट्रीम मौजूद हैं, तो Cron एक छोटा stdout: / stderr: ब्लॉक वितरित करता है। शून्य एक्जिट कोड रन को ok के रूप में दर्ज करता है; गैर-शून्य एक्जिट, सिग्नल, टाइमआउट, या नो-आउटपुट टाइमआउट error दर्ज करता है और विफलता अलर्ट ट्रिगर कर सकता है। जो कमांड केवल NO_REPLY प्रिंट करता है, वह सामान्य Cron साइलेंट-टोकन सप्रेशन का उपयोग करता है और चैट में कुछ भी वापस पोस्ट नहीं करता।

आइसोलेटेड जॉब्स के लिए पेलोड विकल्प

--model चुने गए अनुमत model को उस जॉब के प्राथमिक model के रूप में उपयोग करता है। यह chat-session /model ओवरराइड जैसा नहीं है: जॉब प्राथमिक विफल होने पर भी कॉन्फ़िगर की गई fallback chains लागू होती हैं। यदि अनुरोधित model अनुमत नहीं है या resolve नहीं किया जा सकता, तो Cron जॉब के agent/default model चयन पर चुपचाप fallback करने के बजाय स्पष्ट validation error के साथ रन विफल करता है।

Cron jobs पेलोड-स्तर के fallbacks भी रख सकती हैं। मौजूद होने पर, वह सूची जॉब के लिए कॉन्फ़िगर की गई fallback chain को बदल देती है। जब आप ऐसा सख्त Cron रन चाहते हैं जो केवल चुने गए model को आज़माए, तो job payload/API में fallbacks: [] का उपयोग करें। यदि किसी जॉब में --model है लेकिन न तो पेलोड fallbacks हैं और न ही कॉन्फ़िगर किए गए fallbacks, तो OpenClaw एक स्पष्ट खाली fallback ओवरराइड पास करता है ताकि agent प्राथमिक को छिपे हुए अतिरिक्त retry target के रूप में न जोड़ा जाए।

Local-provider preflight checks किसी Cron रन को skipped चिह्नित करने से पहले कॉन्फ़िगर किए गए fallbacks पर चलते हैं; fallbacks: [] उस preflight path को सख्त रखता है।

आइसोलेटेड जॉब्स के लिए model-चयन प्राथमिकता है:

1. Gmail hook model ओवरराइड (जब रन Gmail से आया हो और वह ओवरराइड अनुमत हो)
2. प्रति-जॉब पेलोड model
3. उपयोगकर्ता द्वारा चुना गया संग्रहित Cron session model ओवरराइड
4. Agent/default model चयन

Fast mode भी resolved live चयन का अनुसरण करता है। यदि चुने गए model config में params.fastMode है, तो isolated Cron डिफ़ॉल्ट रूप से उसका उपयोग करता है। संग्रहित session fastMode ओवरराइड फिर भी config पर दोनों दिशाओं में प्राथमिकता रखता है। Auto mode, मौजूद होने पर, चुने गए model के params.fastAutoOnSeconds cutoff का उपयोग करता है, और डिफ़ॉल्ट 60 सेकंड होता है।

यदि isolated run किसी live model-switch handoff से टकराता है, तो Cron switched provider/model के साथ retry करता है और retry से पहले active run के लिए उस live selection को persist करता है। जब switch एक नया auth profile भी साथ लाता है, तो Cron active run के लिए उस auth profile override को भी persist करता है। Retries सीमित हैं: प्रारंभिक प्रयास और 2 switch retries के बाद, Cron अनंत loop करने के बजाय abort करता है।

किसी isolated Cron run के agent runner में प्रवेश करने से पहले, OpenClaw उन कॉन्फ़िगर किए गए api: "ollama" और api: "openai-completions" providers के reachable local provider endpoints की जांच करता है जिनका baseUrl loopback, private-network, या .local है। यदि वह endpoint down है, तो model call शुरू करने के बजाय रन को स्पष्ट provider/model error के साथ skipped के रूप में दर्ज किया जाता है। Endpoint result 5 मिनट के लिए cache होता है, इसलिए एक ही dead local Ollama, vLLM, SGLang, या LM Studio server का उपयोग करने वाली कई due jobs request storm बनाने के बजाय एक छोटा probe साझा करती हैं। Skipped provider-preflight runs execution-error backoff नहीं बढ़ाते; जब आप repeated skip notifications चाहते हैं, तो failureAlert.includeSkipped enable करें।

डिलीवरी और आउटपुट

Channel delivery के लिए --announce --channel telegram --to "-1001234567890" का उपयोग करें। Telegram forum topics के लिए, -1001234567890:topic:123 का उपयोग करें; OpenClaw Telegram-owned -1001234567890:123 shorthand भी स्वीकार करता है। Direct RPC/config callers delivery.threadId को string या number के रूप में पास कर सकते हैं। Slack/Discord/Mattermost targets को स्पष्ट prefixes (channel:<id>, user:<id>) का उपयोग करना चाहिए। Matrix room IDs case-sensitive हैं; Matrix से मिले exact room ID या room:!room:server form का उपयोग करें।

जब announce delivery channel: "last" का उपयोग करती है या channel छोड़ देती है, तो telegram:123 जैसा provider-prefixed target channel चुन सकता है, इससे पहले कि Cron session history या single configured channel पर fallback करे। केवल loaded plugin द्वारा advertised prefixes provider selectors होते हैं। यदि delivery.channel explicit है, तो target prefix को वही provider नामित करना होगा; उदाहरण के लिए, channel: "whatsapp" के साथ to: "telegram:123" को reject किया जाता है, बजाय इसके कि WhatsApp Telegram ID को phone number के रूप में interpret करे। Target-kind और service prefixes जैसे channel:<id>, user:<id>, imessage:<handle>, और sms:<number> channel-owned target syntax ही रहते हैं, provider selectors नहीं।

Isolated jobs के लिए, chat delivery साझा होती है। यदि chat route उपलब्ध है, तो agent message tool का उपयोग कर सकता है, भले ही job --no-deliver का उपयोग करे। यदि agent configured/current target को भेजता है, तो OpenClaw fallback announce छोड़ देता है। अन्यथा announce, webhook, और none केवल यह नियंत्रित करते हैं कि agent turn के बाद runner final reply के साथ क्या करता है।

जब कोई agent active chat से isolated reminder बनाता है, तो OpenClaw fallback announce route के लिए preserved live delivery target संग्रहीत करता है। Internal session keys lowercase हो सकती हैं; current chat context उपलब्ध होने पर provider delivery targets उन keys से reconstructed नहीं किए जाते।

Implicit announce delivery stale targets को validate और reroute करने के लिए configured channel allowlists का उपयोग करती है। DM pairing-store approvals fallback automation recipients नहीं हैं; जब scheduled job को proactive रूप से DM पर भेजना हो, तो delivery.to सेट करें या channel allowFrom entry configure करें।

आउटपुट भाषा

Cron jobs channel, locale, या पिछले messages से reply language infer नहीं करतीं। Scheduled message या template में language rule डालें:

openclaw cron edit <jobId> \  --message "Summarize the updates. Respond in Chinese; keep URLs, code, and product names unchanged."

Template files के लिए, language instruction को rendered prompt में रखें और job चलने से पहले verify करें कि {{language}} जैसे placeholders भरे गए हैं। यदि output languages मिलाता है, तो rule explicit करें, उदाहरण के लिए: "Use Chinese for narrative text and keep technical terms in English."

Failure notifications एक अलग destination path का पालन करती हैं:

• cron.failureDestination failure notifications के लिए global default सेट करता है।
• job.delivery.failureDestination उसे प्रति job override करता है।
• यदि इनमें से कोई भी सेट नहीं है और job पहले से announce के माध्यम से deliver करती है, तो failure notifications अब उस primary announce target पर fallback करती हैं।
• delivery.failureDestination केवल sessionTarget="isolated" jobs पर समर्थित है, जब तक primary delivery mode webhook न हो।
• failureAlert.includeSkipped: true किसी job या global Cron alert policy को repeated skipped-run alerts में opt करता है। Skipped runs अलग consecutive skip counter रखते हैं, इसलिए वे execution-error backoff को प्रभावित नहीं करते।

CLI उदाहरण

openclaw cron add \  --name "Calendar check" \  --at "20m" \  --session main \  --system-event "Next heartbeat: check calendar." \  --wake now

openclaw cron create "0 7 * * *" \  "Summarize overnight updates." \  --name "Morning brief" \  --tz "America/Los_Angeles" \  --session isolated \  --announce \  --channel slack \  --to "channel:C1234567890"

openclaw cron add \  --name "Deep analysis" \  --cron "0 6 * * 1" \  --tz "America/Los_Angeles" \  --session isolated \  --message "Weekly deep analysis of project progress." \  --model "opus" \  --thinking high \  --announce

openclaw cron create "0 18 * * 1-5" \  "Summarize today's deploys as JSON." \  --name "Deploy digest" \  --webhook "https://example.invalid/openclaw/cron"

openclaw cron create "*/15 * * * *" \  --name "Queue depth probe" \  --command "scripts/check-queue.sh" \  --command-cwd "/srv/app" \  --announce \  --channel telegram \  --to "-1001234567890"

Webhooks

Gateway बाहरी triggers के लिए HTTP webhook endpoints expose कर सकता है। Config में enable करें:

{  hooks: {    enabled: true,    token: "shared-secret",    path: "/hooks",  },}

प्रमाणीकरण

हर request में header के माध्यम से hook token शामिल होना चाहिए:

• Authorization: Bearer <token> (अनुशंसित)
• x-openclaw-token: <token>

Query-string tokens reject किए जाते हैं।

curl -X POST http://127.0.0.1:18789/hooks/wake \  -H 'Authorization: Bearer SECRET' \  -H 'Content-Type: application/json' \  -d '{"text":"New email received","mode":"now"}'

curl -X POST http://127.0.0.1:18789/hooks/agent \  -H 'Authorization: Bearer SECRET' \  -H 'Content-Type: application/json' \  -d '{"message":"Summarize inbox","name":"Email","model":"openai/gpt-5.4"}'

Gmail PubSub इंटीग्रेशन

Gmail इनबॉक्स ट्रिगर्स को Google PubSub के माध्यम से OpenClaw से जोड़ें.

विज़ार्ड सेटअप (अनुशंसित)

openclaw webhooks gmail setup --account openclaw@gmail.com

यह hooks.gmail कॉन्फ़िग लिखता है, Gmail preset सक्षम करता है, और push endpoint के लिए Tailscale Funnel का उपयोग करता है.

Gateway ऑटो-स्टार्ट

जब hooks.enabled=true हो और hooks.gmail.account सेट हो, तो Gateway बूट पर gog gmail watch serve शुरू करता है और watch को अपने-आप नवीनीकृत करता है. इससे बाहर रहने के लिए OPENCLAW_SKIP_GMAIL_WATCHER=1 सेट करें.

मैनुअल एक-बार का सेटअप

gcloud auth logingcloud config set project <project-id>gcloud services enable gmail.googleapis.com pubsub.googleapis.com

gcloud pubsub topics create gog-gmail-watchgcloud pubsub topics add-iam-policy-binding gog-gmail-watch \  --member=serviceAccount:gmail-api-push@system.gserviceaccount.com \  --role=roles/pubsub.publisher

gog gmail watch start \  --account openclaw@gmail.com \  --label INBOX \  --topic projects/<project-id>/topics/gog-gmail-watch

Gmail मॉडल ओवरराइड

{  hooks: {    gmail: {      model: "openrouter/meta-llama/llama-3.3-70b-instruct:free",      thinking: "off",    },  },}

जॉब्स प्रबंधित करना

# List all jobsopenclaw cron list # Get one stored job as JSONopenclaw cron get <jobId> # Show one job, including resolved delivery routeopenclaw cron show <jobId> # Edit a jobopenclaw cron edit <jobId> --message "Updated prompt" --model "opus" # Force run a job nowopenclaw cron run <jobId> # Force run a job now and wait for its terminal statusopenclaw cron run <jobId> --wait --wait-timeout 10m --poll-interval 2s # Run only if dueopenclaw cron run <jobId> --due # View run historyopenclaw cron runs --id <jobId> --limit 50 # View one exact runopenclaw cron runs --id <jobId> --run-id <runId> # Delete a jobopenclaw cron remove <jobId> # Agent selection (multi-agent setups)openclaw cron create "0 6 * * *" "Check ops queue" --name "Ops sweep" --session isolated --agent opsopenclaw cron edit <jobId> --clear-agent

openclaw cron run <jobId> मैनुअल run को enqueue करने के बाद लौटता है. shutdown hooks, maintenance scripts, या ऐसी अन्य automation के लिए --wait का उपयोग करें जिन्हें queued run पूरा होने तक block करना आवश्यक है. Wait mode ठीक लौटाए गए runId को poll करता है; यह status ok के लिए 0 और error, skipped, या wait timeout के लिए non-zero के साथ exit करता है.

एजेंट cron tool cron(action: "list") से संक्षिप्त job summaries (id, name, enabled, nextRunAtMs, scheduleKind, lastRunStatus) लौटाता है; एक पूर्ण job definition के लिए cron(action: "get", jobId: "...") का उपयोग करें. Direct Gateway callers cron.list को compact: true pass कर सकते हैं; इसे छोड़ने पर delivery previews के साथ मौजूदा full response सुरक्षित रहता है.

openclaw cron create, openclaw cron add का alias है, और नए jobs positional schedule ("0 9 * * 1", "every 1h", "20m", या ISO timestamp) के बाद positional agent prompt का उपयोग कर सकते हैं. finished run payload को HTTP endpoint पर POST करने के लिए cron add|create या cron edit पर --webhook <url> का उपयोग करें. Webhook delivery को --announce, --channel, --to, --thread-id, या --account जैसे chat delivery flags के साथ जोड़ा नहीं जा सकता. cron edit पर, --clear-channel, --clear-to, --clear-thread-id, और --clear-account उन routing fields को अलग-अलग unset करते हैं (प्रत्येक अपने matching set flag के साथ reject होता है), जो --no-deliver द्वारा runner fallback delivery disabled करने से अलग है.

कॉन्फ़िगरेशन

{  cron: {    enabled: true,    store: "~/.openclaw/cron/jobs.json",    maxConcurrentRuns: 8,    retry: {      maxAttempts: 3,      backoffMs: [60000, 120000, 300000],      retryOn: ["rate_limit", "overloaded", "network", "server_error"],    },    webhookToken: "replace-with-dedicated-webhook-token",    sessionRetention: "24h",    runLog: { maxBytes: "2mb", keepLines: 2000 },  },}

maxConcurrentRuns scheduled cron dispatch और isolated agent-turn execution दोनों को limit करता है, और default 8 है. Isolated cron agent turns internally queue की dedicated cron-nested execution lane का उपयोग करते हैं, इसलिए इस value को बढ़ाने से independent cron LLM runs केवल अपने outer cron wrappers शुरू करने के बजाय parallel में progress कर सकते हैं. shared non-cron nested lane इस setting से widened नहीं होती.

cron.store एक logical store key और legacy doctor import path है. मौजूदा JSON stores को SQLite में import और archive करने के लिए openclaw doctor --fix चलाएँ; भविष्य के cron changes CLI या Gateway API से होने चाहिए.

cron disabled करें: cron.enabled: false या OPENCLAW_SKIP_CRON=1.

समस्या निवारण

कमांड सीढ़ी

openclaw statusopenclaw gateway statusopenclaw cron statusopenclaw cron listopenclaw cron runs --id <jobId> --limit 20openclaw system heartbeat lastopenclaw logs --followopenclaw doctor

संबंधित

• Automation — सभी automation mechanisms एक नज़र में
• Background Tasks — cron executions के लिए task ledger
• Heartbeat — periodic main-session turns
• Timezone — timezone configuration