Automation and tasks
الأتمتة والمهام
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 |
| بحث متعدد الخطوات ثم تلخيص | Task Flow | تنسيق دائم مع تتبع للمراجعات |
| تشغيل سكربت عند إعادة ضبط الجلسة | الخطافات | مدفوع بالأحداث، ويعمل عند أحداث دورة الحياة |
| تنفيذ كود عند كل استدعاء أداة | خطافات 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.
راجع الالتزامات المستنتجة.
Task Flow
Task Flow هو ركيزة تنسيق التدفقات فوق المهام الخلفية. يدير تدفقات متعددة الخطوات ودائمة مع أوضاع مزامنة مدارة ومعكوسة، وتتبع للمراجعات، و openclaw tasks flow list|show|cancel للفحص.
راجع Task Flow.
الأوامر الدائمة
تمنح الأوامر الدائمة الوكيل صلاحية تشغيل دائمة لبرامج محددة. تعيش في ملفات مساحة العمل (عادة 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. تؤجل Heartbeats عملها أثناء نشاط عمل cron أو وجوده في قائمة الانتظار، ويمكن لـ heartbeat.skipWhenBusy أيضا تأجيلها أثناء انشغال الوكيل الفرعي أو المسارات المتداخلة.
راجع Heartbeat.
كيف تعمل معا
- Cron يتعامل مع الجداول الدقيقة (التقارير اليومية، والمراجعات الأسبوعية) والتذكيرات لمرة واحدة. تنشئ كل تنفيذات cron سجلات مهام.
- Heartbeat يتعامل مع المراقبة الروتينية (صندوق الوارد، والتقويم، والإشعارات) في دور واحد مجمع كل 30 دقيقة.
- الخطافات تتفاعل مع أحداث محددة (إعادة ضبط الجلسة، وCompaction، وتدفق الرسائل) باستخدام سكربتات مخصصة. تغطي خطافات Plugin استدعاءات الأدوات.
- الأوامر الدائمة تمنح الوكيل سياقا دائما وحدودا للصلاحية.
- Task Flow ينسق التدفقات متعددة الخطوات فوق المهام الفردية.
- المهام تتتبع تلقائيا كل الأعمال المنفصلة حتى تتمكن من فحصها وتدقيقها.
ذات صلة
- المهام المجدولة — جدولة دقيقة وتذكيرات لمرة واحدة
- الالتزامات المستنتجة — تحققات متابعة شبيهة بالذاكرة
- المهام الخلفية — سجل المهام لكل الأعمال المنفصلة
- Task Flow — تنسيق دائم لتدفقات متعددة الخطوات
- الخطافات — سكربتات دورة الحياة المدفوعة بالأحداث
- خطافات Plugin — خطافات الأدوات والمطالبات والرسائل ودورة الحياة داخل العملية
- الأوامر الدائمة — تعليمات الوكيل الدائمة
- Heartbeat — أدوار دورية في الجلسة الرئيسية
- مرجع الإعدادات — كل مفاتيح الإعدادات