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

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.

تبحث عن الجدولة؟ راجع الأتمتة لاختيار الآلية المناسبة. هذه الصفحة هي سجل النشاط للعمل في الخلفية، وليست المُجدول.
تتعقب مهام الخلفية العمل الذي يعمل خارج جلسة محادثتك الرئيسية: تشغيلات ACP، وإنشاءات الوكلاء الفرعيين، وتنفيذات مهام cron المعزولة، والعمليات التي يبدأها CLI. لا تستبدل المهام الجلسات أو مهام cron أو Heartbeat - فهي سجل النشاط الذي يسجل العمل المنفصل الذي حدث، ومتى حدث، وما إذا كان قد نجح.
لا ينشئ كل تشغيل للوكيل مهمة. دورات Heartbeat والمحادثة التفاعلية العادية لا تفعل ذلك. كل تنفيذات cron، وإنشاءات ACP، وإنشاءات الوكلاء الفرعيين، وأوامر وكيل CLI تفعل ذلك.

​
الملخص

  • المهام سجلات وليست مجدولات - يحدد cron وHeartbeat متى يعمل العمل، وتتتبع المهام ما حدث.
  • تنشئ ACP، والوكلاء الفرعيون، وكل مهام cron، وعمليات CLI مهام. دورات Heartbeat لا تفعل ذلك.
  • تنتقل كل مهمة عبر queued → running → terminal (succeeded أو failed أو timed_out أو cancelled أو lost).
  • تظل مهام cron نشطة ما دام وقت تشغيل cron لا يزال يملك المهمة؛ وإذا اختفت حالة وقت التشغيل داخل الذاكرة، تتحقق صيانة المهام أولا من سجل تشغيلات cron الدائم قبل تعليم المهمة كمفقودة.
  • الإكمال مدفوع بالدفع: يمكن للعمل المنفصل أن يرسل إشعارا مباشرا أو يوقظ جلسة/Heartbeat الطالب عند الانتهاء، لذلك تكون حلقات استطلاع الحالة غالبا الشكل غير المناسب.
  • تعمل تشغيلات cron المعزولة وإكمالات الوكلاء الفرعيين بأفضل جهد على تنظيف ألسنة المتصفح/العمليات المتتبعة لجلسة الابن قبل مسك دفاتر التنظيف النهائي.
  • يمنع تسليم cron المعزول ردود الوالد المؤقتة القديمة بينما لا يزال عمل الوكيل الفرعي السليل قيد التفريغ، ويفضل مخرجات السليل النهائية عندما تصل قبل التسليم.
  • تُسلم إشعارات الإكمال مباشرة إلى قناة أو توضع في قائمة الانتظار حتى Heartbeat التالية.
  • يعرض openclaw tasks list كل المهام؛ ويكشف openclaw tasks audit المشكلات.
  • تُحتفظ بالسجلات النهائية لمدة 7 أيام، ثم تُزال تلقائيا.

​
البدء السريع

# List all tasks (newest first)
openclaw tasks list

# Filter by runtime or status
openclaw tasks list --runtime acp
openclaw tasks list --status running

​
ما الذي ينشئ مهمة

