​

المهام المجدولة (Cron)

​

بدء سريع

# Add a one-shot reminder
openclaw cron add \
  --name "Reminder" \
  --at "2026-02-01T16:00:00Z" \
  --session main \
  --system-event "Reminder: check the cron docs draft" \
  --wake now \
  --delete-after-run

# Check your jobs
openclaw cron list

# See run history
openclaw cron runs --id <job-id>

​

كيف يعمل cron

• يعمل Cron داخل عملية Gateway (وليس داخل النموذج).
• تُحفَظ المهام في ~/.openclaw/cron/jobs.json بحيث لا تؤدي عمليات إعادة التشغيل إلى فقدان الجداول.
• تنشئ جميع عمليات تنفيذ cron سجلات المهام الخلفية.
• تُحذف المهام ذات التشغيل الواحد (--at) تلقائيًا بعد النجاح افتراضيًا.
• تحاول عمليات cron المعزولة، بأفضل جهد ممكن، إغلاق علامات تبويب/عمليات المتصفح المتتبعة الخاصة بجلسة cron:<jobId> عند اكتمال التشغيل، حتى لا تترك أتمتة المتصفح المفصولة عمليات يتيمة وراءها.
• تحمي عمليات cron المعزولة أيضًا من ردود الإقرار القديمة. إذا كانت النتيجة الأولى مجرد تحديث حالة مؤقت (on it وpulling everything together وتلميحات مشابهة) ولم يعد أي تشغيل تابع منحدر لا يزال مسؤولًا عن الإجابة النهائية، فإن OpenClaw يعيد المطالبة مرة واحدة للحصول على النتيجة الفعلية قبل التسليم.

​

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

​

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

​

خيارات الحمولة للمهام المعزولة

• --message: نص المطالبة (مطلوب للمهام المعزولة)
• --model / --thinking: تجاوزات النموذج ومستوى التفكير
• --light-context: تخطي حقن ملف تهيئة مساحة العمل
• --tools exec,read: تقييد الأدوات التي يمكن للمهمة استخدامها

1. تجاوز نموذج hook الخاص بـ Gmail (عندما يكون التشغيل قادمًا من Gmail ويكون هذا التجاوز مسموحًا)
2. model في حمولة كل مهمة
3. تجاوز النموذج المخزن لجلسة cron
4. اختيار نموذج الوكيل/الافتراضي

​

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

• يعيّن cron.failureDestination القيمة الافتراضية العامة لإشعارات الفشل.
• يتجاوز job.delivery.failureDestination ذلك لكل مهمة.
• إذا لم يُضبط أي منهما وكانت المهمة تسلّم بالفعل عبر announce، فإن إشعارات الفشل تعود الآن إلى هدف announce الأساسي هذا.
• لا يكون delivery.failureDestination مدعومًا إلا في المهام ذات sessionTarget="isolated" ما لم يكن وضع التسليم الأساسي هو webhook.

​

أمثلة CLI

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

openclaw cron add \
  --name "Morning brief" \
  --cron "0 7 * * *" \
  --tz "America/Los_Angeles" \
  --session isolated \
  --message "Summarize overnight updates." \
  --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

​

Webhooks

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

​

المصادقة

• Authorization: Bearer <token> (موصى به)
• x-openclaw-token: <token>

​

POST /hooks/wake

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"}'

• text (مطلوب): وصف الحدث
• mode (اختياري): now (الافتراضي) أو next-heartbeat

​

POST /hooks/agent

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-mini"}'

​

Hooks المعينة (POST /hooks/<name>)

​

الأمان

• أبقِ نقاط نهاية hook خلف local loopback أو tailnet أو reverse proxy موثوق.
• استخدم رمز hook مخصصًا؛ لا تعِد استخدام رموز مصادقة gateway.
• أبقِ hooks.path على مسار فرعي مخصص؛ يتم رفض /.
• اضبط hooks.allowedAgentIds لتقييد التوجيه الصريح لـ agentId.
• أبقِ hooks.allowRequestSessionKey=false ما لم تكن تحتاج إلى جلسات يحددها المتصل.
• إذا فعّلت hooks.allowRequestSessionKey، فاضبط أيضًا hooks.allowedSessionKeyPrefixes لتقييد أشكال مفاتيح الجلسات المسموح بها.
• تُغلَّف حمولات hook بحدود أمان افتراضيًا.

