Skip to content

مهام Automations المجدولة: cron والتذكيرات والتشغيل عبر Webhook ​

قسّم جدول الاختيار في الدرس السابق «إنجاز Claw للمهام أثناء غيابك» إلى عدة آليات؛ وفي هذا الدرس سنشرح بالتفصيل الآلية الأكثر استخدامًا وهي OpenClaw المهام المجدولة (الاسم الرسمي Automations). ما هي؟ بجملة واحدة: OpenClaw المجدول المدمج — تُحفظ المهام في قاعدة حالة SQLite مشتركة، ويوقظ Gateway الوكيل عند حلول الموعد، ويمكن إيصال النتائج إلى قنوات الدردشة أو نقاط webhook، أو عدم إرسالها إطلاقًا.

نقطة الدخول عبر سطر الأوامر هي openclaw automations، وopenclaw cron هو اسم بديل لنفس مجموعة الأوامر — إن رأيت درسًا قديمًا يذكر openclaw cron فلا تقلق، فهو الشيء نفسه. جميع الأمثلة مبنية على OpenClaw v2026.10.9.

ماذا ستستطيع أن تفعل بعد هذا الدرس ​

  • إنشاء تذكيرات لمرة واحدة باستخدام --at، ومهام متكررة باستخدام --cron / --every، تظهر في openclaw automations list وتعمل تلقائيًا عند حلول موعدها
  • إيصال نتائج المهام إلى قناة الدردشة التي تحددها (--announce --channel --to) أو نقطة webhook (--webhook)
  • إدارة المهام المنشأة: عرض سجل التشغيل، والتعطيل المؤقت، وتعديل نص الأوامر، والتشغيل الفوري القسري
  • تفعيل Webhook الوارد ليتيح للخدمات الخارجية (CI، المراقبة، السكربتات) إيقاظ Claw عبر HTTP بشكل استباقي
  • تجنّب فخّين كلاسيكيين: فخ OR بين اليوم/يوم الأسبوع في تعبيرات cron، وثلاثة إعدادات مناطق زمنية لا علاقة لأحدها بالآخر

معاناتك الحالية ​

  • كل صباح عند الاستيقاظ عليك تصفح أكثر من عشرة مواقع ورسائل مجموعات بنفسك لتكوين صورة عن «ما حدث ليلة أمس»
  • «ذكّرني بإرسال التقرير الأسبوعي قبل انتهاء الدوام» لا يزال يعتمد على ذاكرتك؛ مساعد الذكاء الاصطناعي لا يفيد إلا عند سؤاله، وبمجرد ابتعادك يتوقف
  • تريد أن يطّلع الذكاء الاصطناعي على سجلات CI فور انتهاء تشغيله، لكنك لا تعرف كيف «تُطعم» له الأحداث الخارجية

متى تستخدم هذه الطريقة ​

عندما تحتاج إلى:

  • العمل بإيقاع ثابت: تلخيص الأخبار كل صباح في الساعة 7، وتذكير بالتقرير الأسبوعي كل جمعة، وفحص عمق قائمة الانتظار كل 15 دقيقة
  • تذكير لمرة واحدة: ذكّرني بعد 20 دقيقة، أو نبهني صباح الاثنين القادم لمراجعة قائمة التحقق
  • التشغيل بأحداث خارجية: إيقاظ Claw للعمل عند دفع الكود، أو اكتمال البناء، أو انتهاء تشغيل سكربت

ولا تريد:

  • بناء مجموعة crontab + سكربتات + خطوط إشعارات بنفسك
  • مراقبة نافذة الدردشة 24 ساعة بانتظار الرسائل

💡 غير متأكد أي آلية تستخدم؟

عُد إلى جدول الاختيار في الدرس السابق: الجدولة الدورية = Automations (هذا الدرس)؛ التذكير الدقيق لمرة واحدة = --at في Automations؛ التشغيل الخارجي = Webhooks (الخطوة 4 من هذا الدرس)؛ سكربتات دورة حياة الجلسة = Hooks؛ الأوامر الدائمة المكتوبة في مساحة العمل = Standing Orders. انظر دليل مرحلة سير العمل الفعال.

