Automation

الأتمتة

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

دليل القرار السريع

flowchart TD
    START([What do you need?]) --> Q1{Schedule work?}
    START --> Q2{Track detached work?}
    START --> Q3{Orchestrate multi-step flows?}
    START --> Q4{React to lifecycle events?}
    START --> Q5{Give the agent persistent instructions?}
    START --> Q6{Remember a natural follow-up?}

    Q1 -->|Yes| Q1a{Exact timing or flexible?}
    Q1a -->|Exact| CRON["Scheduled Tasks (Cron)"]
    Q1a -->|Flexible| HEARTBEAT[Heartbeat]

    Q2 -->|Yes| TASKS[Background Tasks]
    Q3 -->|Yes| FLOW[Task Flow]
    Q4 -->|Yes| HOOKS[Hooks]
    Q5 -->|Yes| SO[Standing Orders]
    Q6 -->|Yes| COMMITMENTS[Inferred Commitments]

حالة الاستخدام	الموصى به	السبب
إرسال تقرير يومي في تمام الساعة 9 صباحًا	المهام المجدولة (Cron)	توقيت دقيق وتنفيذ معزول
تذكيري بعد 20 دقيقة	المهام المجدولة (Cron)	تنفيذ لمرة واحدة بتوقيت دقيق (`--at`)
إجراء تحليل متعمق أسبوعيًا	المهام المجدولة (Cron)	مهمة مستقلة يمكنها استخدام نموذج مختلف
التحقق من صندوق الوارد كل 30 دقيقة	Heartbeat	تُجمَّع مع عمليات التحقق الأخرى وتراعي السياق
مراقبة التقويم للأحداث القادمة	Heartbeat	ملائمة طبيعية للوعي الدوري
المتابعة بعد مقابلة ذُكرت في المحادثة	الالتزامات المستنتجة	متابعة شبيهة بالذاكرة من دون طلب تذكير بوقت محدد
متابعة لطيفة للاطمئنان بعد سياق قدّمه المستخدم	الالتزامات المستنتجة	مقيّدة بالوكيل والقناة نفسيهما
فحص حالة وكيل فرعي أو تشغيل ACP	مهام الخلفية	يتتبع سجل المهام جميع الأعمال المنفصلة
تدقيق ما تم تشغيله وموعد تشغيله	مهام الخلفية	`openclaw tasks list` و`openclaw tasks audit`
إجراء بحث متعدد الخطوات ثم تلخيصه	تدفق المهام	تنسيق دائم مع تتبع المراجعات
تشغيل برنامج نصي عند إعادة ضبط الجلسة	الخطافات	قائم على الأحداث ويُفعّل عند أحداث دورة الحياة
تنفيذ تعليمة برمجية عند كل استدعاء لأداة	خطافات Plugin	يمكن للخطافات داخل العملية اعتراض استدعاءات الأدوات
التحقق دائمًا من الامتثال قبل الرد	التعليمات الدائمة	تُحقن تلقائيًا في كل جلسة

المهام المجدولة (Cron) مقارنةً بـ Heartbeat

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

استخدم المهام المجدولة (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 استدعاءات الأدوات.
تمنح التعليمات الدائمة الوكيل سياقًا مستمرًا وحدودًا للصلاحيات.
ينسّق تدفق المهام التدفقات متعددة الخطوات فوق المهام الفردية.
تتتبع المهام تلقائيًا جميع الأعمال المنفصلة كي تتمكن من فحصها وتدقيقها.