المصدرنوع وقت التشغيلمتى يُنشأ سجل مهمةسياسة الإشعار الافتراضية
تشغيلات ACP الخلفيةacpإنشاء جلسة ACP ابنةdone_only
تنسيق الوكلاء الفرعيينsubagentإنشاء وكيل فرعي عبر sessions_spawndone_only
مهام Cron (كل الأنواع)cronكل تنفيذ لـ cron (الجلسة الرئيسية والمعزولة)silent
عمليات CLIcliأوامر openclaw agent التي تعمل عبر Gatewaysilent
مهام وسائط الوكيلcliتشغيلات music_generate/video_generate المدعومة بجلسةsilent
تستخدم مهام cron في الجلسة الرئيسية سياسة إشعار silent افتراضيا - فهي تنشئ سجلات للتتبع لكنها لا تولد إشعارات. كما تعتمد مهام cron المعزولة افتراضيا على silent لكنها أوضح لأنها تعمل في جلستها الخاصة.تستخدم تشغيلات music_generate وvideo_generate المدعومة بجلسة أيضا سياسة إشعار silent. ما زالت تنشئ سجلات مهام، لكن الإكمال يُعاد إلى جلسة الوكيل الأصلية كإيقاظ داخلي حتى يتمكن الوكيل من كتابة رسالة المتابعة وإرفاق الوسائط المكتملة بنفسه. تتبع إكمالات المجموعة/القناة سياسة الرد المرئي العادية، لذلك يستخدم الوكيل أداة الرسائل عندما يتطلب تسليم المصدر ذلك. إذا فشل وكيل الإكمال في إنتاج دليل تسليم بأداة الرسائل في مسار أدوات فقط، يرسل OpenClaw بديل الإكمال مباشرة إلى القناة الأصلية بدلا من ترك الوسائط خاصة.
بينما لا تزال مهمة video_generate المدعومة بجلسة نشطة، تعمل الأداة أيضا كحاجز أمان: تعيد استدعاءات video_generate المتكررة في الجلسة نفسها حالة المهمة النشطة بدلا من بدء توليد ثان متزامن. استخدم action: "status" عندما تريد استعلام تقدم/حالة صريحا من جهة الوكيل.
  • دورات Heartbeat - الجلسة الرئيسية؛ راجع Heartbeat
  • دورات المحادثة التفاعلية العادية
  • ردود /command المباشرة

​
دورة حياة المهمة

الحالةما تعنيه
queuedأُنشئت، وتنتظر بدء الوكيل
runningدورة الوكيل قيد التنفيذ بنشاط
succeededاكتملت بنجاح
failedاكتملت مع خطأ
timed_outتجاوزت المهلة المكوّنة
cancelledأوقفها المشغل عبر openclaw tasks cancel
lostفقد وقت التشغيل حالة الدعم السلطوية بعد فترة سماح مدتها 5 دقائق
تحدث الانتقالات تلقائيا - عندما ينتهي تشغيل الوكيل المرتبط، تتحدث حالة المهمة لتطابق ذلك. إكمال تشغيل الوكيل هو المرجع السلطوي لسجلات المهام النشطة. ينهي التشغيل المنفصل الناجح كـ succeeded، وتنتهي أخطاء التشغيل العادية كـ failed، وتنتهي نتائج المهلة أو الإجهاض كـ timed_out. إذا كان المشغل قد ألغى المهمة بالفعل، أو كان وقت التشغيل قد سجل بالفعل حالة نهائية أقوى مثل failed أو timed_out أو lost، فلا تؤدي إشارة نجاح لاحقة إلى تخفيض تلك الحالة النهائية. lost واعية بوقت التشغيل:
  • مهام ACP: اختفت بيانات جلسة ACP الابنة الداعمة.
  • مهام الوكيل الفرعي: اختفت الجلسة الابنة الداعمة من مخزن الوكيل الهدف.
  • مهام Cron: لم يعد وقت تشغيل cron يتتبع المهمة كنشطة ولا يظهر سجل تشغيلات cron الدائم نتيجة نهائية لذلك التشغيل. لا يتعامل تدقيق CLI غير المتصل مع حالة وقت تشغيل cron الفارغة داخل عمليته كسلطة.
  • مهام CLI: تستخدم المهام ذات معرف تشغيل/معرف مصدر سياق التشغيل المباشر، لذلك لا تبقي صفوف الجلسات الابنة أو جلسات المحادثة العالقة هذه المهام حية بعد اختفاء التشغيل المملوك لـ Gateway. ما زالت مهام CLI القديمة بلا هوية تشغيل ترجع إلى الجلسة الابنة. كما تنتهي تشغيلات openclaw agent المدعومة بـ Gateway من نتيجة تشغيلها، لذلك لا تبقى التشغيلات المكتملة نشطة حتى يعلّمها الكانس كـ lost.

​
التسليم والإشعارات

