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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

البدء السريع

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

openclaw cron list
openclaw cron get <job-id>
openclaw cron show <job-id>

openclaw cron runs --id <job-id>

​

كيف يعمل Cron

• يعمل Cron داخل عملية Gateway (وليس داخل النموذج).
• تبقى تعريفات المهام محفوظة في ~/.openclaw/cron/jobs.json كي لا تؤدي إعادة التشغيل إلى فقدان الجداول.
• تبقى حالة التنفيذ وقت التشغيل محفوظة بجانبها في ~/.openclaw/cron/jobs-state.json. إذا كنت تتبع تعريفات Cron في git، فتتبع jobs.json وضع jobs-state.json في gitignore.
• بعد التقسيم، يمكن لإصدارات OpenClaw الأقدم قراءة jobs.json لكنها قد تعامل المهام كأنها جديدة لأن حقول وقت التشغيل أصبحت الآن في jobs-state.json.
• عند تحرير jobs.json أثناء تشغيل Gateway أو توقفه، يقارن OpenClaw حقول الجدولة المتغيرة مع بيانات تعريف خانة وقت التشغيل المعلقة ويمسح قيم nextRunAtMs القديمة. أما إعادة الكتابة التي تقتصر على التنسيق أو ترتيب المفاتيح فقط فتحافظ على الخانة المعلقة.
• تنشئ كل تنفيذات Cron سجلات مهام في الخلفية.
• عند بدء تشغيل Gateway، يعاد جدولة مهام دور الوكيل المعزولة المتأخرة خارج نافذة اتصال القناة بدلا من إعادة تشغيلها فورا، كي يبقى بدء تشغيل Discord/Telegram وإعداد الأوامر الأصلية مستجيبا بعد إعادة التشغيل.
• تحذف المهام أحادية التنفيذ (--at) نفسها تلقائيا بعد النجاح افتراضيا.
• تغلق تشغيلات Cron المعزولة، وفق أفضل جهد، علامات تبويب/عمليات المتصفح المتتبعة لجلسة cron:<jobId> الخاصة بها عند اكتمال التشغيل، كي لا تترك أتمتة المتصفح المنفصلة عمليات يتيمة خلفها.
• يمكن لتشغيلات Cron المعزولة التي تتلقى منحة التنظيف الذاتي الضيقة الخاصة بـ Cron أن تظل قادرة على قراءة حالة المجدول، وقائمة مفلترة ذاتيا بمهمتها الحالية، وسجل تشغيل تلك المهمة، بحيث يمكن لفحوصات الحالة/Heartbeat فحص جدولها الخاص دون الحصول على وصول أوسع لتعديل Cron.
• تحمي تشغيلات Cron المعزولة أيضا من ردود الإقرار القديمة. إذا كانت النتيجة الأولى مجرد تحديث حالة مؤقت (on it، وpulling everything together، وتلميحات مشابهة) ولم يعد أي تشغيل لوكيل فرعي تابع مسؤولا عن الإجابة النهائية، يعيد OpenClaw طلب النتيجة الفعلية مرة واحدة قبل التسليم.
• تفضل تشغيلات Cron المعزولة بيانات تعريف رفض التنفيذ المنظمة من التشغيل المضمن، ثم تعود إلى علامات الملخص/المخرجات النهائية المعروفة مثل 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 الطويلة كي تظهر إخفاقات البدء البارد/المصادقة/السياق بسرعة بدلا من انتظار ميزانية المهمة الكاملة.

​

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

​

يستخدم يوم الشهر ويوم الأسبوع منطق 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

​

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

​

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

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

​

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

• يعيّن 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 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

​

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

​

إدارة المهام

# List all jobs
openclaw cron list

# Get one stored job as JSON
openclaw cron get <jobId>

# Show one job, including resolved delivery route
openclaw cron show <jobId>

# 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

​

الإعدادات

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