🎒 التحضير قبل البدء ​

  • أكملت دليل مرحلة سير العمل الفعال: يعمل Gateway حاليًا، وتم ربط نموذج واحد على الأقل (/model status يُظهر النموذج الحالي)
  • لديك صلاحية طرفية على الجهاز الذي يعمل عليه Gateway — تتطلب أوامر automations أن يكون Gateway قيد التشغيل، كما تتطلب جميع عمليات التغيير (add/create، edit، remove، run) صلاحية operator.admin
  • تريد إرسال النتائج إلى Feishu أو WeChat Work أو Telegram أو Slack؟ اربط قناة واحدة على الأقل أولًا في سيناريوهات عملية؛ يمكنك التعلم دون ربط أي قناة باستخدام --no-deliver أو بالاكتفاء بمراجعة سجل التشغيل
  • كوب من الماء ☕ — هذا الدرس كله أوامر قصيرة، انسخها وشغّلها

الفكرة الأساسية ​

المهمة المجدولة (job) = الجدولة (متى تعمل) + الحِمل (ماذا تنفّذ) + الإيصال (إلى أين تُرسل النتيجة). لكل بُعد من الأبعاد الثلاثة عدة خيارات، تعرّف عليها أولًا وسنستخدمها خطوة بخطوة أدناه:

خمسة أنواع من الجدولة (متى يُطلق التشغيل):

النوعوسيط CLIالمعنى
at--atوقت لمرة واحدة: طابع زمني بصيغة ISO 8601، أو وقت نسبي مثل 20m
every--everyفاصل زمني ثابت: 10m، 1h، 1d
cron--cron5/6 حقل تعبير cron، مع إمكانية ضبط المنطقة الزمنية --tz
on-exit--on-exitيُطلق مرة واحدة عند خروج الأمر المراقَب
stream--stream-commandتُجمَّع أسطر إخراج الأمر الدائم في دفعات لتشغيله

أربعة أنواع من الأحمال (ما الذي يُشغَّل):

الحملوسيط CLIالمعنى
حدث نظام--system-eventيُطلق دورة عادية واحدة في الجلسة الرئيسية للوكيل المالك (الخيار الأول للتذكيرات)
رسالة وكيل--messageدورة نموذج كاملة، تجعل Claw ينفذ العمل فعليًا
أمر--commandيشغّل أمر shell على مضيف Gateway دون استدعاء النموذج
سكربت--scriptسكربت code-mode بلا واجهة، يمكنه استخدام أدوات الوكيل المالك

أربعة أنواع من جلسات التنفيذ (أين يُشغَّل): --session main (الجلسة الرئيسية، مناسبة للتذكيرات)، isolated (جلسة جديدة كليًا في كل مرة، مناسبة للمهام الدورية من نوع التقارير)، current (مرتبطة بالمحادثة التي أنشأته)، session:<id> (جلسة دائمة تتراكم فيها السياق عبر التشغيلات).

ثلاثة أنواع من التسليم (إلى أين تذهب النتائج): --announce (تُرسَل إلى قناة الدردشة)، --webhook (تُرسَل POST إلى نقطة نهاية HTTP)، --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 ثانية، ويُستخدم للتأكد من أن السلسلة كاملة (إنشاء ← تخزين ← تشغيل في الموعد) تعمل.

bash
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 هو محتوى التذكير.

يجب أن ترى: تنفيذ الأمر بنجاح دون أخطاء. ثم تحقق من أنه حُفظ:

bash
openclaw automations list

يجب أن ترى: ظهور مهمة باسم Calendar check في القائمة مع معرّف الوظيفة الخاص بها — سجّل هذا المعرّف، فستحتاجه في كل ما يلي.

  • تحقق صغير: يمكن رؤية Calendar check في openclaw automations list

يمكن أيضًا كتابة وقت مطلق مباشرة. ما يلي معدَّل من مثال البدء السريع الرسمي (حُذف منه فقط --wake now المهجور)، و--delete-after-run يعني حذف المهمة تلقائيًا بعد نجاح التشغيل دون ترك مخلفات:

bash
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 الإيقاع، وتحدد وسائط التسليم مكان وصول النتائج.

bash
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…

يجب أن ترى: نجاح الإنشاء. add/create وlist وshow كلها تعرض معاينة لمسار التسليم بعد التحليل — إذا تعذّر تحليل الوجهة، ستخبرك هنا بالسبب، دون انتظار صباح اليوم التالي لتكتشف عدم وصول شيء.

  • تحقق صغير: openclaw automations show <job-id> يعرض مسار التسليم بعد التحليل

ثلاث ملاحظات إضافية:

  • صيغة الهدف تختلف باختلاف القناة: لتوصيل منصات IM المحلية مثل Feishu وWeChat Work وكتابة الأهداف فيها، راجع سيناريوهات عملية (توصيل Feishu، توصيل WeChat Work). على المضيفات التي ضُبطت فيها قنوات متعددة، يجب تزويد المهام isolated بـ --channel (إلا إذا كان --to يحمل بادئة provider أو احتفظ بمسار الجلسة).
  • يمكن التعلم دون توصيل قناة: المهام isolated التي أنشئت عبر CLI تحتاج إلى واحد من ثلاثة: مسار قناة قابل للتحليل، أو تسليم webhook، أو --no-deliver؛ أضف --no-deliver أثناء التدريب، فتذهب النتائج إلى سجل التشغيل فقط.
  • لا تدعها تقصف الدردشة: اتفق في توجيه مهام الفحص الدورية على أن «يرد بـ NO_REPLY فقط عند عدم حدوث شيء» — عندما تكون الرد النهائي بأكمله هو NO_REPLY بالأحرف الكبيرة، يُتخطى التسليم بصمت، بينما تُكتب سجلات التنفيذ في التاريخ كالمعتاد.

تريد استخدام webhook بدلًا من قناة الدردشة؟ استبدل وسائط التسليم بـ --webhook (وهو متنافٍ مع --announce/--channel/--to ولا يمكن استخدامها معًا):

bash
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:

bash
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>       # 删除

لا تريد انتظار 20 دقيقة للتحقق من تذكير الخطوة 1؟ التشغيل القسري يعطي نتيجة فورية:

bash
openclaw automations run <job-id>

يجب أن ترى: مخرجات تشبه { ok: true, enqueued: true, runId: "…" } — يُدرج run في قائمة الانتظار ثم يعود فورًا، وrunId يُستخدم للاستعلام عن نتيجة هذا التنفيذ:

bash
openclaw automations runs <job-id> --run-id <run-id>

يجب أن ترى: سجل هذا التشغيل، status بقيمة ok أو error أو skipped (حالة تنفيذ الحمولة)، بالإضافة إلى حالة اكتمال الجولة بأكملها 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 وارد باتجاه معاكس — الخدمة الخارجية تستدعي OpenClaw عبر HTTP. وهو معطل افتراضيًا، ويُفتح في ثلاث خطوات.

1. اكتبه في الإعدادات. ادمج المقطع التالي في ملف إعدادات Gateway (~/.openclaw/openclaw.json)، واستبدل token بسلسلة عشوائية طويلة — رمز مخصص للـ hook، لا تعد استخدام رمز مصادقة Gateway أو كلمة المرور؛ واستبدل main بمعرّف الـ agent الذي تريد إيقاظه:

json5
{
  hooks: {
    enabled: true,
    token: "<long-random-hook-token>",
    path: "/hooks",
    allowedAgentIds: ["main"],
    allowRequestSessionKey: false,
  },
}

2. تحقق وأعد التشغيل (إذا كان Gateway يعمل في المقدمة، أعد تشغيل تلك العملية الأمامية):

bash
openclaw config validate
openclaw gateway restart
openclaw logs --follow

يجب أن ترى: التحقق يمر دون أخطاء، وتبدأ السجلات بالتمرير بعد إعادة تشغيل Gateway.

3. اختبار دخاني. افتح طرفية أخرى وأرسل اختبارًا غير ضار إلى Gateway المحلي (استبدل الرمز ومعرّف الـ agent والمنفذ وفق إعداداتك؛ المنفذ الافتراضي 18789):