عندما تصل مهمة إلى حالة نهائية، يخطرك OpenClaw. يوجد مسارا تسليم: التسليم المباشر - إذا كان للمهمة هدف قناة (requesterOrigin)، تذهب رسالة الإكمال مباشرة إلى تلك القناة (Telegram وDiscord وSlack وما إلى ذلك). بدلا من ذلك، تُوجه إكمالات مهام المجموعة والقناة عبر جلسة الطالب حتى يتمكن الوكيل الوالد من كتابة الرد المرئي. بالنسبة إلى إكمالات الوكيل الفرعي، يحافظ OpenClaw أيضا على توجيه الخيط/الموضوع المرتبط عندما يكون متاحا، ويمكنه ملء to / الحساب المفقود من مسار جلسة الطالب المخزن (lastChannel / lastTo / lastAccountId) قبل التخلي عن التسليم المباشر. التسليم الموضوع في قائمة انتظار الجلسة - إذا فشل التسليم المباشر أو لم يُضبط أصل، يوضع التحديث في قائمة الانتظار كحدث نظام في جلسة الطالب ويظهر عند Heartbeat التالية.
يفعّل إكمال المهمة إيقاظ Heartbeat فوريا حتى ترى النتيجة بسرعة - لا تحتاج إلى انتظار دقة Heartbeat المجدولة التالية.
يعني ذلك أن سير العمل المعتاد قائم على الدفع: ابدأ العمل المنفصل مرة واحدة، ثم دع وقت التشغيل يوقظك أو يخطرك عند الإكمال. لا تستطلع حالة المهمة إلا عندما تحتاج إلى تصحيح، أو تدخل، أو تدقيق صريح.

​
سياسات الإشعار

تحكم في مقدار ما تسمعه عن كل مهمة:
السياسةما يُسلم
done_only (الافتراضي)الحالة النهائية فقط (succeeded وfailed وما إلى ذلك) - هذا هو الافتراضي
state_changesكل انتقال حالة وتحديث تقدم
silentلا شيء إطلاقا
غيّر السياسة أثناء تشغيل مهمة: 
openclaw tasks notify <lookup> state_changes

​
مرجع CLI

openclaw tasks list [--runtime <acp|subagent|cron|cli>] [--status <status>] [--json]
أعمدة المخرجات: معرف المهمة، النوع، الحالة، التسليم، معرف التشغيل، الجلسة الابنة، الملخص.
openclaw tasks show <lookup>
يقبل رمز البحث معرف مهمة أو معرف تشغيل أو مفتاح جلسة. يعرض السجل الكامل بما في ذلك التوقيت، وحالة التسليم، والخطأ، والملخص النهائي.
openclaw tasks cancel <lookup>
بالنسبة إلى مهام ACP والوكيل الفرعي، يقتل هذا الجلسة الابنة. بالنسبة إلى المهام المتتبعة بواسطة CLI، يُسجل الإلغاء في سجل المهام (لا يوجد مقبض وقت تشغيل ابن منفصل). تنتقل الحالة إلى cancelled ويُرسل إشعار تسليم عند انطباق ذلك.
openclaw tasks notify <lookup> <done_only|state_changes|silent>

openclaw tasks audit [--json]
يكشف المشكلات التشغيلية. تظهر النتائج أيضا في openclaw status عند اكتشاف مشكلات.
النتيجةالخطورةالمشغّل
stale_queuedتحذيرفي قائمة الانتظار لأكثر من 10 دقائق
stale_runningخطأقيد التشغيل لأكثر من 30 دقيقة
lostتحذير/خطأاختفت ملكية المهمة المدعومة بوقت التشغيل؛ تظل المهام المفقودة المحتفظ بها تحذيرات حتى cleanupAfter، ثم تصبح أخطاء
delivery_failedتحذيرفشل التسليم وسياسة الإشعار ليست silent
missing_cleanupتحذيرمهمة نهائية بدون طابع زمني للتنظيف
inconsistent_timestampsتحذيرمخالفة في الخط الزمني (على سبيل المثال انتهت قبل أن تبدأ)
openclaw tasks maintenance [--json]
openclaw tasks maintenance --apply [--json]
استخدم هذا لمعاينة أو تطبيق التسوية، وختم التنظيف، والتقليم للمهام، وحالة Task Flow، وصفوف سجل جلسات تشغيل cron القديمة.التسوية واعية بوقت التشغيل:
  • تتحقق مهام ACP/العامل الفرعي من جلسة الطفل الداعمة لها.
  • تُعلَّم مهام العامل الفرعي التي تحتوي جلسة الطفل الخاصة بها على شاهدة استرداد بعد إعادة التشغيل على أنها مفقودة بدلا من معاملتها كجلسات داعمة قابلة للاسترداد.
  • تتحقق مهام Cron مما إذا كان وقت تشغيل Cron لا يزال يملك المهمة، ثم تستعيد الحالة النهائية من سجلات تشغيل Cron المستمرة/حالة المهمة قبل الرجوع إلى lost. عملية Gateway فقط هي المرجع الموثوق لمجموعة مهام Cron النشطة في الذاكرة؛ يستخدم تدقيق CLI غير المتصل التاريخ الدائم لكنه لا يعلّم مهمة Cron كمفقودة لمجرد أن تلك المجموعة المحلية فارغة.
  • تتحقق مهام CLI ذات هوية التشغيل من سياق التشغيل الحي المالك، وليس فقط من صفوف جلسات الطفل أو جلسات الدردشة.
