CLI commands
`openclaw tasks`
افحص مهام الخلفية الدائمة وحالة Task Flow. عند عدم تحديد أمر فرعي،
يكون openclaw tasks مكافئًا لـ openclaw tasks list.
راجع مهام الخلفية للتعرّف على نموذج دورة الحياة والتسليم،
وقسم tasks audit فيها للاطلاع على الأوصاف الكاملة للنتائج.
الاستخدام
openclaw tasksopenclaw tasks listopenclaw tasks list --runtime acpopenclaw tasks list --status runningopenclaw tasks show <lookup>openclaw tasks notify <lookup> state_changesopenclaw tasks cancel <lookup>openclaw tasks auditopenclaw tasks maintenanceopenclaw tasks maintenance --applyopenclaw tasks flow listopenclaw tasks flow show <lookup>openclaw tasks flow cancel <lookup>خيارات الجذر
| العلامة | الوصف |
|---|---|
--json |
إخراج JSON. |
--runtime <name> |
التصفية حسب النوع: subagent أو acp أو cron أو cli. |
--status <name> |
التصفية حسب الحالة: queued أو running أو succeeded أو failed أو timed_out أو cancelled أو lost. |
الأوامر الفرعية
list
openclaw tasks list [--runtime <name>] [--status <name>] [--json]يسرد مهام الخلفية المتتبَّعة بدءًا من الأحدث.
show
openclaw tasks show <lookup> [--json]يعرض مهمة واحدة حسب معرّف المهمة أو معرّف التشغيل أو مفتاح الجلسة.
notify
openclaw tasks notify <lookup> <done_only|state_changes|silent>يغيّر سياسة الإشعارات لمهمة قيد التشغيل.
cancel
openclaw tasks cancel <lookup>يلغي مهمة خلفية قيد التشغيل.
audit
openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]يكشف سجلات المهام وTask Flow القديمة أو المفقودة أو التي فشل تسليمها أو غير المتسقة
بخلاف ذلك. تُعد المهام المفقودة المحتفظ بها حتى cleanupAfter تحذيرات؛
أما المهام المفقودة المنتهية الصلاحية أو غير المختومة فتُعد أخطاء.
تقبل --code رموز المهام (stale_queued وstale_running وlost
وdelivery_failed وmissing_cleanup وinconsistent_timestamps) ورموز Task
Flow (restore_failed وstale_waiting وstale_blocked
وcancel_stuck وmissing_linked_tasks وblocked_task_missing). راجع
مهام الخلفية للاطلاع على تفاصيل مستوى الخطورة ومشغّل كل
رمز.
maintenance
openclaw tasks maintenance [--apply] [--json]يعاين أو يطبّق تسوية المهام وTask Flow، وختم التنظيف، والتشذيب، وتنظيف سجل جلسات تشغيل cron القديمة.
بالنسبة إلى مهام cron، تستخدم التسوية سجلات التشغيل وحالة الوظيفة المحفوظة قبل
وضع علامة lost على مهمة نشطة قديمة، حتى لا تتحول عمليات تشغيل cron المكتملة
إلى أخطاء تدقيق زائفة لمجرد اختفاء حالة تشغيل Gateway الموجودة في الذاكرة.
لا يُعد تدقيق CLI دون اتصال مرجعًا حاسمًا لمجموعة وظائف cron النشطة المحلية
لعملية Gateway. توضع علامة lost على مهام CLI التي لها معرّف تشغيل/معرّف مصدر
عند اختفاء سياق تشغيل Gateway المباشر الخاص بها، حتى إذا بقي صف قديم لجلسة فرعية.
عند التطبيق، تشذّب الصيانة أيضًا صفوف سجل الجلسات
cron:<jobId>:run:<uuid> الأقدم من 7 أيام، مع الحفاظ على وظائف cron قيد
التشغيل حاليًا وترك صفوف الجلسات غير التابعة لـ cron دون تغيير.
flow
openclaw tasks flow list [--status <name>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>يفحص حالة Task Flow الدائمة أو يلغيها ضمن دفتر المهام.
يقبل flow list --status القيم queued أو running أو waiting أو blocked
أو succeeded أو failed أو cancelled أو lost.
