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

Cron, Gateway का अंतर्निहित शेड्यूलर है। यह जॉब को स्थायी रखता है, सही समय पर एजेंट को सक्रिय करता है, और आउटपुट को किसी चैट चैनल, Webhook या कहीं भी नहीं भेज सकता है।

त्वरित शुरुआत

openclaw cron create "2027-02-01T16:00:00Z" \  --name "रिमाइंडर" \  --session main \  --system-event "रिमाइंडर: Cron दस्तावेज़ों का मसौदा जाँचें" \  --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 प्रक्रिया के भीतर चलता है। शेड्यूल सक्रिय होने के लिए Gateway का चालू होना आवश्यक है।
• जॉब परिभाषाएँ, रनटाइम स्थिति और रन इतिहास OpenClaw के साझा SQLite स्थिति डेटाबेस में स्थायी रहते हैं, इसलिए पुनः प्रारंभ करने पर शेड्यूल नष्ट नहीं होते।
• Cron का प्रत्येक निष्पादन एक बैकग्राउंड टास्क रिकॉर्ड बनाता है।
• एक बार चलने वाले जॉब (--at) सफल होने के बाद डिफ़ॉल्ट रूप से अपने-आप हट जाते हैं; उन्हें बनाए रखने के लिए --keep-after-run पास करें।
• प्रति-रन वास्तविक समय बजट: सेट होने पर --timeout-seconds। अन्यथा, अलग-थलग/डिटैच किए गए एजेंट-टर्न जॉब पर अंतर्निहित एजेंट-टर्न टाइमआउट (agents.defaults.timeoutSeconds, डिफ़ॉल्ट 48 घंटे) लागू होने से पहले Cron का अपना 60-मिनट का वॉचडॉग सीमा लगाता है; कमांड जॉब का डिफ़ॉल्ट 10 मिनट और स्क्रिप्ट पेलोड का डिफ़ॉल्ट 5 मिनट है।
• Gateway के प्रारंभ होने पर, समय से चूक चुके अलग-थलग एजेंट-टर्न जॉब तुरंत दोहराए जाने के बजाय पुनः शेड्यूल किए जाते हैं, जिससे मॉडल/टूल बूटस्ट्रैप कार्य चैनल-कनेक्ट अवधि से बाहर रहता है।
• यदि आप सिस्टम Cron या किसी अन्य बाहरी शेड्यूलर से openclaw agent चलाते हैं, तो इसे हार्ड-किल एस्केलेशन से रैप करें, भले ही CLI पहले से SIGTERM/SIGINT को संभालता हो। Gateway-समर्थित रन स्वीकार किए गए रन को निरस्त करने के लिए Gateway से अनुरोध करते हैं; --local रन को भी वही निरस्तीकरण संकेत मिलता है। GNU timeout के लिए, साधारण timeout 600 ... के बजाय timeout -k 60 600 openclaw agent ... को प्राथमिकता दें — यदि प्रक्रिया समय पर समाप्त नहीं हो पाती, तो -k मान अंतिम सुरक्षा उपाय है। systemd यूनिट के लिए, अंतिम किल से पहले अनुग्रह अवधि (TimeoutStopSec) के साथ SIGTERM स्टॉप संकेत का उपयोग करें। मूल Gateway रन के सक्रिय रहते हुए --run-id का पुनः उपयोग करने पर दूसरा रन प्रारंभ करने के बजाय डुप्लिकेट को प्रगतिरत बताया जाता है।

शेड्यूल के प्रकार

टाइमज़ोन के बिना टाइमस्टैम्प को UTC माना जाता है। ऑफ़सेट-रहित --at डेटटाइम को समझने या उस IANA टाइमज़ोन में Cron एक्सप्रेशन का मूल्यांकन करने के लिए --tz America/New_York जोड़ें। --tz के बिना Cron एक्सप्रेशन Gateway होस्ट के टाइमज़ोन का उपयोग करते हैं। --tz, --every या --on-exit के साथ मान्य नहीं है।

हर घंटे के आरंभ पर आवर्ती एक्सप्रेशन (वाइल्डकार्ड घंटा फ़ील्ड के साथ मिनट 0) लोड में अचानक वृद्धि कम करने के लिए अपने-आप अधिकतम 5 मिनट तक अलग-अलग समय पर चलाए जाते हैं। सटीक समय बाध्य करने के लिए --exact या स्पष्ट समय-सीमा के लिए --stagger 30s का उपयोग करें (केवल Cron शेड्यूल)।

Heartbeat टास्क माइग्रेशन

पुराने Heartbeat स्क्रैच में संरचित tasks: ब्लॉक समर्थित था। अपग्रेड करने के बाद प्रत्येक प्रविष्टि को सामान्य, संपादन योग्य मुख्य-सत्र Cron जॉब में बदलने के लिए openclaw doctor --fix चलाएँ। Doctor अंतराल और पिछली बार चलने का समय सुरक्षित रखता है, ब्लॉक हटाने से पहले जॉब बनाता है और पुनः चलाए जाने पर उन्हीं डिक्लेरेशन कुंजियों को सुरक्षित रूप से एकरूप करता है।

इन माइग्रेट किए गए जॉब में सार्वजनिक systemEvent पेलोड होते हैं, इसलिए openclaw cron list, get, edit और remove के साथ Cron टूल उन्हें अन्य जॉब की तरह प्रबंधित करते हैं। उनका निष्पादन सुरक्षित Heartbeat टास्क वेक का उपयोग करता है: सक्रिय घंटे, न्यूनतम अंतराल, फ़्लड नियंत्रण और व्यस्त होने पर पुनः प्रयास अब भी लागू होते हैं, जबकि Cron प्रत्येक टास्क की स्वतंत्र आवृत्ति का स्वामित्व रखता है। समान संयोजन अवधि में देय जॉब एक Heartbeat टर्न साझा कर सकते हैं। Heartbeat के सक्रिय घंटों के बाहर आने वाली निर्धारित घटना छोड़ दी जाती है और जॉब की अगली घटना पर पुनः प्रयास की जाती है।