​

تكامل Gmail PubSub

​

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

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

​

التشغيل التلقائي لـ Gateway

​

إعداد يدوي لمرة واحدة

1. حدّد مشروع GCP الذي يملك عميل OAuth المستخدم بواسطة gog:

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

2. أنشئ topic وامنح Gmail صلاحية دفع النشر:

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

3. ابدأ المراقبة:

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 jobs
openclaw cron list

# Edit a job
openclaw cron edit <jobId> --message "Updated prompt" --model "opus"

# Force run a job now
openclaw cron run <jobId>

# Run only if due
openclaw cron run <jobId> --due

# View run history
openclaw cron runs --id <jobId> --limit 50

# Delete a job
openclaw cron remove <jobId>

# Agent selection (multi-agent setups)
openclaw cron add --name "Ops sweep" --cron "0 6 * * *" --session isolated --message "Check ops queue" --agent ops
openclaw cron edit <jobId> --clear-agent

• يغيّر openclaw cron add|edit --model ... النموذج المحدد للمهمة.
• إذا كان النموذج مسموحًا، يصل هذا المزوّد/النموذج المحدد نفسه إلى تشغيل الوكيل المعزول.
• إذا لم يكن مسموحًا، يحذّر cron ويعود إلى اختيار نموذج الوكيل/الافتراضي للمهمة.
• تظل سلاسل التراجع المهيأة مطبقة، لكن تجاوز --model العادي من دون قائمة تراجع صريحة لكل مهمة لم يعد ينتقل إلى النموذج الأساسي للوكيل باعتباره هدف إعادة محاولة إضافيًا صامتًا.

​

الإعدادات

{
  cron: {
    enabled: true,
    store: "~/.openclaw/cron/jobs.json",
    maxConcurrentRuns: 1,
    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 },
  },
}

​

استكشاف الأخطاء وإصلاحها

​

تسلسل الأوامر

openclaw status
openclaw gateway status
openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw system heartbeat last
openclaw logs --follow
openclaw doctor

​

Cron لا يعمل

• تحقّق من cron.enabled ومتغير البيئة OPENCLAW_SKIP_CRON.
• أكّد أن Gateway يعمل بشكل مستمر.
• بالنسبة لجداول cron، تحقّق من المنطقة الزمنية (--tz) مقارنة بالمنطقة الزمنية للمضيف.
• تعني reason: not-due في مخرجات التشغيل أنه تم التحقق من التشغيل اليدوي باستخدام openclaw cron run <jobId> --due وأن المهمة لم يحن موعدها بعد.

​

تم تشغيل Cron لكن لم يحدث تسليم

• يعني وضع التسليم none أنه لا يُتوقع إرسال أي رسالة خارجية.
• يعني غياب/عدم صحة هدف التسليم (channel/to) أنه تم تخطي الإرسال الخارجي.
• تعني أخطاء مصادقة القناة (unauthorized وForbidden) أن التسليم تم حجبه بواسطة بيانات الاعتماد.
• إذا أعاد التشغيل المعزول فقط الرمز الصامت (NO_REPLY / no_reply)، فإن OpenClaw يحجب التسليم الخارجي المباشر ويحجب أيضًا مسار الملخص الاحتياطي الموضوع في قائمة الانتظار، لذلك لا يُنشر أي شيء إلى الدردشة.
• بالنسبة للمهام المعزولة المملوكة لـ cron، لا تتوقع من الوكيل استخدام أداة الرسائل كحل احتياطي. فالمشغّل يملك التسليم النهائي؛ ويبقي --no-deliver التشغيل داخليًا بدلًا من السماح بإرسال مباشر.

​

ملاحظات مهمة حول المنطقة الزمنية

• يستخدم Cron بدون --tz المنطقة الزمنية لمضيف gateway.
• تُعامل جداول at التي لا تحتوي على منطقة زمنية على أنها UTC.
• يستخدم activeHours في heartbeat تحليل المنطقة الزمنية المهيأ.

​

ذو صلة

• الأتمتة والمهام — لمحة سريعة عن جميع آليات الأتمتة
• المهام الخلفية — سجل المهام لتنفيذات cron
• Heartbeat — دورات الجلسة الرئيسية الدورية
• المنطقة الزمنية — إعداد المنطقة الزمنية