المهام المجدولة

Cron هو المجدول المضمّن في Gateway. يحتفظ بالمهام، ويوقظ الوكيل في الوقت المناسب، ويمكنه إرسال المخرجات إلى قناة دردشة أو Webhook أو عدم إرسالها إلى أي مكان.

بدء سريع

openclaw cron create "2027-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، وليس داخل النموذج. يجب أن يكون Gateway قيد التشغيل لكي تُنفَّذ الجداول.
• تُحفَظ تعريفات المهام وحالة وقت التشغيل وسجل التشغيل في قاعدة بيانات حالة SQLite المشتركة في OpenClaw، لذلك لا تؤدي عمليات إعادة التشغيل إلى فقدان الجداول.
• يُنشئ كل تنفيذ لـ Cron سجل مهمة في الخلفية.
• تُحذف مهام المرة الواحدة (--at) تلقائيًا بعد نجاحها افتراضيًا؛ مرّر --keep-after-run للاحتفاظ بها.
• ميزانية الوقت الفعلي لكل تشغيل: --timeout-seconds عند ضبطها. خلاف ذلك، تكون مهام دورات الوكيل المعزولة/المنفصلة محدودة بمراقب Cron الخاص البالغ 60 دقيقة قبل أن تنطبق مهلة دورة الوكيل الأساسية (agents.defaults.timeoutSeconds، وقيمتها الافتراضية 48 ساعة)؛ وتكون المهلة الافتراضية لمهام الأوامر 10 دقائق.
• عند بدء تشغيل Gateway، يُعاد جدولة مهام دورات الوكيل المعزولة المتأخرة بدلًا من إعادة تشغيلها فورًا، لإبقاء أعمال تهيئة النموذج/الأدوات خارج نافذة اتصال القناة.
• إذا شغّلت openclaw agent من Cron النظام أو من مجدول خارجي آخر، فغلّفه بتصعيد للإنهاء القسري رغم أن CLI يعالج بالفعل SIGTERM/SIGINT. تطلب عمليات التشغيل المدعومة من Gateway من Gateway إلغاء عمليات التشغيل المقبولة؛ وتتلقى عمليات التشغيل المحلية وعمليات التشغيل الاحتياطية المضمّنة إشارة الإلغاء نفسها. بالنسبة إلى GNU timeout، يُفضّل استخدام timeout -k 60 600 openclaw agent ... بدلًا من timeout 600 ... وحده — فقيمة -k هي الإجراء الاحتياطي إذا تعذّر على العملية إنهاء أعمالها في الوقت المحدد. بالنسبة إلى وحدات systemd، استخدم إشارة إيقاف SIGTERM مع نافذة سماح (TimeoutStopSec) قبل الإنهاء النهائي. تؤدي إعادة استخدام --run-id بينما لا يزال تشغيل Gateway الأصلي نشطًا إلى الإبلاغ عن النسخة المكررة بوصفها قيد التنفيذ بدلًا من بدء تشغيل ثانٍ.

أنواع الجداول

تُعامَل الطوابع الزمنية التي لا تحتوي على منطقة زمنية على أنها UTC. أضف --tz America/New_York لتفسير تاريخ ووقت --at بلا إزاحة، أو لتقييم تعبير Cron، وفق منطقة IANA الزمنية تلك. تستخدم تعبيرات Cron التي لا تحتوي على --tz المنطقة الزمنية لمضيف Gateway. لا يصح استخدام --tz مع --every أو --on-exit.

تُوزّع تلقائيًا التعبيرات المتكررة عند بداية الساعة (الدقيقة 0 مع حقل ساعة ذي حرف بدل) على مدة تصل إلى 5 دقائق لتقليل طفرات الحمل. استخدم --exact لفرض توقيت دقيق، أو --stagger 30s لتحديد نافذة صريحة (لجداول Cron فقط).

يستخدم يوم الشهر ويوم الأسبوع منطق OR

تُحلَّل تعبيرات Cron بواسطة croner. عندما لا يكون كل من حقلي يوم الشهر ويوم الأسبوع حرف بدل، يطابق croner إذا طابق أيٌّ من الحقلين، وليس كلاهما. هذا هو سلوك Vixie cron القياسي.

# المقصود: "الساعة 9 صباحًا في اليوم الخامس عشر، فقط إذا صادف يوم الاثنين"# الفعلي:   "الساعة 9 صباحًا في كل يوم خامس عشر، والساعة 9 صباحًا في كل يوم اثنين"0 9 15 * 1