التنظيف بعد الاكتمال واع بوقت التشغيل أيضا:
  • إكمال العامل الفرعي يغلق، بأفضل جهد، تبويبات/عمليات المتصفح المتتبعة لجلسة الطفل قبل أن يستمر تنظيف الإعلان.
  • إكمال Cron المعزول يغلق، بأفضل جهد، تبويبات/عمليات المتصفح المتتبعة لجلسة Cron قبل أن ينتهي التشغيل بالكامل.
  • ينتظر تسليم Cron المعزول متابعة العامل الفرعي السليل عند الحاجة ويمنع نص إقرار الأصل القديم بدلا من إعلانه.
  • يفضّل تسليم إكمال العامل الفرعي أحدث نص مساعد مرئي؛ إذا كان ذلك فارغا فإنه يرجع إلى أحدث نص أداة/toolResult منقّى، ويمكن لتشغيلات استدعاء الأدوات التي انتهت بالمهلة فقط أن تُختصر إلى ملخص موجز للتقدم الجزئي. تعلن التشغيلات الفاشلة النهائية حالة الفشل دون إعادة عرض نص الرد الملتقط.
  • لا تخفي إخفاقات التنظيف نتيجة المهمة الحقيقية.
عند تطبيق الصيانة، يزيل OpenClaw أيضا صفوف سجل الجلسات القديمة cron:<jobId>:run:<uuid> التي يزيد عمرها عن 7 أيام، مع الحفاظ على الصفوف الخاصة بمهام Cron قيد التشغيل حاليا وترك صفوف الجلسات غير التابعة لـCron دون تغيير.
openclaw tasks flow list [--status <status>] [--json]
openclaw tasks flow show <lookup> [--json]
openclaw tasks flow cancel <lookup>
استخدم هذه عندما يكون Task Flow المنسّق هو ما تهتم به بدلا من سجل مهمة خلفية فردية واحد.

​
لوحة مهام الدردشة (/tasks)

استخدم /tasks في أي جلسة دردشة لرؤية المهام الخلفية المرتبطة بتلك الجلسة. تعرض اللوحة المهام النشطة والمكتملة مؤخرا مع وقت التشغيل، والحالة، والتوقيت، وتفاصيل التقدم أو الخطأ. عندما لا تحتوي الجلسة الحالية على مهام مرتبطة مرئية، يرجع /tasks إلى أعداد المهام المحلية للعامل حتى تحصل مع ذلك على نظرة عامة دون تسريب تفاصيل جلسات أخرى. لسجل المشغل الكامل، استخدم CLI: openclaw tasks list.

​
تكامل الحالة (ضغط المهام)

يتضمن openclaw status ملخصا سريعا للمهام: 
Tasks: 3 queued · 2 running · 1 issues
يعرض الملخص:
  • نشطة - عدد queued + running
  • الإخفاقات - عدد failed + timed_out + lost
  • حسب وقت التشغيل - تفصيل حسب acp، وsubagent، وcron، وcli
