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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

حالة الاستخدامالموصى بهالسبب
إرسال تقرير يومي في الساعة 9 صباحًا بالضبطالمهام المجدولة (Cron)توقيت دقيق، تنفيذ معزول
ذكّرني بعد 20 دقيقةالمهام المجدولة (Cron)مرة واحدة بتوقيت دقيق (--at)
تشغيل تحليل عميق أسبوعيالمهام المجدولة (Cron)مهمة مستقلة، ويمكن استخدام نموذج مختلف
فحص صندوق الوارد كل 30 دقيقةHeartbeatتُجمّع مع فحوصات أخرى، وواعية بالسياق
مراقبة التقويم للأحداث القادمةHeartbeatملائمة طبيعية للوعي الدوري
المتابعة بعد مقابلة مذكورةالالتزامات المستنتجةمتابعة شبيهة بالذاكرة، من دون طلب تذكير دقيق
متابعة لطيفة للرعاية بعد سياق المستخدمالالتزامات المستنتجةمقيّدة بالوكيل والقناة نفسيهما
فحص حالة وكيل فرعي أو تشغيل ACPمهام الخلفيةسجل المهام يتتبع كل العمل المنفصل
تدقيق ما تم تشغيله ومتىمهام الخلفيةopenclaw tasks list وopenclaw tasks audit
بحث متعدد الخطوات ثم تلخيصTaskFlowتنسيق دائم مع تتبع المراجعات
تشغيل سكربت عند إعادة ضبط الجلسةالخطافاتمدفوع بالأحداث، ويُشغّل عند أحداث دورة الحياة
تنفيذ كود عند كل استدعاء أداةخطافات 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. راجع الالتزامات المستنتجة.

​
TaskFlow

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

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

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

​
ذو صلة