Heartbeat स्क्रैच अब केवल निगरानी गद्य है। रनटाइम Heartbeat, tasks: टेक्स्ट को शेड्यूल के रूप में पार्स नहीं करते; नया आवर्ती कार्य Cron से बनाएँ।

स्ट्रीम स्रोत

स्ट्रीम शेड्यूल, ऑपरेटर द्वारा लिखे गए argv कमांड को Gateway के अंतर्गत चलाता रहता है और उसकी stdout तथा stderr पंक्तियों से जॉब सक्रिय करता है। स्ट्रीम शेड्यूल इवेंट-चालित होते हैं, कभी समय के आधार पर देय नहीं होते और इनके लिए cron.triggers.enabled: true आवश्यक है, क्योंकि लंबे समय तक चलने वाले कमांड का अप्रत्यक्ष विश्वास वर्ग ट्रिगर स्क्रिप्ट के समान होता है। जॉब को अक्षम करने या हटाने से प्रक्रिया रुक जाती है; Gateway शटडाउन प्रक्रिया-वृक्ष के टियरडाउन की प्रतीक्षा करता है। शीघ्र विफलताएँ Cron के अंतर्निहित त्रुटि बैकऑफ़ के साथ पुनः प्रारंभ होती हैं। 60 सेकंड से छोटे लगातार पाँच रन जॉब को त्रुटि स्थिति में छोड़ देते हैं और सामान्य विफलता-अलर्ट पथ का उपयोग करते हैं; पुनः प्रारंभ सीमा साफ़ करने के लिए जॉब को मैन्युअल रूप से फिर सक्षम करें।

openclaw cron add \  --name "बिल्ड इवेंट स्ट्रीम" \  --stream-command '["node","scripts/build-events.mjs"]' \  --stream-mode match \  --stream-match '^(failed|recovered):' \  --stream-batch-ms 250 \  --session isolated \  --message "इन बिल्ड इवेंट की जाँच करें।"

mode: "line" (डिफ़ॉल्ट) प्रत्येक पंक्ति स्वीकार करता है। mode: "match" केवल संकलित match रेगेक्स से मेल खाने वाली पंक्तियाँ स्वीकार करता है। बैच batchMs तक निष्क्रिय रहने के बाद (डिफ़ॉल्ट 250 ms, 50–5000 तक सीमित) या maxBatchBytes पर (डिफ़ॉल्ट 16384, 1024–65536 तक सीमित) बंद होता है। बाइट सीमा पर बैच [truncated] के साथ समाप्त होता है। मिलान मोड हमेशा पूर्ण पंक्तियों का उनके पूरे टेक्स्ट से मिलान करता है, यहाँ तक कि maxBatchBytes के बाद भी (केवल भेजा गया बैच काटा जाता है); सीमित रॉ-इनटेक सीमा पर कटी हुई पंक्ति केवल एक उपसर्ग होती है, इसलिए उसे बेमेल माना जाता है, ताकि अंत में एंकर किया गया पैटर्न कटे हुए टेक्स्ट पर सक्रिय न हो। बैच को सिस्टम-इवेंट टेक्स्ट या एजेंट-टर्न संदेश में जोड़ा जाता है। स्ट्रीम शेड्यूल के लिए कमांड पेलोड अस्वीकार किए जाते हैं, क्योंकि स्रोत कमांड और पेलोड कमांड की प्रक्रिया का स्वामित्व अस्पष्ट होगा।

प्रति जॉब केवल एक पेलोड सक्रियण और एक सीमित लंबित बैच रखा जाता है। पेलोड चलते समय या अंतर्निहित 30-सेकंड का ट्रिगर अंतराल बीतने से पहले आने वाली पंक्तियाँ असीमित कतार बनाने के बजाय उस लंबित बैच में संयोजित हो जाती हैं। एक क्रमबद्ध स्वामी गेट द्वारा छोड़े गए बैच, पेलोड त्रुटियाँ और न चलने वाली डिस्पैच को streamDroppedBatches में रिकॉर्ड करता है; सीमित मर्ज streamCoalescedBatches को बढ़ाते हैं। विफल पेलोड पर पुनः प्रयास नहीं किया जाता, क्योंकि वे आइडेम्पोटेंट न भी हों। पर्यवेक्षित चाइल्ड के पुनः प्रारंभ होने पर तार्किक स्रोत पहचान स्थिर रहती है, लेकिन स्रोत के अक्षम, हटाए या बदले जाने पर बदल जाती है, ताकि सेवानिवृत्त स्रोत के कतारबद्ध बैच A-से-B-से-A संपादन के बाद भी सक्रिय न हो सकें। स्टॉप पूर्ण होने के बाद पुराने चाइल्ड के देर से आए कॉलबैक निष्क्रिय रहते हैं। V1 में नेटिव WebSocket स्रोत शामिल नहीं है; इसे websocat wss://example.invalid/events जैसे argv कमांड से ब्रिज करें।

