دليل القرار السريع
المهام المجدولة (Cron) مقارنةً بـ Heartbeat
استخدم المهام المجدولة (Cron) عندما تحتاج إلى توقيت دقيق أو تنفيذ معزول. استخدم Heartbeat عندما يستفيد العمل من سياق الجلسة الكامل ويكون التوقيت التقريبي مقبولًا.
المفاهيم الأساسية
المهام المجدولة (Cron)
Cron هو المجدول المدمج في Gateway للتوقيت الدقيق. يحتفظ بالوظائف، وينشّط الوكيل في الوقت المناسب، ويمكنه تسليم المخرجات إلى قناة محادثة أو نقطة نهاية webhook. وهو يدعم التذكيرات لمرة واحدة، والتعبيرات المتكررة، ومشغلات webhook الواردة. راجع المهام المجدولة.المهام
يتتبع سجل مهام الخلفية جميع الأعمال المنفصلة: عمليات تشغيل ACP، وإنشاء الوكلاء الفرعيين، وعمليات تنفيذ Cron المعزولة، وعمليات CLI. المهام سجلات وليست أدوات جدولة. استخدمopenclaw tasks list وopenclaw tasks audit لفحصها.
راجع مهام الخلفية.
الالتزامات المستنتجة
الالتزامات هي ذكريات متابعة اختيارية وقصيرة الأجل. تستنتجها OpenClaw من المحادثات العادية، وتقيّدها بالوكيل والقناة نفسيهما، وتسلّم عمليات المتابعة المستحقة من خلال Heartbeat. أما التذكيرات الدقيقة التي يطلبها المستخدم فتبقى من اختصاص Cron. راجع الالتزامات المستنتجة.تدفق المهام
تدفق المهام هو بنية تنسيق التدفقات التي تعمل فوق مهام الخلفية. وهو يدير تدفقات دائمة متعددة الخطوات باستخدام وضعي المزامنة المُدارة والمنعكسة، وتتبع المراجعات، وopenclaw tasks flow list|show|cancel للفحص.
راجع تدفق المهام.
التعليمات الدائمة
تمنح التعليمات الدائمة الوكيل صلاحية تشغيل دائمة للبرامج المحددة. توجد هذه التعليمات في ملفات مساحة العمل (عادةًAGENTS.md) وتُحقن في كل جلسة. ادمجها مع Cron للتنفيذ المرتبط بالوقت.
راجع التعليمات الدائمة.
الخطافات
الخطافات الداخلية هي برامج نصية قائمة على الأحداث، تُشغّلها أحداث دورة حياة الوكيل (/new و/reset و/stop)، وCompaction الجلسة، وبدء تشغيل Gateway، وتدفق الرسائل. تُكتشف من أدلة الخطافات وتُدار باستخدام openclaw hooks. لاعتراض استدعاءات الأدوات داخل العملية، استخدم خطافات Plugin.
راجع الخطافات.
Heartbeat
Heartbeat هو دور دوري في الجلسة الرئيسية (الافتراضي كل 30 دقيقة). ويجمع عدة عمليات تحقق (صندوق الوارد والتقويم والإشعارات) في دور واحد للوكيل مع سياق الجلسة الكامل. لا تُنشئ أدوار Heartbeat سجلات مهام، ولا تمدد حداثة إعادة ضبط الجلسة اليومية أو عند الخمول. استخدمHEARTBEAT.md لقائمة تحقق صغيرة، أو كتلة tasks: عندما تريد إجراء عمليات تحقق دورية للمهام المستحقة فقط داخل Heartbeat نفسه. تتخطى ملفات Heartbeat الفارغة التشغيل بالحالة empty-heartbeat-file، بينما يتخطى وضع المهام المستحقة فقط التشغيل بالحالة no-tasks-due. تتأجل عمليات Heartbeat عندما يكون عمل Cron نشطًا أو في قائمة الانتظار، ويمكن أيضًا للإعداد heartbeat.skipWhenBusy تأجيل وكيل عندما تكون مسارات الوكيل الفرعي المرتبطة بمفتاح جلسة الوكيل نفسه أو المسارات المتداخلة مشغولة.
راجع Heartbeat.
كيفية عملها معًا
- يتولى Cron الجداول الدقيقة (التقارير اليومية والمراجعات الأسبوعية) والتذكيرات لمرة واحدة. تنشئ جميع عمليات تنفيذ Cron سجلات مهام.
- يتولى Heartbeat المراقبة الروتينية (صندوق الوارد والتقويم والإشعارات) في دور واحد مجمّع كل 30 دقيقة.
- تتفاعل الخطافات مع أحداث محددة (إعادة ضبط الجلسة وCompaction وتدفق الرسائل) باستخدام برامج نصية مخصصة. وتغطي خطافات Plugin استدعاءات الأدوات.
- تمنح التعليمات الدائمة الوكيل سياقًا مستمرًا وحدودًا للصلاحيات.
- ينسّق تدفق المهام التدفقات متعددة الخطوات فوق المهام الفردية.
- تتتبع المهام تلقائيًا جميع الأعمال المنفصلة كي تتمكن من فحصها وتدقيقها.
مواضيع ذات صلة
- المهام المجدولة — الجدولة الدقيقة والتذكيرات لمرة واحدة
- الالتزامات المستنتجة — عمليات متابعة شبيهة بالذاكرة
- مهام الخلفية — سجل مهام لجميع الأعمال المنفصلة
- تدفق المهام — تنسيق دائم للتدفقات متعددة الخطوات
- الخطافات — برامج نصية لدورة الحياة قائمة على الأحداث
- خطافات Plugin — خطافات داخل العملية للأدوات والموجّهات والرسائل ودورة الحياة
- التعليمات الدائمة — تعليمات مستمرة للوكيل
- Heartbeat — أدوار دورية في الجلسة الرئيسية
- مرجع الإعدادات — جميع مفاتيح الإعدادات