bash
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، ومتن استجابة بالشكل:

json
{ "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 يُرفض؛ جميع نقاط النهاية تقبل POST فقط، والمتن بصيغة Content-Type: application/json.

⚠️ الـ Webhook سطح مكشوف، أربعة خطوط دفاع أساسية

  • اترك نقطة النهاية خلف loopback أو tailnet أو وكيل عكسي موثوق؛ الاستدعاءات البعيدة عبر HTTPS، مع كشف المسارات اللازمة فقط
  • استخدم رمزًا مخصصًا للـ hook ومسارًا فرعيًا مخصصًا (/ يُرفض)
  • شدّد hooks.allowedAgentIds، واسمح فقط بالـ agents اللازمة
  • تعامل مع محتوى الأحداث الخارجية بوصفه بيانات: محتوى الـ hook للـ agent مغلف افتراضيًا بحماية أمنية، لكن هذا الغلاف لا يزيل الوصول إلى الأدوات وworkspace — سلّم المدخلات غير الموثوقة إلى agent مقيّد

نقطة تحقق ✅ ​

  • يمكنك رؤية المهمات التي أنشأتها ومعرّفات الـ job عبر openclaw automations list
  • التشغيل القسري 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

تنبيهات للمزالق ​

❌ كتابة قيم غير wildcard لكل من يوم cron ويوم الأسبوع معًا تؤدي إلى 5-6 تشغيل شهريًا بدلًا من 0-1 ​

للتعبير عن «اليوم 15 من كل شهر ويوم اثنين الساعة 9»، اكتب:

bash
# 想要:每月 15 号且是周一的 9 点
# 实际:每月 15 号的 9 点 + 每周一的 9 点,约每月 5-6 次
0 9 15 * 1

السبب: OpenClaw يستخدم croner لتحليل cron، وعندما يكون اليوم (day-of-month) ويوم الأسبوع (day-of-week) كلاهما غير wildcard يطبق سلوك 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)، مستقلة عن --tz الخاصة بـ cron

الطريقة الصحيحة: أكثر العادات أمانًا للنشر داخل الصين هي كتابة --tz "Asia/Shanghai" صراحة في cron دائمًا؛ وعند استخدام --at إما أضف إزاحة زمنية (+08:00) أو اضبط --tz.

❌ المهمة لم تعمل في موعدها ​

تحقق من الأعلى إلى الأسفل وفق سُلَّم أوامر استكشاف الأخطاء الرسمي:

bash
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 تعني القبول فقط. ترتيب التحقق:

  • في اختبار الدخان، "deliver":false لا يرسل رسالة عمدًا، هذا تصميم وليس عطلًا
  • للحصول على نتيجة التنفيذ والتسليم في نفس الطلب: أضف "waitForCompletion": true إلى الحمولة، وستجد في completion من الاستجابة status وdelivered وdeliverySuppressionReason
  • التسليم المباشر عبر القناة يتطلبفي نفس الوقت إعطاء channel وto معًا، وإعطاء نصفهما فقط سيؤدي إلى رفض 400 قبل التوزيع
  • في السجلات status=ok لكن مع deliveryError = نجح التنفيذ وفشل التسليم، يجب النظر إليهما بشكل منفصل

تقنيات متقدمة (اختيارية) ​

المشغّلات الشرطية: فحص دوري، والتنبيه فقط عند حدوث تغيير. علّق --trigger-script ./watch-pr-ci.js على جدولة every/cron/stream، يعيد السكربت { fire, message?, state? } — مع fire: false يتخطى بصمت دون إرسال دور للنموذج. حد الحالة 16 KB، وميزانية تقييم واحدة 30 ثانية وبحد أقصى 5 استدعاء أدوات. ملاحظة: run القسري يتجاوز البوابة الشرطية وينفذ مباشرة؛ بينما run --due يحترم البوابة الشرطية. من ناحية الأمان يجب أن تكون واضحًا: تعمل السكربتات الشرطية افتراضيًا دون مراقبة ومعها سياسة الأدوات الكاملة للوكيل المالك (بما فيها exec)، وعند الحاجة إلى إيقاف صارم اضبط cron.triggers.enabled: false. للتجميع العملي انظر مراقبة الويب: يخبرك فور تغيّر الصفحة.

