مهام الخلفية

تتتبع مهام الخلفية العمل الذي يعمل خارج جلسة المحادثة الرئيسية: تشغيلات ACP، وإنشاءات الوكلاء الفرعيين، وتنفيذات مهام cron المعزولة، والعمليات التي تبدأها CLI.

لا تستبدل المهام الجلسات أو مهام cron أو heartbeats - فهي سجل النشاط الذي يسجل العمل المنفصل الذي حدث، ومتى حدث، وما إذا كان قد نجح.

# المختصر

• المهام سجلات وليست مجدولات - يحدد 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

# Show details for a specific task (by ID, run ID, or session key)
openclaw tasks show <lookup>

# Cancel a running task (kills the child session)
openclaw tasks cancel <lookup>

# Change notification policy for a task
openclaw tasks notify <lookup> state_changes

# Run a health audit
openclaw tasks audit

# Preview or apply maintenance
openclaw tasks maintenance
openclaw tasks maintenance --apply

# Inspect TaskFlow state
openclaw tasks flow list
openclaw tasks flow show <lookup>
openclaw tasks flow cancel <lookup>

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

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

stateDiagram-v2
    [*] --> queued
    queued --> running : agent starts
    running --> succeeded : completes ok
    running --> failed : error
    running --> timed_out : timeout exceeded
    running --> cancelled : operator cancels
    queued --> lost : session gone > 5 min
    running --> lost : session gone > 5 min

تحدث الانتقالات تلقائيا - عندما ينتهي تشغيل الوكيل المرتبط، يتم تحديث حالة المهمة لتطابقه.

اكتمال تشغيل الوكيل هو المرجع الموثوق لسجلات المهام النشطة. ينتهي التشغيل المنفصل الناجح كـ succeeded، وتنتهي أخطاء التشغيل العادية كـ failed، وتنتهي نتائج المهلة أو الإيقاف كـ timed_out. إذا كان المشغل قد ألغى المهمة بالفعل، أو كان وقت التشغيل قد سجل بالفعل حالة نهائية أقوى مثل failed أو timed_out أو lost، فلا تخفض إشارة نجاح لاحقة تلك الحالة النهائية.

lost واعية بوقت التشغيل:

• مهام ACP: اختفت بيانات تعريف جلسة ACP الفرعية الداعمة.
• مهام الوكيل الفرعي: اختفت الجلسة الفرعية الداعمة من مخزن الوكيل الهدف.
• مهام Cron: لم يعد وقت تشغيل cron يتتبع المهمة كنشطة ولا يظهر سجل تشغيل cron الدائم نتيجة نهائية لذلك التشغيل. لا يعامل تدقيق CLI دون اتصال حالة وقت تشغيل cron الفارغة داخل العملية الخاصة به كمرجع.
• مهام CLI: تستخدم مهام الجلسة الفرعية المعزولة الجلسة الفرعية؛ أما مهام CLI المدعومة بالمحادثة فتستخدم سياق التشغيل الحي بدلا من ذلك، لذلك لا تبقي صفوف جلسات القناة/المجموعة/المباشر العالقة هذه المهام حية. كذلك تنتهي تشغيلات openclaw agent المدعومة بـ Gateway من نتيجة تشغيلها، لذلك لا تبقى التشغيلات المكتملة نشطة حتى يضعها الكانس كـ lost.

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

عندما تصل مهمة إلى حالة نهائية، يخطرك OpenClaw. توجد مسارا تسليم:

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

التسليم في قائمة انتظار الجلسة - إذا فشل التسليم المباشر أو لم يتم تعيين أصل، يتم وضع التحديث في قائمة الانتظار كحدث نظام في جلسة الطالب ويظهر عند heartbeat التالي.

يعني ذلك أن سير العمل المعتاد قائم على الدفع: ابدأ العمل المنفصل مرة واحدة، ثم دع وقت التشغيل يوقظك أو يخطرك عند الاكتمال. استطلع حالة المهمة فقط عندما تحتاج إلى تصحيح أخطاء أو تدخل أو تدقيق صريح.

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

تحكم في مقدار ما تسمعه عن كل مهمة:

غيّر السياسة أثناء تشغيل مهمة:

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>

openclaw tasks notify <lookup> <done_only|state_changes|silent>

openclaw tasks audit [--json]

openclaw tasks maintenance [--json]
openclaw tasks maintenance --apply [--json]

openclaw tasks flow list [--status <status>] [--json]
openclaw tasks flow show <lookup> [--json]
openclaw tasks flow cancel <lookup>

# لوحة مهام المحادثة (/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 محدوداً باستخدام عتبة autocheckpoint الافتراضية في SQLite مع نقاط فحص دورية وعند الإيقاف من نوع TRUNCATE.

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

يعمل ماسح كل 60 ثانية ويتولى أربعة أمور:

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

# ذو صلة

• الأتمتة والمهام - كل آليات الأتمتة في لمحة
• CLI: المهام - مرجع أوامر CLI
• Heartbeat - أدوار دورية في الجلسة الرئيسية
• المهام المجدولة - جدولة العمل في الخلفية
• Task Flow - تنسيق التدفق فوق المهام