يؤدي هذا إلى التشغيل نحو 5-6 مرات شهريًا بدلًا من 0-1 مرة شهريًا. لاشتراط تحقق الشرطين، استخدم معدّل يوم الأسبوع + الخاص بـ croner‏ (0 9 15 * +1)، أو جدوِل وفق أحد الحقلين وتحقق من الآخر في مطالبة مهمتك أو أمرها.

مشغّلات الأحداث (مراقبات الشروط)

يضيف مشغّل الحدث برنامجًا نصيًا بلا واجهة لشرط إلى جدول every أو cron. يقيّم 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: "Investigate the CI status change." },}

يجب أن يعيد البرنامج النصي { fire, message?, state? }. تتوفر حالة JSON السابقة بوصفها trigger.state مجمّدة بعمق؛ أعد قيمة state جديدة للاحتفاظ بها. الحد الأقصى للحالة هو 16 KB. عندما تتضمن نتيجة تشغيل message، يلحقها Cron بنص حدث النظام أو رسالة دورة الوكيل قبل التنفيذ. يعطّل once: true المهمة بعد أول حمولة مُشغَّلة ناجحة لها.

يحتفظ fire: false بحالة التقييم والعدادات، ثم يعيد الجدولة دون إنشاء سجل تشغيل. إذا فشل تشغيل حمولة مُشغَّلة، فلا تُحفَظ قيمة state المعادة — يرى التقييم التالي الحالة السابقة ويمكنه التشغيل مجددًا، لذلك اكتب البرامج النصية على هيئة عمليات تحقق للقراءة فقط، واحتفظ بالإجراءات داخل الحمولة. لمجداول المشغّلات حد أدنى قابل للضبط للفاصل الزمني (30 ثانية افتراضيًا). لكل تقييم ميزانية وقت فعلي قدرها 30 ثانية وما يصل إلى 5 استدعاءات للأدوات.

أنشئ مراقبًا من ملف برنامج نصي محلي (- يقرأ البرنامج النصي من stdin):

openclaw cron add \  --name "PR CI watcher" \  --every 30s \  --trigger-script ./watch-pr-ci.js \  --message "Respond to the CI status change" \  --session isolated

الحمولات

تحمل كل مهمة نوع حمولة واحدًا بالضبط، ويُختار بواسطة العلامة:

خيارات دورة الوكيل

يعيّن --model النموذج الأساسي للمهمة؛ ولا يستبدل تجاوز /model للجلسة، لذلك تظل سلاسل النماذج الاحتياطية المُعدّة مطبّقة فوقه. يؤدي النموذج الذي لا يمكن حله أو غير المسموح به إلى فشل التشغيل بخطأ تحقق صريح بدلًا من الرجوع بصمت إلى النموذج الافتراضي. إذا كانت لدى مهمة قيمة --model ولكن ليست لديها قائمة نماذج احتياطية صريحة أو مُعدّة، يمرّر OpenClaw تجاوزًا فارغًا للنماذج الاحتياطية بدلًا من إلحاق النموذج الأساسي للوكيل بصمت بوصفه هدفًا مخفيًا لإعادة المحاولة.

أسبقية اختيار النموذج للمهام المعزولة، من الأعلى إلى الأدنى:

1. حمولة كل مهمة model (إعداد صريح؛ يؤدي النموذج غير المسموح به إلى فشل التشغيل)
2. تجاوز نموذج خطاف Gmail (فقط عندما يكون التشغيل صادرًا من Gmail ويكون ذلك التجاوز مسموحًا به)
3. تجاوز نموذج جلسة Cron المخزّن الذي حدده المستخدم
4. اختيار نموذج الوكيل/النموذج الافتراضي

يتبع الوضع السريع الاختيار الفعلي الذي تم حله. إذا كان إعداد النموذج المحدد يتضمن params.fastMode، يستخدمه Cron المعزول افتراضيًا؛ ويظل تجاوز الجلسة المخزّن fastMode (ثم تجاوز الوكيل fastModeDefault) متفوقًا على إعداد النموذج في كلا الاتجاهين. يستخدم الوضع التلقائي حد params.fastAutoOnSeconds الخاص بالنموذج، وتكون قيمته الافتراضية 60 ثانية.

إذا واجه تشغيل عملية تسليم مباشرة بسبب تبديل النموذج، يعيد Cron المحاولة باستخدام المزوّد/النموذج الذي جرى التبديل إليه، ويحفظ ذلك الاختيار (وأي ملف تعريف مصادقة جديد) للتشغيل النشط. إعادة المحاولات محدودة: بعد المحاولة الأولية ومحاولتي تبديل، يُجهض 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 "Queue depth probe" \  --command "scripts/check-queue.sh" \  --command-cwd "/srv/app" \  --announce \  --channel telegram \  --to "-1001234567890"

