الانتقال إلى المحتوى الرئيسي

الأتمتة والمهام

يشغّل OpenClaw العمل في الخلفية من خلال المهام، والوظائف المجدولة، وhooks الأحداث، والتعليمات الدائمة. تساعدك هذه الصفحة على اختيار الآلية المناسبة وفهم كيفية ترابطها.

دليل اتخاذ القرار السريع

حالة الاستخدامالخيار الموصى بهالسبب
إرسال تقرير يومي في تمام الساعة 9 صباحًاScheduled Tasks (Cron)توقيت دقيق، وتنفيذ معزول
ذكّرني بعد 20 دقيقةScheduled Tasks (Cron)تشغيل لمرة واحدة مع توقيت دقيق (--at)
تشغيل تحليل عميق أسبوعيScheduled Tasks (Cron)مهمة مستقلة، ويمكنها استخدام نموذج مختلف
فحص البريد الوارد كل 30 دقيقةHeartbeatيجمّع مع فحوصات أخرى، ومدرك للسياق
مراقبة التقويم للأحداث القادمةHeartbeatملائم بطبيعته للوعي الدوري
فحص حالة وكيل فرعي أو تشغيل ACPBackground Tasksيسجّل دفتر المهام كل العمل المنفصل
تدقيق ما الذي تم تشغيله ومتىBackground Tasksopenclaw tasks list وopenclaw tasks audit
بحث متعدد الخطوات ثم تلخيصTask Flowتنسيق دائم مع تتبع المراجعات
تشغيل برنامج نصي عند إعادة تعيين الجلسةHooksيعتمد على الأحداث، ويعمل عند أحداث دورة الحياة
تنفيذ تعليمات برمجية عند كل استدعاء أداةHooksيمكن لـ Hooks التصفية حسب نوع الحدث
التحقق دائمًا من الامتثال قبل الردStanding Ordersتُحقن تلقائيًا في كل جلسة

Scheduled Tasks (Cron) مقابل Heartbeat

البعدScheduled Tasks (Cron)Heartbeat
التوقيتدقيق (تعبيرات cron، تشغيل لمرة واحدة)تقريبي (افتراضيًا كل 30 دقيقة)
سياق الجلسةجديد (معزول) أو مشتركسياق الجلسة الرئيسية الكامل
سجلات المهاميتم إنشاؤها دائمًالا يتم إنشاؤها أبدًا
التسليمقناة، أو webhook، أو بصمتمضمّن داخل الجلسة الرئيسية
الأنسب لـالتقارير، والتذكيرات، والوظائف الخلفيةفحوصات البريد الوارد، والتقويم، والإشعارات
استخدم Scheduled Tasks (Cron) عندما تحتاج إلى توقيت دقيق أو تنفيذ معزول. واستخدم Heartbeat عندما يستفيد العمل من سياق الجلسة الكامل ويكون التوقيت التقريبي كافيًا.

المفاهيم الأساسية

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

يمثل Cron المجدول المدمج في Gateway للتوقيت الدقيق. فهو يحتفظ بالوظائف، ويوقظ الوكيل في الوقت المناسب، ويمكنه تسليم المخرجات إلى قناة دردشة أو نقطة نهاية webhook. ويدعم التذكيرات التي تعمل لمرة واحدة، والتعبيرات المتكررة، ومشغلات webhook الواردة. راجع Scheduled Tasks.

المهام

يتتبع دفتر المهام الخلفية جميع الأعمال المنفصلة: عمليات تشغيل ACP، وتشغيل الوكلاء الفرعيين، وتنفيذات cron المعزولة، وعمليات CLI. المهام هي سجلات وليست مجدولات. استخدم openclaw tasks list وopenclaw tasks audit لفحصها. راجع Background Tasks.

Task Flow

يمثل Task Flow طبقة تنسيق التدفقات فوق المهام الخلفية. وهو يدير التدفقات الدائمة متعددة الخطوات مع أوضاع المزامنة المُدارة والمنعكسة، وتتبع المراجعات، وopenclaw tasks flow list|show|cancel للفحص. راجع Task Flow.

الأوامر الدائمة

تمنح الأوامر الدائمة الوكيل صلاحية تشغيل دائمة للبرامج المحددة. وهي توجد في ملفات مساحة العمل (عادةً AGENTS.md) وتُحقن في كل جلسة. ويمكن دمجها مع cron لفرض التنفيذ المعتمد على الوقت. راجع Standing Orders.

Hooks

تمثل Hooks برامج نصية تعتمد على الأحداث ويتم تشغيلها بواسطة أحداث دورة حياة الوكيل (/new و/reset و/stop) وضغط الجلسة، وبدء تشغيل البوابة، وتدفق الرسائل، واستدعاءات الأدوات. يتم اكتشاف Hooks تلقائيًا من الأدلة ويمكن إدارتها باستخدام openclaw hooks. راجع Hooks.

Heartbeat

يمثل Heartbeat دورًا دوريًا للجلسة الرئيسية (افتراضيًا كل 30 دقيقة). وهو يجمّع عدة فحوصات (البريد الوارد، والتقويم، والإشعارات) في دور وكيل واحد مع سياق الجلسة الكامل. ولا تنشئ أدوار Heartbeat سجلات مهام. استخدم HEARTBEAT.md لقائمة تحقق صغيرة، أو كتلة tasks: عندما تريد فحوصات دورية مستحقة فقط داخل heartbeat نفسه. تتخطى ملفات heartbeat الفارغة كـ empty-heartbeat-file، ويتخطى وضع المهام المستحقة فقط كـ no-tasks-due. راجع Heartbeat.

كيف تعمل معًا

  • Cron يتعامل مع الجداول الدقيقة (التقارير اليومية، والمراجعات الأسبوعية) والتذكيرات التي تعمل لمرة واحدة. جميع تنفيذات cron تنشئ سجلات مهام.
  • Heartbeat يتعامل مع المراقبة الروتينية (البريد الوارد، والتقويم، والإشعارات) في دور مجمّع واحد كل 30 دقيقة.
  • Hooks تتفاعل مع أحداث محددة (استدعاءات الأدوات، وإعادة تعيين الجلسة، والضغط) عبر برامج نصية مخصصة.
  • الأوامر الدائمة تمنح الوكيل سياقًا مستمرًا وحدودًا للصلاحيات.
  • Task Flow ينسق التدفقات متعددة الخطوات فوق المهام الفردية.
  • المهام تتتبع تلقائيًا كل الأعمال المنفصلة حتى تتمكن من فحصها وتدقيقها.

ذو صلة

  • Scheduled Tasks — الجدولة الدقيقة والتذكيرات التي تعمل لمرة واحدة
  • Background Tasks — دفتر المهام لجميع الأعمال المنفصلة
  • Task Flow — تنسيق التدفقات الدائمة متعددة الخطوات
  • Hooks — برامج نصية لدورة الحياة تعتمد على الأحداث
  • Standing Orders — تعليمات الوكيل الدائمة
  • Heartbeat — أدوار دورية للجلسة الرئيسية
  • Configuration Reference — جميع مفاتيح الإعداد