शेड्यूल्ड कार्य Automations: cron, रिमाइंडर और Webhook ट्रिगर
पिछले पाठ की चयन तालिका ने «आपके ध्यान न होने पर भी Claw से काम निपटवाना» को कई तंत्रों में बाँटा था; यह पाठ उनमें सबसे अधिक उपयोग होने वाले OpenClaw शेड्यूल्ड कार्य (आधिकारिक नाम Automations) को खोलकर पूरी तरह समझाता है। यह क्या है? एक वाक्य में: OpenClaw का बिल्ट-इन शेड्यूलर — कार्य साझा SQLite स्टेट डेटाबेस में पर्सिस्ट होते हैं, Gateway निर्धारित समय पर agent को जगाता है, और रिज़ल्ट को चैट चैनल, webhook एंडपॉइंट पर डिलीवर किया जा सकता है, या कहीं भी नहीं भेजा जा सकता।
कमांड लाइन प्रवेश बिंदु openclaw automations है, openclaw cron उन्हीं कमांड्स का उपनाम है — पुराने ट्यूटोरियल में openclaw cron देखकर घबराएँ नहीं, यह एक ही चीज़ है। सभी उदाहरण OpenClaw v2026.10.9 पर आधारित हैं।
सीखने के बाद आप क्या कर सकते हैं
--atसे वन-टाइम रिमाइंडर बनाएँ,--cron/--everyसे रिपीटिंग कार्य बनाएँ,openclaw automations listमें दिखते हैं, निर्धारित समय पर अपने आप चलते हैं- कार्य के रिज़ल्ट को आपके निर्दिष्ट चैट चैनल (
--announce --channel --to) या webhook एंडपॉइंट (--webhook) पर डिलीवर करें - बनाए गए कार्यों का प्रबंधन करें: रन हिस्ट्री देखें, अस्थायी रूप से डिसेबल करें, प्रॉम्प्ट बदलें, तुरंत ज़बरदस्ती चलाएँ
- इनबाउंड Webhook चालू करें ताकि बाहरी सेवाएँ (CI, मॉनिटरिंग, स्क्रिप्ट) HTTP के ज़रिए सक्रिय रूप से Claw को जगा सकें
- दो क्लासिक जालों से बचें: cron एक्सप्रेशन का दिन/सप्ताह का OR जाल, और तीन एक-दूसरे से असंबंधित टाइमज़ोन सेटिंग
आपकी मौजूदा समस्या
- हर सुबह आँख खुलते ही खुद दर्जनों वेबसाइट और ग्रुप मैसेज टटोलने पड़ते हैं, तभी «कल रात क्या हुआ» की तस्वीर बनती है
- «काम खत्म होने से पहले मुझे वीकली रिपोर्ट भेजना याद दिलाना» अब भी दिमाग़ पर निर्भर है, AI असिस्टेंट सिर्फ़ तब काम आता है जब उससे पूछा जाए, आप हटते ही रुक जाता है
- चाहते हैं कि CI चलते ही AI लॉग पर एक नज़र डाले, लेकिन पता नहीं कि बाहरी इवेंट उसे «कैसे खिलाएँ»
यह तरीक़ा कब अपनाएँ
जब आपको चाहिए:
- नियमित गति से काम: हर सुबह 7 बजे समाचार संकलित करना, हर शुक्रवार वीकली रिपोर्ट की याद दिलाना, हर 15 मिनट में क्यू की गहराई जाँचना
- वन-टाइम रिमाइंडर: 20 मिनट बाद याद दिलाना, अगले सोमवार सुबह चेकलिस्ट मिलाने के लिए बुलाना
- बाहरी इवेंट ट्रिगर: कोड पुश, बिल्ड पूरा, स्क्रिप्ट समाप्त होने पर Claw को जगाकर काम करवाना
और आप नहीं चाहते:
- खुद crontab + स्क्रिप्ट + नोटिफ़िकेशन पाइपलाइन का पूरा सिस्टम जोड़ना
- 24 घंटे चैट विंडो पर नज़र रखकर मैसेज का इंतज़ार करना
💡 समझ न आए कौन-सा तंत्र चुनें?
पिछले पाठ की चयन तालिका पर लौटें: शेड्यूल्ड = Automations (यह पाठ); सटीक वन-टाइम रिमाइंडर = Automations का --at; बाहरी ट्रिगर = Webhooks (इस पाठ का चरण 4); सेशन लाइफ़साइकल स्क्रिप्ट = Hooks; वर्कस्पेस में लिखे स्थायी निर्देश = Standing Orders। देखें कुशल वर्कफ़्लो चरण परिचय।
🎒 शुरू करने से पहले की तैयारी
- कुशल वर्कफ़्लो चरण परिचय पूरा कर लिया है: Gateway चल रहा है, कम से कम एक मॉडल जुड़ा है (
/model statusमौजूदा मॉडल बता सकता है) - Gateway वाली मशीन पर टर्मिनल एक्सेस है — automations कमांड के लिए चलता हुआ Gateway चाहिए, और सभी बदलाव संचालन (
add/create,edit,remove,run) के लिएoperator.adminअनुमति चाहिए - रिज़ल्ट को फ़ेइशू, WeChat Work, Telegram, Slack में भेजना चाहते हैं? पहले परिदृश्य व्यवहार में कम से कम एक चैनल जोड़ें; जोड़े बिना भी सीख सकते हैं,
--no-deliverका उपयोग करें या सिर्फ़ रन हिस्ट्री देखें - एक कप पानी ☕ — इस पाठ में सब छोटे कमांड हैं, कॉपी करके चला सकते हैं
मूल विचार
एक शेड्यूल्ड कार्य (job) = शेड्यूलिंग (कब चले) + लोड (क्या चले) + डिलीवरी (रिज़ल्ट कहाँ भेजा जाए)। तीनों आयामों में कुछ विकल्प हैं, पहले चेहरा पहचान लें, नीचे क्रमशः उपयोग करेंगे:
पाँच प्रकार की शेड्यूलिंग (कब ट्रिगर होगा):
| प्रकार | CLI पैरामीटर | अर्थ |
|---|---|---|
at | --at | वन-टाइम समय बिंदु: ISO 8601 टाइमस्टैम्प, या 20m जैसा रिलेटिव समय |
every | --every | नियत अंतराल: 10m, 1h, 1d |
cron | --cron | 5/6 फ़ील्ड cron एक्सप्रेशन, --tz टाइमज़ोन कॉन्फ़िगर किया जा सकता है |
on-exit | --on-exit | जब सुनी जा रही कमांड बाहर निकलती है तो एक बार ट्रिगर होता है |
stream | --stream-command | स्थायी कमांड की आउटपुट लाइनों को बैच में जोड़कर ट्रिगर करता है |
चार प्रकार के लोड (क्या चलाना है):
| लोड | CLI पैरामीटर | अर्थ |
|---|---|---|
| सिस्टम इवेंट | --system-event | owning agent के मुख्य सेशन में एक सामान्य राउंड ट्रिगर करता है (रिमाइंडर के लिए पहली पसंद) |
| agent संदेश | --message | एक पूर्ण मॉडल राउंड, जिससे Claw सच में काम करे |
| कमांड | --command | Gateway होस्ट पर shell कमांड चलाता है, मॉडल को कॉल नहीं करता |
| स्क्रिप्ट | --script | हेडलेस code-mode स्क्रिप्ट, जो owning agent के टूल्स इस्तेमाल कर सकती है |
चार प्रकार के एक्ज़ीक्यूशन सेशन (कहाँ चलाना है): --session main (मुख्य सेशन, रिमाइंडर के लिए उपयुक्त), isolated (हर बार बिल्कुल नया सेशन, रिपोर्ट जैसे लूप कार्यों के लिए उपयुक्त), current (जिस बातचीत ने इसे बनाया उससे बंधा), session:<id> (बार-बार के बीच संदर्भ जमा करने वाला स्थायी सेशन)।
तीन प्रकार की डिलीवरी (परिणाम कहाँ जाए): --announce (चैट चैनल में भेजें), --webhook (HTTP एंडपॉइंट पर POST), --no-deliver (नहीं भेजें, केवल रन रिकॉर्ड रखें)।
💡 दो उपनाम हैं, उनसे घबराइए नहीं
openclaw cron, openclaw automations का उपनाम है; automations create, automations add का उपनाम है। नए कार्य पोज़िशनल पैरामीटर लेखनशैली का समर्थन करते हैं: पहले शेड्यूल, बाद में प्रॉम्प्ट, जैसे openclaw automations create "0 7 * * *" "Summarize overnight updates."। नैचुरल-लैंग्वेज शेड्यूलिंग ("every day at 9am") समर्थित नहीं है, सीधे cron लिखें।
मेरे साथ करें
चरण 1: पहला OpenClaw शेड्यूल्ड कार्य बनाएं (20 मिनट बाद आपको याद दिलाएगा)
क्यों: एक बार का रिमाइंडर सबसे छोटा शेड्यूल्ड कार्य है, 30 सेकंड में बन जाता है, और इससे पुष्टि होती है कि पूरी श्रृंखला (बनाना → संग्रह → समय पर ट्रिगर) काम कर रही है।
openclaw automations add \
--name "Calendar check" \
--at "20m" \
--session main \
--system-event "Check the calendar for upcoming events."हर पैरामीटर को पहचानें: --at "20m" का अर्थ है 20 मिनट बाद एक बार चलाना (ISO टाइमस्टैम्प भी लिख सकते हैं); --session main मुख्य सेशन में ट्रिगर करता है; --system-event रिमाइंडर की सामग्री है।
आपको यह दिखना चाहिए: कमांड सफलतापूर्वक निष्पादित, कोई त्रुटि नहीं। अब जाँचें कि यह सहेजा गया है:
openclaw automations listआपको यह दिखना चाहिए: सूची में Calendar check नाम का कार्य और उसका job id दिखता है — इस id को नोट कर लें, आगे हर जगह काम आएगा।
- छोटी जाँच:
openclaw automations listमेंCalendar checkदिखना चाहिए
सीधे निरपेक्ष समय भी लिख सकते हैं। नीचे आधिकारिक क्विक-स्टार्ट उदाहरण से लिया गया है (केवल अप्रचलित --wake now हटाया गया), --delete-after-run का अर्थ है सफलतापूर्वक चलने के बाद कार्य स्वतः हट जाएगा, कचरा नहीं छूटेगा:
openclaw automations create "2027-02-01T16:00:00Z" \
--name "Reminder" \
--session main \
--system-event "Reminder: check the automations docs draft" \
--delete-after-run💡 पुराने ऑनलाइन ट्यूटोरियलों का --wake now अब अप्रचलित है
--wake now|next-heartbeat यह पैरामीटर अब केवल "स्वीकृत लेकिन कुछ न करने वाला" संगतता फ़ील्ड है — कार्य समय पर सामान्य सेशन निष्पादन से स्वतः ट्रिगर होता है, अतिरिक्त wake चरण की ज़रूरत नहीं। शेड्यूलिंग व्यवहार पूरी तरह शेड्यूल पैरामीटर से तय होता है, इसे देखते ही हटा दें।
चरण 2: cron लूप कार्य बनाएं और परिणाम चैट चैनल पर डिलीवर करें
क्यों: एक बार का रिमाइंडर आपको केवल एक बार बुला सकता है; असली समय बचाने वाले कार्य "हर सुबह अपने-आप सारांश बनाकर मुझे भेजो" जैसे लूप कार्य हैं — cron लय तय करता है, डिलीवरी पैरामीटर तय करता है कि परिणाम कहाँ पहुँचेगा।
openclaw automations create "0 7 * * *" \
"Summarize overnight updates. 用中文回复;链接、代码和产品名保持原样。" \
--name "Morning brief" \
--tz "Asia/Shanghai" \
--session isolated \
--announce \
--channel slack \
--to "channel:C1234567890"लाइन-दर-लाइन तोड़कर देखें:
| पैरामीटर | कार्य |
|---|---|
"0 7 * * *" | पोज़िशनल पैरामीटर एक: cron एक्सप्रेशन, हर दिन 07:00 |
"Summarize overnight updates. …" | पोज़िशनल पैरामीटर दो: कार्य का प्रॉम्प्ट। कार्य चैनल या ऐतिहासिक संदेशों से उत्तर की भाषा नहीं समझता, चीनी में उत्तर चाहिए तो इसे प्रॉम्प्ट में लिखें |
--tz "Asia/Shanghai" | cron मूल्यांकन का टाइमज़ोन। न लिखें तो Gateway होस्ट का टाइमज़ोन उपयोग होता है |
--session isolated | हर रन में बिल्कुल नया सेशन खुलता है, मुख्य बातचीत दूषित नहीं होती |
--announce --channel slack --to "channel:C1234567890" | परिणाम Slack चैनल पर डिलीवर होता है। Slack/Discord/Mattermost में channel:<id>, user:<id> प्रीफ़िक्स; Telegram समूह में -100… से शुरू होने वाला संख्यात्मक id |
आपको यह दिखना चाहिए: सफलतापूर्वक बन गया। add/create, list, show सभी पार्स की गई डिलीवरी रूट का प्रीव्यू दिखाते हैं — अगर गंतव्य पार्स नहीं हो पाता, तो यहीं कारण बता देगा, अगली सुबह तक इंतज़ार नहीं करना पड़ेगा कि कुछ मिला नहीं।
- छोटी जाँच:
openclaw automations show <job-id>में पार्स की गई डिलीवरी रूट दिखनी चाहिए
तीन अतिरिक्त बातें:
- लक्ष्य का प्रारूप चैनल के अनुसार भिन्न होता है: फ़ेइशू, वीचैट (एंटरप्राइज़) जैसे घरेलू IM के एकीकरण और लक्ष्य लेखनशैली देखें परिदृश्य व्यवहार (फ़ेइशू एकीकरण, वीचैट (एंटरप्राइज़) एकीकरण)। जिन होस्ट पर कई चैनल कॉन्फ़िगर हैं, वहाँ isolated कार्यों के लिए
--channelदेना अनिवार्य है (जब तक--toमें provider प्रीफ़िक्स न हो या सेशन रूट बना रहे)। - चैनल जुड़ा न हो तो भी सीख सकते हैं: CLI से बने isolated कार्य को पार्स हो सकने वाला चैनल रूट, webhook डिलीवरी या
--no-deliver— इनमें से कोई एक चाहिए; अभ्यास के समय--no-deliverजोड़ें, परिणाम केवल रन इतिहास में जाएगा। - इसे चैट पर बमबारी न करने दें: नियमित जाँच वाले कार्यों में प्रॉम्प्ट में तय करें कि "कुछ न होने पर केवल
NO_REPLYउत्तर दें" — जब पूरा अंतिम उत्तर अपरकेसNO_REPLYहो, तो डिलीवरी चुपचाप छोड़ दी जाती है, निष्पादन रिकॉर्ड हमेशा की तरह इतिहास में लिखा जाता है।
चैट चैनल की जगह webhook चाहते हैं? डिलीवरी पैरामीटर को --webhook से बदलें (यह --announce/--channel/--to के साथ परस्पर अनन्य है, एक साथ उपयोग नहीं कर सकते):
openclaw automations create "0 18 * * 1-5" \
"Summarize today's deploys as JSON." \
--name "Deploy digest" \
--webhook "https://example.invalid/openclaw/cron"चरण 3: शेड्यूल्ड कार्यों का प्रबंधन — रन इतिहास, अक्षम करना और तुरंत चलाना
क्यों: काम बना लेने के बाद सब कुछ हमेशा के लिए ठीक नहीं हो जाता—प्रॉम्प्ट बदलना, अस्थायी रूप से बंद करना, या यह जाँचना कि क्या यह वास्तव में चला या नहीं—ये सब रोज़मर्रा के काम हैं। सब कुछ openclaw automations एक ही कमांड परिवार में है:
openclaw automations list # 启用中的任务
openclaw automations list --all # 含已禁用的任务
openclaw automations get <job-id> # 单个任务的完整 JSON
openclaw automations show <job-id> # 单个任务 + 解析后的投递路由
openclaw automations runs <job-id> --limit 50 # 运行历史
openclaw automations edit <job-id> --message "Updated prompt" # 改提示词
openclaw automations disable <job-id> # 停用(不删除)
openclaw automations enable <job-id> # 重新启用
openclaw automations run <job-id> # 立即强制运行
openclaw automations remove <job-id> # 删除चरण 1 की रिमाइंडर सत्यापित करने के लिए 20 मिनट इंतज़ार नहीं करना चाहते? बलपूर्वक रन करने से तुरंत असर दिखता है:
openclaw automations run <job-id>आपको यह दिखना चाहिए: { ok: true, enqueued: true, runId: "…" } जैसा आउटपुट—run कतार में डाले जाने पर तुरंत लौटता है, runId से इस एक बार के निष्पादन का नतीजा देखा जा सकता है:
openclaw automations runs <job-id> --run-id <run-id>आपको यह दिखना चाहिए: इस रन का रिकॉर्ड, status का मान ok, error या skipped (payload निष्पादन स्थिति), साथ ही पूरे राउंड की पूर्णता स्थिति completionStatus (succeeded / failed / unknown)।
- छोटी जाँच:
openclaw automations runs <job-id>में अभी-अभी बलपूर्वक रन किए गए रिकॉर्ड दिखेंगे
तीन व्यवहार जो याद रखने लायक हैं:
- मैनुअल रन शेड्यूल स्लॉट नहीं खाता: बलपूर्वक
runटाइम्ड काम का अगला शेड्यूल स्लॉट नहीं खर्च करता; डिसेबल किए गए काम को मैनुअल रूप से एक बार चलाने से शेड्यूलिंग अपने आप बहाल नहीं होती, बहाल करने के लिएenableका उपयोग करें। - विफलता पर स्वतः बैकऑफ: लूप काम लगातार त्रुटि देने पर
30s → 1m → 5m → 15m → 60mबैकऑफ से दोबारा कोशिश करता है, अगली सफलता के बाद वापस सामान्य हो जाता है; समय-आधारित लूप काम लगातार 10 बार विफल होने पर स्वतः डिसेबल हो जाता है (list --allसे वापस खोजें, कारण ठीक करने के बादenable)। - मॉडल बदलने के लिए
--modelका उपयोग करें:automations edit <job-id> --model "opus" --thinking highसे किसी एक काम का मॉडल/थिंकिंग स्तर बदला जा सकता है; मॉडल की अनुमति न होने पर काम सीधे सत्यापन त्रुटि देता है, चुपचाप डिफ़ॉल्ट मॉडल पर वापस नहीं जाता।
चरण 4: इनबाउंड Webhook चालू करें, ताकि बाहरी सेवाएँ Claw को जगा सकें
क्यों: पहली तीनों ट्रिगर समय-संचालित हैं; जैसे CI पूरा होते ही Claw को लॉग देखना—इस तरह की बाहरी घटनाओं के लिए उल्टी दिशा वाला इनबाउंड Webhook चाहिए—बाहरी सेवाएँ HTTP से OpenClaw को कॉल करती हैं। यह डिफ़ॉल्ट रूप से डिसेबल होता है, तीन चरणों में चालू होता है।
1. कॉन्फ़िगरेशन में लिखें। नीचे दिए गए इस हिस्से को Gateway कॉन्फ़िगरेशन फ़ाइल (~/.openclaw/openclaw.json) में मर्ज करें, token को एक लंबे रैंडम स्ट्रिंग से बदलें——** विशेष token, Gateway प्रमाणीकरण token या पासवर्ड का पुनः उपयोग न करें**; main को उस agent id से बदलें जिसे आप जगाना चाहते हैं:
{
hooks: {
enabled: true,
token: "<long-random-hook-token>",
path: "/hooks",
allowedAgentIds: ["main"],
allowRequestSessionKey: false,
},
}2. सत्यापित करें और रीस्टार्ट करें (अगर Gateway फ़ोरग्राउंड में चल रहा है, तो उस फ़ोरग्राउंड प्रोसेस को रीस्टार्ट करें):
openclaw config validate
openclaw gateway restart
openclaw logs --followआपको यह दिखना चाहिए: सत्यापन में कोई त्रुटि नहीं, Gateway रीस्टार्ट होने के बाद लॉग स्क्रॉल होने लगते हैं।
3. स्मोक टेस्ट। दूसरा टर्मिनल खोलकर स्थानीय Gateway पर एक हानिरहित टेस्ट भेजें (token, agent id और पोर्ट अपनी कॉन्फ़िगरेशन के अनुसार बदलें; डिफ़ॉल्ट पोर्ट 18789):
curl --include http://127.0.0.1:18789/hooks/agent \
-H 'Authorization: Bearer <long-random-hook-token>' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: webhook-smoke-001' \
--data '{"message":"Summarize this test event: the sample import completed.","name":"Webhook smoke test","agentId":"main","deliver":false}'आपको यह दिखना चाहिए: HTTP 200, रिस्पॉन्स बॉडी कुछ ऐसी:
{ "ok": true, "runId": "<hook-request-run-id>" }openclaw logs --follow में hook agent run completed और इस runId को खोजने पर निष्पादन का नतीजा दिखेगा। ध्यान दें कि 200 केवलस्वीकृति की सफलता (सेशन निष्पादन स्लॉट मिल गया) दर्शाता है, यह नहीं कि मॉडल पूरा चल गया, टूल सफल हुआ या संदेश पहुँच गया—इस उदाहरण में "deliver":false जानबूझकर संदेश नहीं भेजता।
- छोटी जाँच: curl 200 और
runIdलौटाता है, लॉग मेंhook agent run completedखोजा जा सकता है
तीन एंडपॉइंट, ज़रूरत के अनुसार चुनें:
| एंडपॉइंट | उद्देश्य |
|---|---|
POST /hooks/wake | लक्षित agent के मुख्य सेशन में एक विश्वसनीय सूचना डालता है (हल्का "एक बार पुकारना") |
POST /hooks/agent | एक पूरा agent राउंड जमा करता है (message के साथ, मॉडल/सेशन मोड निर्दिष्ट किया जा सकता है) |
POST /hooks/<name> | hooks.mappings के माध्यम से मैप किया गया कस्टम पाथ, बाहरी पेलोड को ऊपर की दोनों क्रियाओं में बदल सकता है |
प्रमाणीकरण नियम: हर अनुरोध में Authorization: Bearer <token> (अनुशंसित) या x-openclaw-token: <token> होना चाहिए; URL query से token भेजने पर अस्वीकार कर दिया जाता है; सभी एंडपॉइंट केवल POST स्वीकार करते हैं, बॉडी Content-Type: application/json में होती है।
⚠️ Webhook एक एक्सपोज़र सतह है, चार सुरक्षा नियम
- एंडपॉइंट को loopback, tailnet या विश्वसनीय रिवर्स प्रॉक्सी के पीछे रखें; दूरस्थ कॉल HTTPS से करें, केवल ज़रूरी पाथ ही एक्सपोज़ करें
- hook के लिए विशेष token और विशेष सबपाथ का उपयोग करें (
/अस्वीकार कर दिया जाएगा) hooks.allowedAgentIdsको कसें, केवल ज़रूरी agent ही छोड़ें- बाहरी घटना की सामग्री कोडेटा मानें: agent hook सामग्री पर डिफ़ॉल्ट रूप से सुरक्षा रैपर होता है, लेकिन रैपर टूल और workspace एक्सेस नहीं हटाता—अविश्वसनीय इनपुट को प्रतिबंधित agent से ही संभालें
चेकपॉइंट ✅
openclaw automations listमें आपके बनाए काम और job id दिखते हैं- बलपूर्वक रन
openclaw automations run <job-id>नेrunIdलौटाया,runsमें यह रिकॉर्ड है - लूप काम में
--tz "Asia/Shanghai"है,listमें अगला रन समय अपेक्षा के अनुरूप है - curl स्मोक टेस्ट HTTP 200 और
runIdलौटाता है, लॉग मेंhook agent run completedमिलता है 0 9 15 * 1का असली अर्थ (OR) बता सकते हैं, और जानते हैं कि इसे AND में कैसे बदलें
आम गलतियों की चेतावनी
❌ cron में दिन और सप्ताह दोनों में एक साथ नॉन-वाइल्डकार्ड लिखने पर हर महीने 5-6 बार ट्रिगर होता है, 0-1 बार नहीं
「हर महीने 15 तारीख और सोमवार को 9 बजे」 व्यक्त करने के लिए, ऐसे लिखें:
# 想要:每月 15 号且是周一的 9 点
# 实际:每月 15 号的 9 点 + 每周一的 9 点,约每月 5-6 次
0 9 15 * 1कारण: OpenClaw cron को croner से पार्स करता है, और जब दिन (day-of-month) और सप्ताह (day-of-week) दोनों नॉन-वाइल्डकार्ड हों तो मानक Vixie व्यवहार के अनुसार OR लिया जाता है, AND नहीं।
सही तरीका: AND के लिए + प्रीफ़िक्स से सप्ताह लिखें—0 9 15 * +1; या केवल एक फ़ील्ड का उपयोग करें और दूसरी शर्त काम के प्रॉम्प्ट में लिखें ताकि Claw स्वयं निर्णय करे।
❌ समय 「सही」 है, पर टाइमज़ोन गलत
तीन टाइमज़ोन सेट एक-दूसरे से स्वतंत्र हैं, यहीं सबसे आसानी से गलती होती है:
--atटाइमज़ोन के बिना → UTC के रूप में व्याख्या (--at "2026-11-06T09:00:00"बीजिंग समय के 17 बजे है)--cronमें--tzन हो → Gateway होस्ट के टाइमज़ोन के अनुसार मूल्यांकन- सक्रिय अवधि
--active-hours-*→ इसका अपना--active-hours-timezoneहोता है (user/local/ IANA), जो cron के--tzसे स्वतंत्र है
सही तरीका: चीन में डिप्लॉयमेंट के लिए सबसे स्थिर आदत यह है कि cron में हमेशा स्पष्ट रूप से --tz "Asia/Shanghai" दें; --at का उपयोग करते समय या तो टाइमज़ोन ऑफ़सेट दें (+08:00), या --tz कॉन्फ़िगर करें।
❌ काम समय पर नहीं चला
आधिकारिक ट्रबलशूटिंग कमांड सीढ़ी के अनुसार ऊपर से नीचे जाँचें:
openclaw status
openclaw gateway status
openclaw automations status
openclaw automations list
openclaw automations runs <job-id> --limit 20
openclaw automations show <job-id>
openclaw logs --follow
openclaw doctorआम कारणों से मिलान करें: Gateway लगातार चल नहीं रहा है; cron.enabled: false या पर्यावरण चर OPENCLAW_SKIP_CRON=1 ने ऑटो शेड्यूलिंग बंद कर दी है (दोनों में से कोई भी मैनुअल run को नहीं रोकता); टास्क ऑटोमैटिकली डिसेबल हो गया है——list डिफ़ॉल्ट रूप सेडिसेबल्ड टास्कनहीं दिखाता, वापस पाने के लिए list --all चाहिए, कारण ठीक करने के बाद enable; अंत में जाँचें कि --tz और होस्ट टाइमज़ोन को गलत तो नहीं पढ़ रहे हैं।
❌ Webhook 200 लौटाता है, लेकिन चैट में कोई संदेश नहीं है
200 केवल स्वीकृति (acceptance) दर्शाता है। ट्रबलशूटिंग का क्रम:
- स्मोक टेस्ट में
"deliver":falseमेंजानबूझकर संदेश नहीं भेजा जाता, यह डिज़ाइन है, खराबी नहीं - एक ही रिक्वेस्ट में निष्पादन और डिलीवरी का नतीजा पाना चाहते हैं: payload में
"waitForCompletion": trueजोड़ें, रिस्पॉन्स केcompletionमेंstatus,delivered,deliverySuppressionReasonहोंगे - चैनल सीधी डिलीवरी मेंएक साथ
channelऔरtoदोनों देना ज़रूरी है, आधा देने पर डिस्पैच से पहले400से अस्वीकृत होगा - लॉग में
status=okके साथdeliveryError= निष्पादन सफल, डिलीवरी असफल, दोनों को अलग-अलग देखें
एडवांस्ड टिप्स (वैकल्पिक)
कंडीशनल ट्रिगर: समय-समय पर जाँच, बदलाव होने पर ही जगाएँ। every/cron/stream शेड्यूल पर --trigger-script ./watch-pr-ci.js लगाएँ, स्क्रिप्ट { fire, message?, state? } लौटाती है——fire: false होने पर चुपचाप छोड़ देता है, मॉडल टर्न नहीं भेजता। स्टेट की सीमा 16 KB, एक मूल्यांकन में 30 सेकंड का बजट, अधिकतम 5 टूल कॉल। ध्यान दें: फ़ोर्स run कंडीशनल गेटको बायपासकरके सीधे निष्पादित करता है; run --due कंडीशनल गेट का सम्मान करता है। सुरक्षा के लिहाज़ से साफ़ हो: कंडीशनल स्क्रिप्ट डिफ़ॉल्ट रूप से owning agent कीपूरी टूल पॉलिसी (exec सहित) के साथ बिना निगरानी चलती है, हार्ड-स्टॉप चाहिए तो cron.triggers.enabled: false सेट करें। व्यावहारिक उदाहरण देखें वेब मॉनिटरिंग: पेज बदलते ही सूचित करें।
/loop: चैट में एक वाक्य से लूप बनाएँ। owner-only /loop [interval] <prompt> मौजूदा बातचीत में लूप टास्क बनाता है——/loop 5m check deploy status निश्चित लय; अंतराल न दें तो सेल्फ-पेस्ड (1 मिनट से 1 घंटे के बीच)। /loop status देखें, /loop stop [name] रोकें। कमांड का विवरण देखें चैट कमांड्स क्रैश कोर्स।
मॉनिटरिंग रणनीति: बैकग्राउंड टास्क आधी रात में आपको परेशान न करें। जाँच-प्रकार के टास्क में एक्टिविटी विंडो और यील्ड स्विच जोड़ें:
openclaw automations add \
--name "Project monitor" \
--every 30m \
--session isolated \
--message "Check the job scratch for newly blocked work. Report changes that need attention; otherwise reply NO_REPLY." \
--active-hours-start 08:00 \
--active-hours-end 22:00 \
--active-hours-timezone user \
--idle-only \
--skip-if-scratch-empty \
--no-deliver--idle-only फ़ोरग्राउंड काम को प्राथमिकता देता है, --skip-if-scratch-empty टास्क स्क्रैच खाली होने पर मॉडल टर्न छोड़ देता है।
शेड्यूल्ड टास्क + लोकल मॉडल। isolated टास्क शुरू होने से पहले, शेड्यूलर पहले जाँचता है कि लोकल मॉडल एंडपॉइंट (Ollama एंडपॉइंट के लिए /api/tags, vLLM / SGLang / LM Studio जैसे OpenAI-संगत एंडपॉइंट के लिए /models) पहुँच योग्य है या नहीं——जाँच में केवल TCP कनेक्टिविटी देखी जाती है, HTTP रिक्वेस्ट नहीं भेजी जाती। न मिलने पर यह रन skipped दर्ज हो जाता है, अगली स्लॉट पर फिर कोशिश होती है (नतीजा एंडपॉइंट के हिसाब से 5 मिनट कैश रहता है, लगातार बमबारी नहीं होती)। लोकल मॉडल जोड़ने के लिए देखें लोकल मॉडल: Ollama, vLLM और ds4।
कुछ मास्टर स्विच। cron.enabled: false या OPENCLAW_SKIP_CRON=1: सारी ऑटो शेड्यूलिंग रोकें (मैनुअल run अप्रभावित)।cron.skipMissedJobs: true: Gateway बंद रहने के दौरान छूटे लूप स्लॉट छोड़ दें, ताकि रीस्टार्ट पर ढेर सारी पुरानी रिमाइंडर एक साथ दौड़ने से बचें (डिफ़ॉल्ट में पूरी दौड़ती हैं; वन-टाइम at टास्क इस स्विच से अप्रभावित)। स्टार्टअप पर्यावरण चर OPENCLAW_DISABLE_CRON_HOST_EXECUTION=1: कमांड/स्क्रिप्ट पेलोड, कंडीशनल ट्रिगर, on-exit और Gateway-होस्टेड stream हार्ड-डिसेबल——स्टार्टअप पर्यावरण बदलने के बाद Gateway रीस्टार्ट करने पर ही लागू होता है।
इस पाठ का सारांश
✅ OpenClaw शेड्यूल्ड टास्क = इनबिल्ट शेड्यूलर Automations: openclaw automations (openclaw cron एक उपनाम है), टास्क साझा SQLite स्टेट डेटाबेस में स्थायी रूप से रहते हैं, समय पर Gateway उन्हें जगाता है।
✅ एक टास्क, तीन आयाम: शेड्यूल (--at / --every / --cron --tz / --on-exit / --stream-command) × पेलोड (--system-event / --message / --command / --script) × डिलीवरी (--announce --channel --to / --webhook / --no-deliver)।
✅ निष्पादन सेशन में से एक चुनें: main (रिमाइंडर), isolated (रिपोर्ट-प्रकार, हर बार बिल्कुल नया), current (निर्माणकर्ता बातचीत से बंधा), session:<id> (बार-बार में संचित)।
✅ इनबाउंड Webhook डिफ़ॉल्ट में डिसेबल: hooks.enabled + विशेष token से चालू; /hooks/wake, /hooks/agent, /hooks/<name> तीन एंडपॉइंट, केवल POST + Bearer प्रमाणीकरण स्वीकारते हैं, 200 केवल स्वीकृति दर्शाता है।
✅ दो क्लासिक जाल: cron में दिन/सप्ताह दोनों नॉन-वाइल्डकार्ड होने पर यह OR होता है (AND के लिए + प्रीफ़िक्स); --at में टाइमज़ोन न हो तो UTC, cron में --tz न हो तो होस्ट टाइमज़ोन, एक्टिविटी विंडो का अलग टाइमज़ोन——तीनों एक-दूसरे से स्वतंत्र।
| मुख्य कॉन्फ़िग फ़ील्ड | अनुशंसित मान | विवरण |
|---|---|---|
--tz | "Asia/Shanghai" (चीन के लिए) | cron मूल्यांकन का टाइमज़ोन; बिना ऑफ़सेट वाले --at समय पर भी लागू |
--session | isolated (रिपोर्ट) / main (रिमाइंडर) | isolated हर बार नया सेशन, मुख्य बातचीत दूषित नहीं होती |
--announce --channel --to | चैनल id + लक्ष्य | Slack/Discord के लिए channel:<id>; मल्टी-चैनल होस्ट पर --channel देना अनिवार्य |
hooks.enabled / hooks.token | true / लंबा रैंडम विशेष token | इनबाउंड Webhook का स्विच और प्रमाणीकरण, Gateway प्रमाणीकरण का पुनः उपयोग न करें |
cron.enabled | true | false या OPENCLAW_SKIP_CRON=1 ऑटो शेड्यूलिंग रोकें |
cron.triggers.enabled | true (डिफ़ॉल्ट) | false कंडीशनल स्क्रिप्ट, स्क्रिप्ट पेलोड और stream शेड्यूलिंग का हार्ड-स्टॉप |
CLI क्विक रेफ़रेंस: openclaw automations list / get / show / runs / edit / enable / disable / run / remove, सभी पैरामीटर देखने के लिए --help जोड़ें। पूरे कमांड टेबल के लिए CLI कमांड और कॉन्फ़िगरेशन क्विक रेफ़रेंस देखें।
अगले पाठ का पूर्वावलोकन
शेड्यूल्ड टास्क यह तय करता है कि "कब" काम करना है; अगला पाठ ब्राउज़र नियंत्रण: Claw को आपकी ओर से इंटरनेट पर काम करने दें इसे इंटरनेट पर काम करने के लिए हाथ देता है, जो यह तय करता है कि "किस चीज़ से" काम करना है——दोनों पाठों को जोड़ने पर, मॉर्निंग ब्रीफ़ और मॉनिटरिंग बस कॉपी-पेस्ट करने जैसा है।
आप सीखेंगे:
web_search/x_search/web_fetchहल्के तीन टूल: जानकारी खोजें, मुख्य कंटेंट निकालें- आइसोलेटेड
openclawमैनेज्ड ब्राउज़र: बटन क्लिक करें, फ़ॉर्म भरें, स्क्रीनशॉट लें, आपके अपने ब्राउज़र को नहीं छुएगा - लॉग-इन किए हुए Chrome सेशन का पुन: उपयोग करने वाला
userprofile - कॉम्बिनेशन का पूर्वाभ्यास: शेड्यूलिंग + इंटरनेट = दैनिक मॉर्निंग ब्रीफ़, वेबपेज मॉनिटरिंग
संबंधित ट्यूटोरियल
- दैनिक मॉर्निंग ब्रीफ़: समय पर समाचार इकट्ठा करके आपके IM पर भेजें——इस पाठ के cron लूप + डिलीवरी का सीधा अनुप्रयोग
- वेबपेज मॉनिटरिंग: पेज बदलते ही आपको सूचित करें——कंडीशनल ट्रिगर का व्यावहारिक असेंबली
- GitHub ड्यूटी: PR सारांश और issue का स्वचालित प्रबंधन——इनबाउंड Webhook द्वारा agent को जगाने का विशिष्ट परिदृश्य