जब किसी स्ट्रीम जॉब में trigger.script भी होता है, तो गेट प्रत्येक बंद बैच के लिए एक बार चलता है। वर्तमान बैच trigger.state के साथ गहराई तक फ़्रीज़ की गई trigger.streamBatch स्ट्रिंग के रूप में उपलब्ध होता है। fire: false गेट स्थिति को स्थायी करने के बाद उस बैच को छोड़ देता है। fire: true मौजूदा ट्रिगर संदेश अर्थ को बनाए रखता है और फिर बैच को परिणामी पेलोड में जोड़ता है। इसके बजाय स्ट्रीम जॉब बिना कंडीशन गेट के स्क्रिप्ट पेलोड का उपयोग कर सकता है; उस स्क्रिप्ट को बैच उसी trigger.streamBatch मान से मिलता है। स्क्रिप्ट पेलोड को कंडीशन गेट के साथ संयोजित करना अस्वीकार किया जाता है, क्योंकि दोनों स्थायी trigger.state स्लॉट का स्वामित्व लेते।

गतिशील आवृत्ति (गति नियंत्रण)

आवर्ती जॉब pacing.min और/या pacing.max को 15m या 4h जैसी अवधि स्ट्रिंग पर सेट कर सकते हैं; कम-से-कम एक सीमा आवश्यक है। cron add|edit के साथ --pacing-min और --pacing-max का उपयोग करें (--clear-pacing दोनों सीमाएँ हटा देता है)।

एक पृथक रन के दौरान, गति-नियंत्रित जॉब action: "next_check" और in: "30m" के साथ cron टूल को कॉल कर सकता है। प्रस्ताव केवल उस समय चल रहे जॉब पर लागू होता है और सफल रन पूरा होने के समय से मापा जाता है। OpenClaw इसे कॉन्फ़िगर की गई सीमाओं तक चुपचाप सीमित कर देता है।

प्रस्ताव के बिना गति-नियंत्रण सामान्य शेड्यूल को अपरिवर्तित रखता है। विफल, टाइम-आउट और छोड़े गए रन प्रस्ताव को त्याग देते हैं, इसलिए मौजूदा पुनः प्रयास और त्रुटि-बैकऑफ़ व्यवहार को प्राथमिकता मिलती है। किसी आवर्ती जॉब को मैन्युअल रूप से बाध्य करना बैंड से बाहर होता है और उसके लंबित स्वाभाविक या गति-नियंत्रित स्लॉट को सुरक्षित रखता है। शर्त से ट्रिगर होने वाले जॉब के लिए, अंतर्निहित न्यूनतम अंतराल तब भी निचली सीमा बना रहता है, जब कोई प्रस्ताव पहले जाँचने का अनुरोध करता है।

महीने के दिन और सप्ताह के दिन में OR तर्क का उपयोग होता है

Cron एक्सप्रेशन croner द्वारा पार्स किए जाते हैं। जब महीने के दिन और सप्ताह के दिन, दोनों फ़ील्ड गैर-वाइल्डकार्ड हों, तो croner दोनों के बजाय किसी एक फ़ील्ड के मेल खाने पर मिलान करता है। यह मानक Vixie cron व्यवहार है।

# अपेक्षित: "15 तारीख को सुबह 9 बजे, केवल यदि सोमवार हो"# वास्तविक: "हर महीने की 15 तारीख को सुबह 9 बजे, और हर सोमवार को सुबह 9 बजे"0 9 15 * 1

यह महीने में 0-1 बार के बजाय लगभग 5-6 बार सक्रिय होता है। दोनों शर्तों को आवश्यक बनाने के लिए, croner के + सप्ताह-दिन संशोधक (0 9 15 * +1) का उपयोग करें, या एक फ़ील्ड पर शेड्यूल करें और दूसरे को अपने जॉब के प्रॉम्प्ट या कमांड में जाँचें।

इवेंट ट्रिगर (शर्त निगरानीकर्ता)

इवेंट ट्रिगर किसी every, cron, या stream शेड्यूल में हेडलेस शर्त स्क्रिप्ट जोड़ता है। समय शेड्यूल नियत समय पर इसका मूल्यांकन करते हैं; स्ट्रीम शेड्यूल प्रत्येक बंद बैच के लिए इसका मूल्यांकन करते हैं। Cron सामान्य पेलोड केवल तभी चलाता है, जब स्क्रिप्ट fire: true लौटाती है:

{  schedule: { kind: "every", everyMs: 30000 },  trigger: {    // केवल तभी सक्रिय होता है, जब देखी गई स्थिति पिछले मूल्यांकन से अलग हो।    script: "const res = await tools.call('exec', { command: 'gh pr checks 123 --json state -q \\'.[].state\\' | sort -u' }); const status = String(res?.result?.details?.aggregated ?? '').trim(); json({ fire: status !== trigger.state?.status, message: `PR 123 CI: ${trigger.state?.status ?? 'unknown'} -> ${status}`, state: { status } });",    once: false,  },  payload: { kind: "agentTurn", message: "CI स्थिति में हुए बदलाव की जाँच करें।" },}

स्क्रिप्ट को { fire, message?, state? } लौटाना आवश्यक है। पिछली JSON स्थिति अत्यधिक फ़्रीज़ किए गए trigger.state के रूप में उपलब्ध होती है; स्ट्रीम गेट को वर्तमान बैच भी trigger.streamBatch के रूप में मिलता है। इसे बनाए रखने के लिए नया state मान लौटाएँ। स्थिति 16 KB तक सीमित है। जब सक्रिय होने वाले परिणाम में message शामिल हो, तो cron निष्पादन से पहले इसे सिस्टम-इवेंट टेक्स्ट या एजेंट-टर्न संदेश में जोड़ देता है। once: true अपने पहले सफल सक्रिय पेलोड के बाद जॉब को अक्षम कर देता है।

fire: false मूल्यांकन स्थिति और काउंटर बनाए रखता है, फिर रन इतिहास बनाए बिना पुनः शेड्यूल करता है। यदि सक्रिय पेलोड रन विफल हो जाता है, तो लौटाया गया state बनाए नहीं रखा जाता — अगला मूल्यांकन पिछली स्थिति देखता है और फिर सक्रिय हो सकता है, इसलिए स्क्रिप्ट को केवल-पढ़ने वाली जाँच के रूप में लिखें और कार्रवाइयाँ पेलोड में रखें। ट्रिगर शेड्यूल में 30 सेकंड का अंतर्निहित न्यूनतम अंतराल होता है। प्रत्येक मूल्यांकन का वॉल-क्लॉक बजट 30 सेकंड और अधिकतम 5 टूल कॉल है।

निगरानीकर्ता केवल सफलता के बजाय कार्रवाई योग्य स्थिति के आधार पर बनाएँ: जो निगरानीकर्ता अपनी जाँच विफल होने या टाइम-आउट होने पर शांत हो जाता है, वह खराब होने के बावजूद स्वस्थ दिखता है। अवलोकन की तुलना trigger.state से करें और डुप्लिकेट हटाने के लिए नई स्थिति लौटाएँ; मॉडल या प्रक्रिया मेमोरी पर निर्भर न रहें। सक्रिय करते समय message को स्व-निहित बनाएँ, क्योंकि यह सक्रिय रन का संपूर्ण इवेंट संदर्भ बन जाता है।

स्थानीय स्क्रिप्ट फ़ाइल से निगरानीकर्ता बनाएँ (- stdin से स्क्रिप्ट पढ़ता है):

openclaw cron add \  --name "PR CI निगरानीकर्ता" \  --every 30s \  --trigger-script ./watch-pr-ci.js \  --message "CI स्थिति में हुए बदलाव पर प्रतिक्रिया दें" \  --session isolated

पेलोड

प्रत्येक जॉब में फ़्लैग द्वारा चुना गया ठीक एक पेलोड प्रकार होता है:

एक अतिरिक्त पेलोड प्रकार, heartbeat, सिस्टम के स्वामित्व में है: gateway प्रत्येक Heartbeat-सक्षम एजेंट के लिए एक Heartbeat मॉनिटर जॉब को अभिसरित करता है (Heartbeat देखें)। यह cron list --all में दिखाई देता है, लेकिन CLI या API के माध्यम से बनाया या संपादित नहीं किया जा सकता। Heartbeat कॉन्फ़िगरेशन स्टार्टअप पर, कॉन्फ़िगरेशन रीलोड पर, या openclaw doctor --fix द्वारा स्थायी मॉनिटर शेड्यूल में लिखा जाता है। जब cron अक्षम होता है, तो मॉनिटर टिक नहीं करता और कोई फ़ॉलबैक Heartbeat टाइमर नहीं चलता।

एजेंट-टर्न विकल्प

टूल चला सकने वाले नए जॉब हमेशा स्पष्ट टूल नीति संग्रहीत करते हैं। एजेंट द्वारा बनाए गए जॉब उन्हीं टूल तक सीमित होते हैं जो बनाने वाले टर्न के लिए उपलब्ध हैं, और एजेंट संग्रहीत सूची को विस्तृत नहीं कर सकता। --tools के बिना किसी प्रमाणित ऑपरेटर द्वारा बनाए गए जॉब एक अप्रतिबंधित * नीति संग्रहीत करते हैं; cron edit --clear-tools उस स्पष्ट अप्रतिबंधित नीति को पुनर्स्थापित करता है। स्पष्ट टूल नीति से पहले के मौजूदा जॉब अपना वर्तमान व्यवहार तब तक बनाए रखते हैं, जब तक उनकी टूल नीति स्पष्ट रूप से संपादित नहीं की जाती या जॉब दोबारा नहीं बनाया जाता।

--model जॉब का प्राथमिक मॉडल सेट करता है; यह सत्र के /model ओवरराइड को प्रतिस्थापित नहीं करता, इसलिए कॉन्फ़िगर की गई फ़ॉलबैक शृंखलाएँ इसके ऊपर लागू रहती हैं। किसी अनसुलझे या अस्वीकृत मॉडल के कारण रन डिफ़ॉल्ट पर चुपचाप फ़ॉलबैक होने के बजाय स्पष्ट सत्यापन त्रुटि के साथ विफल होता है। यदि किसी जॉब में --model है, लेकिन कोई स्पष्ट या कॉन्फ़िगर की गई फ़ॉलबैक सूची नहीं है, तो OpenClaw एजेंट के प्राथमिक मॉडल को छिपे हुए पुनः प्रयास लक्ष्य के रूप में चुपचाप जोड़ने के बजाय खाली फ़ॉलबैक ओवरराइड पास करता है।

पृथक जॉब के लिए मॉडल-चयन प्राथमिकता, उच्चतम पहले:

1. प्रति-जॉब पेलोड model (स्पष्ट कॉन्फ़िगरेशन; अस्वीकृत मॉडल रन को विफल करता है)
2. Gmail हुक मॉडल ओवरराइड (केवल जब रन Gmail से आया हो और वह ओवरराइड अनुमत हो)
3. उपयोगकर्ता द्वारा चयनित संग्रहीत cron-सत्र मॉडल ओवरराइड
4. एजेंट/डिफ़ॉल्ट मॉडल चयन

तेज़ मोड समाधान किए गए लाइव चयन का पालन करता है। यदि चयनित मॉडल कॉन्फ़िगरेशन में params.fastMode है, तो पृथक cron डिफ़ॉल्ट रूप से इसका उपयोग करता है; संग्रहीत सत्र fastMode ओवरराइड (फिर एजेंट fastModeDefault) अभी भी दोनों दिशाओं में मॉडल कॉन्फ़िगरेशन पर प्राथमिकता रखता है। ऑटो मोड मॉडल के params.fastAutoOnSeconds कटऑफ़ का उपयोग करता है, जिसका डिफ़ॉल्ट 60 सेकंड है।

यदि किसी रन में लाइव मॉडल-स्विच हैंडऑफ़ होता है, तो cron स्विच किए गए प्रदाता/मॉडल के साथ पुनः प्रयास करता है और सक्रिय रन के लिए उस चयन (और किसी नए प्रमाणीकरण प्रोफ़ाइल) को बनाए रखता है। पुनः प्रयास सीमित हैं: आरंभिक प्रयास और 2 स्विच पुनः प्रयासों के बाद, cron लूप जारी रखने के बजाय निरस्त कर देता है।

पृथक रन शुरू होने से पहले, OpenClaw कॉन्फ़िगर किए गए api: "ollama" और api: "openai-completions" प्रदाताओं के पहुँच योग्य स्थानीय एंडपॉइंट की जाँच करता है, जिनका baseUrl लूपबैक, निजी नेटवर्क, या .local है। यह पूर्व-जाँच जॉब की कॉन्फ़िगर की गई फ़ॉलबैक शृंखला को क्रमशः जाँचती है और केवल तभी रन को skipped चिह्नित करती है, जब प्रत्येक उम्मीदवार पहुँच से बाहर हो; --fallbacks "" इस जाँच को केवल प्राथमिक मॉडल तक सख्ती से सीमित रखता है। बंद एंडपॉइंट मॉडल कॉल शुरू करने के बजाय स्पष्ट त्रुटि के साथ रन को skipped के रूप में रिकॉर्ड करता है। परिणाम प्रति एंडपॉइंट 5 मिनट के लिए कैश किया जाता है (प्रति जॉब या मॉडल नहीं), इसलिए एक ही बंद स्थानीय Ollama/vLLM/SGLang/LM Studio सर्वर साझा करने वाले कई नियत जॉब अनुरोधों की बाढ़ के बजाय केवल एक जाँच की लागत उठाते हैं। छोड़े गए पूर्व-जाँच रन निष्पादन-त्रुटि बैकऑफ़ नहीं बढ़ाते; बार-बार छोड़े जाने की चेतावनियाँ पाने के लिए failureAlert.includeSkipped सेट करें।

कमांड पेलोड

कमांड पेलोड मॉडल-समर्थित टर्न शुरू किए बिना Gateway शेड्यूलर के अंदर नियतात्मक स्क्रिप्ट चलाते हैं। वे Gateway होस्ट पर निष्पादित होते हैं, stdout/stderr कैप्चर करते हैं, रन को cron इतिहास में रिकॉर्ड करते हैं और एजेंट-टर्न जॉब के समान announce, webhook, और none वितरण मोड का पुनः उपयोग करते हैं।

openclaw cron create "*/15 * * * *" \  --name "क्यू गहराई जाँच" \  --command "scripts/check-queue.sh" \  --command-cwd "/srv/app" \  --announce \  --channel telegram \  --to "-1001234567890"

--command <shell> argv: ["sh", "-lc", <shell>] को संग्रहीत करता है। शेल पार्सिंग के बिना सटीक argv निष्पादन के लिए --command-argv '["node","scripts/report.mjs"]' का उपयोग करें। वैकल्पिक --command-env KEY=VALUE (दोहराने योग्य), --command-input, --timeout-seconds (डिफ़ॉल्ट 10 मिनट), --no-output-timeout-seconds, और --output-max-bytes प्रक्रिया परिवेश, stdin और आउटपुट सीमाओं को नियंत्रित करते हैं।

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

स्क्रिप्ट पेलोड

स्क्रिप्ट पेलोड ट्रिगर स्क्रिप्ट के समान कोड-मोड एक्ज़ीक्यूटर में बिना संवादात्मक एजेंट टर्न शुरू किए हेडलेस रूप से चलते हैं। उन्हें बनाने या चलाने से पहले cron.triggers.enabled सक्षम करें; यह खतरनाक-ऑटोमेशन गेट ट्रिगर स्क्रिप्ट और स्क्रिप्ट पेलोड, दोनों पर लागू होता है। स्क्रिप्ट जॉब केवल main और isolated सेशन लक्ष्य समर्थित करते हैं।

openclaw cron create "0 * * * *" \  --name "प्रति घंटे क्यू की जाँच" \  --script ./automation/check-queue.js \  --script-timeout-seconds 300 \  --script-tool-budget 50 \  --session isolated \  --announce

किसी फ़ाइल या stdin से JavaScript पढ़ने के लिए --script <file|-> का उपयोग करें। टाइमआउट का डिफ़ॉल्ट मान 300 सेकंड है और इसकी अधिकतम सीमा 900 है; टूल बजट का डिफ़ॉल्ट मान 50 कॉल है और इसकी अधिकतम सीमा 200 है। ये पेलोड बजट छोटे ट्रिगर-गेट मूल्यांकन बजट से अलग हैं।

स्क्रिप्ट इन वैकल्पिक फ़ील्ड वाला ऑब्जेक्ट लौटा सकती है:

• notify: जॉब के announce, webhook, या none डिलीवरी मोड के माध्यम से भेजा गया टेक्स्ट। इसे छोड़ने पर कुछ भी डिलीवर नहीं होता। main जॉब के लिए टेक्स्ट एक सिस्टम इवेंट बन जाता है।
• wake: "now", notify (या संक्षिप्त पूर्णता इवेंट) को क्यू में डालने के बाद तत्काल Heartbeat का अनुरोध करता है; "next-heartbeat" इवेंट को अगले Heartbeat के लिए क्यू में डालता है।
• state: JSON स्थिति, जिसकी अधिकतम सीमा 16 KB है और जो केवल सफल रन के बाद स्थायी की जाती है। अगला रन ट्रिगर स्क्रिप्ट की तरह इसकी फ़्रीज़ की गई प्रति trigger.state के रूप में प्राप्त करता है। चूँकि उस नेमस्पेस का केवल एक स्थायी स्वामी होता है, इसलिए एक ही जॉब में स्क्रिप्ट पेलोड को कंडीशन ट्रिगर के साथ संयोजित नहीं किया जा सकता।
• nextCheck: "15m" जैसी अवधि। यह केवल उन जॉब के लिए मान्य है जिनमें पेसिंग सक्षम है और एजेंट-टर्न प्रस्तावों के समान पेसिंग क्लैंप का उपयोग करती है।

थ्रो, टाइमआउट, समाप्त हो चुके टूल बजट, अमान्य परिणाम, और पेसिंग के बिना nextCheck सामान्य Cron रन त्रुटियाँ हैं: वे लौटाई गई स्थिति को स्थायी किए बिना रन इतिहास, बैकऑफ़ और विफलता-अलर्ट प्रबंधन में शामिल होती हैं।

निष्पादन शैलियाँ

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

चैनल डिलीवरी के लिए --announce --channel telegram --to "-1001234567890" का उपयोग करें। Telegram फ़ोरम विषयों के लिए -1001234567890:topic:123 का उपयोग करें; OpenClaw, Telegram के स्वामित्व वाले संक्षिप्त रूप -1001234567890:123 को भी स्वीकार करता है। प्रत्यक्ष RPC/कॉन्फ़िग कॉलर delivery.threadId को स्ट्रिंग या संख्या के रूप में पास कर सकते हैं। Slack/Discord/Mattermost लक्ष्य स्पष्ट प्रीफ़िक्स (channel:<id>, user:<id>) का उपयोग करते हैं। Matrix रूम आईडी केस-सेंसिटिव होते हैं; Matrix से सटीक रूम आईडी या room:!room:server रूप का उपयोग करें।

जब घोषणा डिलीवरी channel: "last" का उपयोग करती है या channel को छोड़ती है, तो telegram:123 जैसा प्रदाता-प्रीफ़िक्स वाला लक्ष्य चैनल चुन सकता है, इससे पहले कि Cron सेशन इतिहास या कॉन्फ़िगर किए गए किसी एक चैनल पर फ़ॉलबैक करे। केवल लोड किए गए Plugin द्वारा विज्ञापित प्रीफ़िक्स ही प्रदाता चयनकर्ता होते हैं। यदि delivery.channel स्पष्ट रूप से दिया गया है, तो लक्ष्य प्रीफ़िक्स में उसी प्रदाता का नाम होना चाहिए; WhatsApp को Telegram आईडी की व्याख्या फ़ोन नंबर के रूप में करने देने के बजाय channel: "whatsapp" के साथ to: "telegram:123" को अस्वीकार कर दिया जाता है। लक्ष्य-प्रकार और सेवा प्रीफ़िक्स (channel:<id>, user:<id>, imessage:<handle>, sms:<number>) चैनल के स्वामित्व वाला लक्ष्य सिंटैक्स बने रहते हैं, प्रदाता चयनकर्ता नहीं।

पृथक जॉब के लिए चैट डिलीवरी साझा होती है: यदि कोई चैट रूट उपलब्ध है, तो एजेंट --no-deliver के साथ भी message टूल का उपयोग कर सकता है। यदि एजेंट कॉन्फ़िगर किए गए/वर्तमान लक्ष्य को भेजता है, तो OpenClaw फ़ॉलबैक घोषणा छोड़ देता है। अन्यथा announce, webhook, और none केवल यह नियंत्रित करते हैं कि एजेंट टर्न के बाद रनर अंतिम उत्तर के साथ क्या करता है।

जब कोई एजेंट सक्रिय चैट से पृथक रिमाइंडर बनाता है, तो OpenClaw फ़ॉलबैक घोषणा रूट के लिए सुरक्षित रखा गया लाइव डिलीवरी लक्ष्य संग्रहीत करता है। आंतरिक सेशन कुंजियाँ लोअरकेस में हो सकती हैं; वर्तमान चैट संदर्भ उपलब्ध होने पर उन कुंजियों से प्रदाता डिलीवरी लक्ष्यों का पुनर्निर्माण नहीं किया जाता।

अप्रत्यक्ष घोषणा डिलीवरी पुराने लक्ष्यों को सत्यापित और पुनः रूट करने के लिए कॉन्फ़िगर की गई चैनल अनुमति-सूचियों का उपयोग करती है। DM पेयरिंग-स्टोर अनुमोदन फ़ॉलबैक ऑटोमेशन प्राप्तकर्ता नहीं होते; जब किसी शेड्यूल किए गए जॉब को सक्रिय रूप से किसी DM पर भेजना हो, तो delivery.to सेट करें या चैनल की allowFrom प्रविष्टि कॉन्फ़िगर करें।

विफलता सूचनाएँ

विफलता सूचनाएँ एक अलग गंतव्य पथ का अनुसरण करती हैं:

• cron.failureDestination विफलता सूचनाओं के लिए वैश्विक डिफ़ॉल्ट सेट करता है।
• job.delivery.failureDestination प्रत्येक जॉब के लिए उसे ओवरराइड करता है।
• यदि इनमें से कोई भी सेट नहीं है और जॉब पहले से announce के माध्यम से डिलीवर करता है, तो विफलता सूचनाएँ उस प्राथमिक घोषणा लक्ष्य पर फ़ॉलबैक करती हैं।
• delivery.failureDestination केवल sessionTarget="isolated" जॉब पर समर्थित है, जब तक कि प्राथमिक डिलीवरी मोड webhook न हो।
• failureAlert.includeSkipped: true किसी जॉब या वैश्विक Cron अलर्ट नीति में बार-बार छोड़े गए रन के अलर्ट सक्षम करता है। छोड़े गए रन का अलग लगातार-छोड़ने का काउंटर बना रहता है, इसलिए वे निष्पादन-त्रुटि बैकऑफ़ को प्रभावित नहीं करते।
• openclaw cron edit प्रति-जॉब अलर्ट ट्यूनिंग उपलब्ध कराता है: --failure-alert/--no-failure-alert, --failure-alert-after <n>, --failure-alert-channel, --failure-alert-to, --failure-alert-cooldown, --failure-alert-include-skipped/--failure-alert-exclude-skipped, --failure-alert-mode, और --failure-alert-account-id।

आउटपुट भाषा

Cron जॉब चैनल, लोकेल या पिछले संदेशों से उत्तर की भाषा का अनुमान नहीं लगाते। भाषा का नियम शेड्यूल किए गए संदेश या टेम्पलेट में रखें:

openclaw cron edit <jobId> \  --message "अपडेट का सारांश दें। चीनी में उत्तर दें; URL, कोड और उत्पाद नाम अपरिवर्तित रखें।"

टेम्पलेट फ़ाइलों के लिए भाषा निर्देश को रेंडर किए गए प्रॉम्प्ट में रखें और जॉब चलने से पहले सत्यापित करें कि {{language}} जैसे प्लेसहोल्डर भरे गए हैं। यदि आउटपुट में भाषाएँ मिश्रित हों, तो नियम स्पष्ट करें, उदाहरण के लिए: "वर्णनात्मक टेक्स्ट के लिए चीनी का उपयोग करें और तकनीकी शब्दों को अंग्रेज़ी में रखें।"

CLI उदाहरण

openclaw cron add \  --name "कैलेंडर की जाँच" \  --at "20m" \  --session main \  --system-event "अगला Heartbeat: कैलेंडर जाँचें।" \  --wake now

openclaw cron create "0 7 * * *" \  "रातभर के अपडेट का सारांश दें।" \  --name "सुबह का संक्षिप्त विवरण" \  --tz "America/Los_Angeles" \  --session isolated \  --announce \  --channel slack \  --to "channel:C1234567890"

openclaw cron add \  --name "गहन विश्लेषण" \  --cron "0 6 * * 1" \  --tz "America/Los_Angeles" \  --session isolated \  --message "परियोजना की प्रगति का साप्ताहिक गहन विश्लेषण।" \  --model "opus" \  --thinking high \  --announce

openclaw cron create "0 18 * * 1-5" \  "आज के डिप्लॉय का JSON के रूप में सारांश दें।" \  --name "डिप्लॉय सारांश" \  --webhook "https://example.invalid/openclaw/cron"

openclaw cron create "*/15 * * * *" \  --name "क्यू गहराई जाँच" \  --command "scripts/check-queue.sh" \  --command-cwd "/srv/app" \  --announce \  --channel telegram \  --to "-1001234567890"

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

# सक्षम जॉब सूचीबद्ध करेंopenclaw cron list # अक्षम जॉब भी शामिल करेंopenclaw cron list --all # किसी संग्रहीत जॉब को JSON के रूप में प्राप्त करेंopenclaw cron get <jobId> # समाधान किए गए डिलीवरी रूट सहित एक जॉब दिखाएँopenclaw cron show <jobId> # हटाए बिना सक्षम/अक्षम करेंopenclaw cron enable <jobId>openclaw cron disable <jobId> # किसी जॉब को संपादित करेंopenclaw cron edit <jobId> --message "अपडेट किया गया प्रॉम्प्ट" --model "opus" # किसी जॉब को अभी बलपूर्वक चलाएँopenclaw cron run <jobId> # किसी जॉब को अभी बलपूर्वक चलाएँ और उसकी अंतिम स्थिति की प्रतीक्षा करेंopenclaw cron run <jobId> --wait --wait-timeout 10m --poll-interval 2s # केवल तभी चलाएँ जब समय हो गया होopenclaw cron run <jobId> --due # रन इतिहास देखेंopenclaw cron runs --id <jobId> --limit 50 # कोई एक सटीक रन देखेंopenclaw cron runs --id <jobId> --run-id <runId> # किसी जॉब को हटाएँopenclaw cron remove <jobId> # एजेंट चयन (बहु-एजेंट सेटअप)openclaw cron create "0 6 * * *" "ऑपरेशन कतार जाँचें" --name "ऑपरेशन स्वीप" --session isolated --agent opsopenclaw cron edit <jobId> --clear-agent

किसी सत्र को संग्रहित करने पर (Control UI से, या ऑपरेटर-एडमिन कॉलर से sessions.patch { archived: true }) उस सत्र से बँधा प्रत्येक सक्षम cron जॉब अक्षम हो जाता है: उसका पृथक cron:<jobId> सत्र, कोई session:<key> लक्ष्य, या कोई डिलीवरी/वेक sessionKey लेन। सत्र को पुनर्स्थापित करने से वे जॉब फिर सक्षम नहीं होते; openclaw cron enable <jobId> का उपयोग करें। जिन सत्रों से कोई सक्षम जॉब बँधा है, वे Control UI साइडबार में घड़ी का बैज दिखाते हैं।

openclaw cron run <jobId> मैन्युअल रन को कतार में डालने के बाद वापस लौटता है। शटडाउन हुक, रखरखाव स्क्रिप्ट या ऐसे अन्य स्वचालन के लिए --wait का उपयोग करें जिन्हें कतारबद्ध रन पूरा होने तक अवरुद्ध रहना आवश्यक है; यह लौटाए गए runId को पोल करता है (डिफ़ॉल्ट टाइमआउट 10m, पोल अंतराल 2s) और स्थिति ok के लिए 0 से, तथा error, skipped या प्रतीक्षा टाइमआउट के लिए गैर-शून्य मान से बाहर निकलता है।

एजेंट का cron टूल cron(action: "list") से संक्षिप्त जॉब सारांश (id, name, enabled, nextRunAtMs, scheduleKind, lastRunStatus) लौटाता है; किसी एक जॉब की पूरी परिभाषा के लिए cron(action: "get", jobId: "...") का उपयोग करें। प्रत्यक्ष Gateway कॉलर cron.list को compact: true दे सकते हैं; इसे छोड़ने पर डिलीवरी पूर्वावलोकन सहित पूरा उत्तर सुरक्षित रहता है।

openclaw cron create, openclaw cron add का उपनाम है। नए जॉब किसी स्थानात्मक शेड्यूल ("0 9 * * 1", "every 1h", "20m", या कोई ISO टाइमस्टैम्प) के बाद स्थानात्मक एजेंट प्रॉम्प्ट का उपयोग कर सकते हैं। पूर्ण हुए रन के पेलोड को किसी HTTP एंडपॉइंट पर POST करने के लिए cron add|create या cron edit पर --webhook <url> का उपयोग करें; Webhook डिलीवरी को चैट डिलीवरी फ़्लैग (--announce, --channel, --to, --thread-id, --account) के साथ संयोजित नहीं किया जा सकता। cron edit, --clear-channel, --clear-to, --clear-thread-id, और --clear-account पर उन रूटिंग फ़ील्ड को अलग-अलग अनसेट करें (प्रत्येक अपने संबंधित सेट फ़्लैग के साथ दिए जाने पर अस्वीकार होता है) — यह --no-deliver से अलग है, जो केवल रनर फ़ॉलबैक डिलीवरी को अक्षम करता है।

Webhook

Gateway बाहरी ट्रिगर के लिए HTTP Webhook एंडपॉइंट उपलब्ध करा सकता है। कॉन्फ़िगरेशन में सक्षम करें:

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

प्रमाणीकरण

प्रत्येक अनुरोध में हेडर के माध्यम से हुक टोकन शामिल होना आवश्यक है:

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

क्वेरी-स्ट्रिंग टोकन अस्वीकार किए जाते हैं।

curl -X POST http://127.0.0.1:18789/hooks/wake \  -H 'Authorization: Bearer SECRET' \  -H 'Content-Type: application/json' \  -d '{"text":"नया ईमेल प्राप्त हुआ","mode":"now"}'

curl -X POST http://127.0.0.1:18789/hooks/agent \  -H 'Authorization: Bearer SECRET' \  -H 'Content-Type: application/json' \  -d '{"message":"इनबॉक्स का सारांश दें","name":"ईमेल","model":"openai/gpt-5.6-sol"}'

Gmail PubSub एकीकरण

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

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

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

यह hooks.gmail कॉन्फ़िगरेशन लिखता है, Gmail प्रीसेट सक्षम करता है और पुश एंडपॉइंट (--tailscale funnel|serve|off) के लिए डिफ़ॉल्ट रूप से Tailscale Funnel का उपयोग करता है।

Gateway स्वचालित प्रारंभ

जब hooks.enabled=true और hooks.gmail.account सेट हों, तब Gateway बूट पर gog gmail watch serve प्रारंभ करता है और वॉच को स्वचालित रूप से नवीनीकृत करता है। इससे बाहर रहने के लिए 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: "openai/gpt-5.6-sol",      thinking: "high",    },  },}