يخزّن --command <shell> القيمة argv: ["sh", "-lc", <shell>]. استخدم --command-argv '["node","scripts/report.mjs"]' لتنفيذ argv بدقة من دون تحليل الصدفة. تتحكم القيم الاختيارية --command-env KEY=VALUE (قابلة للتكرار)، و--command-input، و--timeout-seconds (الافتراضي 10 دقائق)، و--no-output-timeout-seconds، و--output-max-bytes في بيئة العملية، والإدخال القياسي، وحدود المخرجات.

يُشتق النص المُسلّم من مخرجات العملية: تكون الأولوية لـ stdout غير الفارغ؛ وإذا كان stdout فارغًا وstderr غير فارغ، يُسلّم stderr؛ وإذا وُجدا معًا، يرسل Cron كتلة صغيرة من stdout: / stderr:. يسجّل رمز الخروج 0 التشغيل بالحالة ok؛ بينما يسجّل الخروج غير الصفري، أو الإشارة، أو انتهاء المهلة، أو انتهاء مهلة عدم وجود مخرجات الحالة error، ويمكن أن يؤدي ذلك إلى تشغيل تنبيهات الفشل. يستخدم الأمر الذي لا يطبع سوى NO_REPLY آلية الكبت المعتادة لرمز الصمت في Cron، ولا ينشر أي شيء مجددًا إلى الدردشة.

أنماط التنفيذ

التسليم والمخرجات

استخدم --announce --channel telegram --to "-1001234567890" للتسليم عبر القناة. بالنسبة إلى مواضيع منتدى Telegram، استخدم -1001234567890:topic:123؛ ويقبل OpenClaw أيضًا الاختصار -1001234567890:123 المملوك لـ Telegram. يمكن لمستدعي RPC/الإعداد المباشرين تمرير delivery.threadId كسلسلة نصية أو رقم. تستخدم أهداف Slack/Discord/Mattermost بادئات صريحة (channel:<id>، user:<id>). معرّفات غرف Matrix حساسة لحالة الأحرف؛ استخدم معرّف الغرفة الدقيق أو صيغة room:!room:server من Matrix.

عندما يستخدم تسليم الإعلان channel: "last" أو يحذف channel، يمكن لهدف ذي بادئة مزوّد مثل telegram:123 تحديد القناة قبل أن يرجع Cron إلى سجل الجلسة أو قناة واحدة مُعدّة. لا تُعدّ محددات للمزوّد إلا البادئات التي يعلن عنها Plugin المحمّل. إذا كانت delivery.channel صريحة، فيجب أن تسمّي بادئة الهدف المزوّد نفسه؛ ويُرفض استخدام channel: "whatsapp" مع to: "telegram:123" بدلًا من السماح لـ WhatsApp بتفسير معرّف Telegram على أنه رقم هاتف. تظل بادئات نوع الهدف والخدمة (channel:<id>، user:<id>، imessage:<handle>، sms:<number>) صياغة هدف مملوكة للقناة، وليست محددات للمزوّد.

بالنسبة إلى المهام المعزولة، يكون تسليم الدردشة مشتركًا: إذا كان مسار دردشة متاحًا، يمكن للوكيل استخدام أداة message حتى مع --no-deliver. إذا أرسل الوكيل إلى الهدف المُعدّ/الحالي، يتخطى OpenClaw الإعلان الاحتياطي. بخلاف ذلك، لا تتحكم announce وwebhook وnone إلا فيما يفعله المشغّل بالرد النهائي بعد دور الوكيل.

عندما ينشئ وكيل تذكيرًا معزولًا من دردشة نشطة، يخزّن OpenClaw هدف التسليم المباشر المحفوظ لمسار الإعلان الاحتياطي. قد تكون مفاتيح الجلسة الداخلية بأحرف صغيرة؛ ولا تُعاد صياغة أهداف تسليم المزوّد من تلك المفاتيح عندما يكون سياق الدردشة الحالي متاحًا.

يستخدم تسليم الإعلان الضمني قوائم السماح المُعدّة للقنوات للتحقق من الأهداف القديمة وإعادة توجيهها. موافقات مخزن إقران الرسائل المباشرة ليست مستلمين احتياطيين للأتمتة؛ عيّن 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 # جلب مهمة مخزنة واحدة بصيغة JSONopenclaw 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