**/loop: أنشئ حلقة بجملة واحدة في المحادثة. ** تنشئ /loop [interval] <prompt> الخاص بالمالك فقط مهمة حلقة في المحادثة الحالية — /loop 5m check deploy status إيقاع ثابت؛ وبدون فاصل فإنه ذاتي الإيقاع (بين 1 دقيقة و1 ساعة). /loop status للعرض، /loop stop [name] للإيقاف. لتفاصيل الأوامر انظر دورة سريعة في أوامر المحادثة.

**استراتيجية المراقبة: لا تدع المهام الخلفية تزعجك في منتصف الليل. ** أضف لمهام الفحص فترات نشاط ومفاتيح إفساح الطريق:

bash
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، ونقاط النهاية المتوافقة مع OpenAI مثل vLLM / SGLang / LM Studio تقابل /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 وstream المُدار من Gateway — بعد تغيير بيئة التشغيل يجب إعادة تشغيل 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 + رمز مخصص؛ /hooks/wake و/hooks/agent و/hooks/<name> ثلاث نقاط نهاية، تقبل POST فقط + مصادقة Bearer، و200 تعني القبول فقط.

✅ فخّان كلاسيكيان: عندما يكون حقلا اليوم/اليوم من الأسبوع في cron غير شموليين فهذا OR (للحصول على AND استخدم بادئة +)؛ --at بدون منطقة زمنية يُفسَّر بـUTC، وcron بدون --tz يستخدم منطقة المضيف الزمنية، وفترات النشاط لها منطقة زمنية أخرى — المجموعات الثلاث مستقلة عن بعضها.

حقل الإعدادالقيمة الموصى بهاالشرح
--tz"Asia/Shanghai" (الصين)المنطقة الزمنية لتقييم cron؛ تنطبق أيضًا على أوقات --at بدون إزاحة
--sessionisolated (تقارير) / main (تذكيرات)جلسة isolated جديدة تمامًا في كل مرة، لا تلوّث المحادثة الرئيسية
--announce --channel --toمعرّف القناة + الهدفيستخدم Slack/Discord channel:<id>؛ ويجب تحديد --channel على المضيفين متعددي القنوات
hooks.enabled / hooks.tokentrue / رمز مخصص طويل وعشوائيمفتاح ومصادقة Webhook الوارد، لا تعيد استخدام مصادقة Gateway
cron.enabledtruefalse أو OPENCLAW_SKIP_CRON=1 لإيقاف الجدولة التلقائية
cron.triggers.enabledtrue (افتراضي)false إيقاف صارم للسكربتات الشرطية وحمولات السكربتات وجدولة stream

مرجع سريع لواجهة سطر الأوامر (CLI): openclaw automations list / get / show / runs / edit / enable / disable / run / remove، أضف --help لعرض جميع المعاملات. لجدول الأوامر الكامل راجع مرجع سريع لأوامر وإعدادات CLI.

استعراض الدرس التالي ​

المهام المجدولة تحل سؤال «متى نعمل»؛ الدرس التالي التحكم في المتصفح: دع Claw يتصفح الإنترنت وينفذ المهام نيابة عنك يمنحه يدًا لتصفح الإنترنت ويحل سؤال «بماذا نعمل» — بدمج الدرسين معًا، يصبح إنشاء النشرة الصباحية والمراقبة مجرد نسخ مباشر.

ستتعلم:

  • web_search / x_search / web_fetch ثلاثية خفيفة الوزن: البحث عن المعلومات واستخراج النص الأساسي
  • متصفح مُدار معزول عبر openclaw: النقر على الأزرار وتعبئة النماذج والتقاط لقطات الشاشة دون المساس بمتصفحك الخاص
  • ملف تعريف user يعيد استخدام جلسة Chrome المسجلة بالفعل
  • عرض مسبق للتركيبة: جدولة + تصفح الإنترنت = النشرة الصباحية اليومية، مراقبة صفحات الويب

دروس ذات صلة ​

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.