अविश्वसनीय इनबॉक्स के लिए अपने प्रदाता से उपलब्ध नवीनतम पीढ़ी के सर्वोत्तम स्तर वाले मॉडल का उपयोग करें। ऊपर दिया गया मान एक उदाहरण है; मॉडल का आपके कॉन्फ़िगर किए गए कैटलॉग और अनुमति-सूची में मौजूद होना आवश्यक है।

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

{  cron: {    enabled: true,    store: "~/.openclaw/cron/jobs.json",    triggers: {      enabled: false,    },    webhookToken: "replace-with-dedicated-webhook-token",    sessionRetention: "24h",  },}

webhookToken, cron Webhook POST पर Authorization: Bearer <token> के रूप में भेजा जाता है।

cron.store एक तार्किक स्टोर कुंजी और डॉक्टर माइग्रेशन पथ है, हाथ से संपादित की जाने वाली सक्रिय JSON फ़ाइल नहीं। जॉब डेटा SQLite में रहता है; बदलावों के लिए CLI या Gateway API का उपयोग करें।

cron अक्षम करें: 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

संबंधित

• ऑटोमेशन — सभी ऑटोमेशन तंत्रों का एक नज़र में अवलोकन
• पृष्ठभूमि कार्य — Cron निष्पादनों के लिए कार्य खाता-बही
• Heartbeat — मुख्य सेशन के आवधिक टर्न
• समय-क्षेत्र — समय-क्षेत्र कॉन्फ़िगरेशन