يستخدم كل من /status وأداة session_status لقطة مهام واعية بالتنظيف: تُفضّل المهام النشطة، وتُخفى الصفوف المكتملة القديمة، ولا تظهر الإخفاقات الحديثة إلا عندما لا يبقى أي عمل نشط. هذا يبقي بطاقة الحالة مركزة على ما يهم الآن.

​
التخزين والصيانة

​
أين توجد المهام

تستمر سجلات المهام في SQLite عند: 
$OPENCLAW_STATE_DIR/tasks/runs.sqlite
يُحمّل السجل إلى الذاكرة عند بدء Gateway وتُزامن عمليات الكتابة إلى SQLite لضمان الديمومة عبر عمليات إعادة التشغيل. يبقي Gateway سجل الكتابة المسبقة في SQLite ضمن حدود محددة باستخدام عتبة نقطة التحقق التلقائية الافتراضية في SQLite بالإضافة إلى نقاط تحقق TRUNCATE دورية وعند الإيقاف.

​
الصيانة التلقائية

يعمل منظّف كل 60 ثانية ويتولى أربعة أمور:
1

التسوية

يتحقق مما إذا كانت المهام النشطة لا تزال لديها دعامة موثوقة من وقت التشغيل. تستخدم مهام ACP/العامل الفرعي حالة جلسة الطفل، وتستخدم مهام Cron ملكية المهمة النشطة، وتستخدم مهام CLI ذات هوية التشغيل سياق التشغيل المالك. إذا اختفت تلك الحالة الداعمة لأكثر من 5 دقائق، تُعلّم المهمة كـlost.
2

إصلاح جلسات ACP

يغلق جلسات ACP النهائية أو اليتيمة أحادية التشغيل المملوكة للأصل، ويغلق جلسات ACP الدائمة النهائية القديمة أو اليتيمة فقط عندما لا يبقى أي ربط محادثة نشط.
3

ختم التنظيف

يعيّن طابعا زمنيا cleanupAfter على المهام النهائية (endedAt + 7 أيام). أثناء الاحتفاظ، تظل المهام المفقودة تظهر في التدقيق كتحذيرات؛ بعد انتهاء cleanupAfter أو عند فقدان بيانات التنظيف الوصفية، تصبح أخطاء.
4

التقليم

يحذف السجلات التي تجاوزت تاريخ cleanupAfter الخاص بها.
الاحتفاظ: تُحفظ سجلات المهام النهائية لمدة 7 أيام، ثم تُقلّم تلقائيا. لا حاجة إلى ضبط.

​
كيف ترتبط المهام بالأنظمة الأخرى

Task Flow هو طبقة تنسيق التدفقات فوق المهام الخلفية. قد ينسق تدفق واحد عدة مهام خلال عمره باستخدام أوضاع مزامنة مُدارة أو معكوسة. استخدم openclaw tasks لفحص سجلات المهام الفردية وopenclaw tasks flow لفحص التدفق المنسّق.راجع Task Flow للتفاصيل.
يوجد تعريف مهمة Cron في ~/.openclaw/cron/jobs.json؛ وتوجد حالة التنفيذ وقت التشغيل بجانبه في ~/.openclaw/cron/jobs-state.json. ينشئ كل تنفيذ Cron سجل مهمة، سواء كان في الجلسة الرئيسية أو معزولا. تستخدم مهام Cron في الجلسة الرئيسية سياسة إشعار silent افتراضيا كي تتتبع دون إنشاء إشعارات.راجع مهام Cron.
تشغيلات Heartbeat هي دورات في الجلسة الرئيسية؛ إنها لا تنشئ سجلات مهام. عند اكتمال مهمة، يمكنها تشغيل تنبيه Heartbeat حتى ترى النتيجة بسرعة.راجع Heartbeat.
قد تشير المهمة إلى childSessionKey (حيث يجري العمل) وrequesterSessionKey (من بدأها). الجلسات هي سياق المحادثة؛ أما المهام فهي تتبع النشاط فوق ذلك.
يربط runId الخاص بالمهمة بتشغيل العامل الذي ينجز العمل. تحدّث أحداث دورة حياة العامل (البدء، والانتهاء، والخطأ) حالة المهمة تلقائيا؛ لست بحاجة إلى إدارة دورة الحياة يدويا.

​
ذو صلة