تؤدي أرشفة جلسة (من واجهة التحكم، أو عبر sessions.patch { archived: true } من مستدعٍ مسؤول عن إدارة المشغّلين) إلى تعطيل كل مهمة Cron مفعّلة مرتبطة بتلك الجلسة: جلسة cron:<jobId> المعزولة الخاصة بها، أو هدف session:<key>، أو مسار تسليم/إيقاظ sessionKey. لا تؤدي استعادة الجلسة إلى إعادة تمكين تلك المهام؛ استخدم openclaw cron enable <jobId>. تعرض الجلسات التي لها مهمة مرتبطة مفعّلة شارة ساعة في الشريط الجانبي لواجهة التحكم.

يعود openclaw cron run <jobId> بعد إدراج التشغيل اليدوي في قائمة الانتظار. استخدم --wait لخطافات إيقاف التشغيل أو نصوص الصيانة البرمجية أو غيرها من عمليات الأتمتة التي يجب أن تتوقف حتى ينتهي التشغيل المدرج في قائمة الانتظار؛ إذ يستطلع runId المُعاد (مهلة افتراضية 10m، وفاصل استطلاع 2s) ويخرج بالرمز 0 للحالة ok، وبرمز غير صفري للحالات error أو skipped أو عند انتهاء مهلة الانتظار.

تعيد أداة الوكيل cron ملخصات موجزة للمهام (id، وname، وenabled، وnextRunAtMs، وscheduleKind، وlastRunStatus) من cron(action: "list")؛ استخدم cron(action: "get", jobId: "...") للحصول على تعريف كامل لمهمة واحدة. يمكن لمستدعي Gateway المباشرين تمرير compact: true إلى cron.list؛ ويؤدي حذفه إلى الاحتفاظ بالاستجابة الكاملة مع معاينات التسليم.

openclaw cron create اسم مستعار لـ openclaw cron add. يمكن للمهام الجديدة استخدام جدول زمني موضعي ("0 9 * * 1" أو "every 1h" أو "20m" أو طابع زمني بتنسيق ISO) تتبعه مطالبة وكيل موضعية. استخدم --webhook <url> في cron add|create أو cron edit لإرسال حمولة التشغيل المكتمل بأسلوب POST إلى نقطة نهاية HTTP؛ ولا يمكن الجمع بين تسليم Webhook وعلامات تسليم الدردشة (--announce، و--channel، و--to، و--thread-id، و--account). في cron edit، تُلغي --clear-channel و--clear-to و--clear-thread-id و--clear-account تعيين حقول التوجيه تلك كلٌّ على حدة (ويُرفض كل منها عند استخدامه مع علامة التعيين المطابقة له) — بخلاف --no-deliver، الذي يعطّل فقط تسليم الرجوع الاحتياطي للمشغّل.

Webhooks

يمكن لـ Gateway إتاحة نقاط نهاية Webhook عبر HTTP للمشغلات الخارجية. مكّنها في الإعدادات:

{  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

اربط مشغلات صندوق وارد Gmail بـ OpenClaw عبر Google PubSub.

الإعداد باستخدام المعالج (موصى به)

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

يكتب هذا إعدادات hooks.gmail، ويمكّن الإعداد المسبق لـ Gmail، ويستخدم Tailscale Funnel افتراضيًا لنقطة نهاية الدفع (--tailscale funnel|serve|off).

التشغيل التلقائي لـ 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",    maxConcurrentRuns: 8,    triggers: {      enabled: false,      minIntervalMs: 30000,    },    retry: {      maxAttempts: 3,      backoffMs: [30000, 60000, 300000],      retryOn: ["rate_limit", "overloaded", "network", "timeout", "server_error"],    },    webhookToken: "replace-with-dedicated-webhook-token",    sessionRetention: "24h",  },}

قيم retry أعلاه هي القيم الافتراضية: ما يصل إلى 3 محاولات إعادة باستخدام تراجع 30s/60s/5m، مع إعادة المحاولة للفئات الخمس العابرة جميعها. يُرسل webhookToken بصفته Authorization: Bearer <token> في طلبات POST الخاصة بـ Webhook لـ Cron.

يحدّ maxConcurrentRuns كلًا من إرسال Cron المجدول وتنفيذ دور الوكيل المعزول، وتبلغ قيمته الافتراضية 8. تستخدم أدوار وكيل Cron المعزولة داخليًا مسار التنفيذ cron-nested المخصص للطابور، لذا تتيح زيادة هذه القيمة لعمليات تشغيل LLM المستقلة الخاصة بـ Cron التقدم بالتوازي بدلًا من بدء أغلفة Cron الخارجية فقط. لا يوسّع هذا الإعداد مسار nested المشترك غير الخاص بـ Cron.

يمثل cron.store مفتاح تخزين منطقيًا ومسار ترحيل لأداة doctor، وليس ملف 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 — أدوار دورية في الجلسة الرئيسية
• المنطقة الزمنية — إعداد المنطقة الزمنية