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

​

البدء السريع

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 list
openclaw cron get <job-id>
openclaw cron show <job-id>

openclaw cron runs --id <job-id>

​

كيفية عمل cron

• يعمل Cron داخل عملية Gateway (وليس داخل النموذج).
• تستمر تعريفات المهام وحالة التشغيل وسجل التشغيل في قاعدة بيانات حالة SQLite المشتركة في OpenClaw، لذلك لا تؤدي عمليات إعادة التشغيل إلى فقدان الجداول.
• عند الترقية، شغّل openclaw doctor --fix لاستيراد ملفات ~/.openclaw/cron/jobs.json وjobs-state.json وruns/*.jsonl القديمة إلى SQLite وإعادة تسميتها بلاحقة .migrated. يتم تخطي صفوف المهام المشوهة من وقت التشغيل ونسخها إلى jobs-quarantine.json لإصلاحها أو مراجعتها لاحقًا.
• ما زال cron.store يحدد مفتاح مخزن cron المنطقي ومسار استيراد doctor. بعد الاستيراد، لم يعد تعديل ملف JSON ذلك يغير مهام cron النشطة؛ استخدم openclaw cron add|edit|remove أو طرائق RPC الخاصة بـ cron في Gateway بدلًا من ذلك.
• تنشئ كل عمليات تنفيذ cron سجلات مهمة خلفية.
• عند بدء تشغيل Gateway، يُعاد جدولة مهام دورات الوكيل المعزولة المتأخرة خارج نافذة اتصال القناة بدلًا من إعادة تشغيلها فورًا، وبذلك يبقى بدء تشغيل Discord/Telegram وإعداد الأوامر الأصلية مستجيبين بعد عمليات إعادة التشغيل.
• تُحذف المهام لمرة واحدة (--at) تلقائيًا بعد النجاح افتراضيًا.
• تغلق تشغيلات cron المعزولة، قدر الإمكان، علامات تبويب/عمليات المتصفح المتتبعة لجلسة cron:<jobId> الخاصة بها عند اكتمال التشغيل، حتى لا تترك أتمتة المتصفح المنفصلة عمليات يتيمة.
• تستطيع تشغيلات cron المعزولة التي تتلقى منحة التنظيف الذاتي الضيقة الخاصة بـ cron قراءة حالة المجدول، وقائمة ذاتية التصفية لمهمتها الحالية، وسجل تشغيل تلك المهمة، حتى تتمكن فحوصات الحالة/Heartbeat من فحص جدولها الخاص دون الحصول على وصول أوسع لتعديل cron.
• تحمي تشغيلات cron المعزولة أيضًا من ردود الإقرار القديمة. إذا كانت النتيجة الأولى مجرد تحديث حالة مؤقت (on it، وpulling everything together، وتلميحات مشابهة) ولم يعد أي تشغيل وكيل فرعي تابع مسؤولًا عن الإجابة النهائية، يعيد OpenClaw المطالبة مرة واحدة للحصول على النتيجة الفعلية قبل التسليم.
• تستخدم تشغيلات cron المعزولة بيانات وصفية منظمة لرفض التنفيذ من التشغيل المضمن، بما في ذلك أغلفة node-host UNAVAILABLE التي تبدأ رسالة الخطأ المتداخلة فيها بـ SYSTEM_RUN_DENIED أو INVALID_REQUEST، بحيث لا يُبلّغ عن أمر محظور كتشغيل ناجح، بينما لا يُعامل نثر المساعد العادي كرفض.
• تتعامل تشغيلات cron المعزولة أيضًا مع إخفاقات الوكيل على مستوى التشغيل كأخطاء مهام حتى عندما لا تُنتج حمولة رد، بحيث تزيد إخفاقات النموذج/المزوّد عدادات الأخطاء وتطلق إشعارات الفشل بدلًا من اعتبار المهمة ناجحة.
• عندما تصل مهمة دورة وكيل معزولة إلى timeoutSeconds، يجهض cron تشغيل الوكيل الأساسي ويمنحه نافذة تنظيف قصيرة. إذا لم يُفرّغ التشغيل، فإن التنظيف المملوك لـ Gateway يزيل قسرًا ملكية جلسة ذلك التشغيل قبل أن يسجل cron انتهاء المهلة، حتى لا يبقى عمل الدردشة المنتظر خلف جلسة معالجة قديمة.
• إذا توقفت دورة وكيل معزولة قبل بدء المشغل أو قبل أول استدعاء للنموذج، يسجل cron انتهاء مهلة خاصًا بالمرحلة مثل setup timed out before runner start أو stalled before first model call (last phase: context-engine). تغطي هذه المراقبات المزوّدين المضمنين والمزوّدين المدعومين بـ CLI قبل بدء عملية CLI الخارجية فعليًا، وتُحدد بسقوف مستقلة عن قيم timeoutSeconds الطويلة حتى تظهر إخفاقات البدء البارد/المصادقة/السياق بسرعة بدلًا من انتظار ميزانية المهمة الكاملة.
• إذا كنت تستخدم cron النظامي أو مجدولًا خارجيًا آخر لتشغيل openclaw agent، فغلّفه بتصعيد قتل صارم حتى لو كان CLI يتعامل مع SIGTERM/SIGINT. تطلب التشغيلات المدعومة بـ Gateway من Gateway إجهاض التشغيلات المقبولة؛ وتتلقى تشغيلات الرجوع المحلية والمضمنة إشارة الإجهاض نفسها. بالنسبة إلى GNU timeout، فضّل timeout -k 60 600 openclaw agent ... على timeout 600 ... فقط؛ فقيمة -k هي مسند المشرف إذا تعذر تفريغ العملية. بالنسبة إلى وحدات systemd، حافظ على الشكل نفسه باستخدام إشارة إيقاف SIGTERM مع نافذة سماح مثل TimeoutStopSec قبل أي قتل نهائي. إذا أعادت محاولة استخدام --run-id بينما ما زال تشغيل Gateway الأصلي نشطًا، يُبلّغ عن النسخة المكررة على أنها قيد التنفيذ بدلًا من بدء تشغيل ثانٍ.

​

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

​

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

# 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

​

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

​

حمولات الأوامر

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

​

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

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

​

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

​

لغة المخرجات

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

• يعيّن cron.failureDestination افتراضيًا عامًا لإشعارات الفشل.
• يتجاوز job.delivery.failureDestination ذلك لكل مهمة.
• إذا لم يُضبط أي منهما وكانت المهمة تسلّم بالفعل عبر announce، ترجع إشعارات الفشل الآن إلى هدف الإعلان الأساسي ذلك.
• لا يكون delivery.failureDestination مدعومًا إلا في مهام sessionTarget="isolated" ما لم يكن وضع التسليم الأساسي webhook.
• يختار failureAlert.includeSkipped: true لمهمة أو سياسة تنبيه Cron عالمية الدخول في تنبيهات التشغيل المتخطى المتكررة. تحتفظ عمليات التشغيل المتخطاة بعداد تخطٍ متتالٍ منفصل، لذلك لا تؤثر في تراجع أخطاء التنفيذ.

​

أمثلة 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

{
  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":"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

​

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

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

​

بدء Gateway تلقائيًا

​

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

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

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

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

​

إدارة المهام

# سرد كل المهام
openclaw cron list

# جلب مهمة واحدة مخزنة بصيغة JSON
openclaw cron get <jobId>

# عرض مهمة واحدة، بما في ذلك مسار التسليم المحلول
openclaw cron show <jobId>

# تعديل مهمة
openclaw cron edit <jobId> --message "Updated prompt" --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 * * *" "Check ops queue" --name "Ops sweep" --session isolated --agent ops
openclaw cron edit <jobId> --clear-agent

​

الإعداد

{
  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 },
  },
}

​

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

​

سلّم الأوامر

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
• Heartbeat — دورات الجلسة الرئيسية الدورية
• المنطقة الزمنية — إعداد المنطقة الزمنية