سير المهام

Task Flow هو طبقة تنظيم التدفقات التي تقع فوق المهام الخلفية. يدير تدفقات متينة متعددة الخطوات بحالتها الخاصة، وتتبع المراجعات، ودلالات المزامنة، بينما تظل المهام الفردية هي وحدة العمل المنفصل.

متى تستخدم Task Flow

استخدم Task Flow عندما يمتد العمل عبر خطوات متعددة متسلسلة أو متفرعة وتحتاج إلى تتبع متين للتقدم عبر عمليات إعادة تشغيل Gateway. بالنسبة إلى العمليات الخلفية المنفردة، تكفي مهمة عادية.

نمط سير عمل مجدول موثوق

بالنسبة إلى تدفقات العمل المتكررة مثل موجزات معلومات السوق، تعامل مع الجدولة، والتنظيم، وفحوصات الموثوقية كطبقات منفصلة:

1. استخدم المهام المجدولة للتوقيت.
2. استخدم جلسة cron مستمرة عندما يجب أن يبني سير العمل على سياق سابق.
3. استخدم Lobster للخطوات الحتمية، وبوابات الموافقة، ورموز الاستئناف.
4. استخدم Task Flow لتتبع التشغيل متعدد الخطوات عبر المهام الفرعية، والانتظارات، وإعادات المحاولة، وعمليات إعادة تشغيل Gateway.

شكل cron نموذجي:

openclaw cron add \  --name "Market intelligence brief" \  --cron "0 7 * * 1-5" \  --tz "America/New_York" \  --session session:market-intel \  --message "Run the market-intel Lobster workflow. Verify source freshness before summarizing." \  --announce \  --channel slack \  --to "channel:C1234567890"

استخدم session:<id> بدلًا من isolated عندما يحتاج سير العمل المتكرر إلى سجل مقصود، أو ملخصات تشغيل سابقة، أو سياق قائم. استخدم isolated عندما يجب أن يبدأ كل تشغيل من جديد وتكون كل الحالة المطلوبة صريحة في سير العمل.

داخل سير العمل، ضع فحوصات الموثوقية قبل خطوة ملخص LLM:

name: market-intel-briefsteps:  - id: preflight    command: market-intel check --json  - id: collect    command: market-intel collect --json    stdin: $preflight.json  - id: summarize    command: market-intel summarize --json    stdin: $collect.json  - id: approve    command: market-intel deliver --preview    stdin: $summarize.json    approval: required  - id: deliver    command: market-intel deliver --execute    stdin: $summarize.json    condition: $approve.approved

فحوصات preflight الموصى بها:

• توفر المتصفح واختيار الملف الشخصي، على سبيل المثال openclaw للحالة المُدارة أو user عندما تكون جلسة Chrome مُسجلة الدخول مطلوبة. راجع المتصفح.
• بيانات اعتماد API والحصة لكل مصدر.
• إمكانية الوصول عبر الشبكة إلى نقاط النهاية المطلوبة.
• تفعيل الأدوات المطلوبة للوكيل، مثل lobster، وbrowser، وllm-task.
• تكوين وجهة الفشل لـ cron بحيث تكون إخفاقات preflight مرئية. راجع المهام المجدولة.

حقول مصدر البيانات الموصى بها لكل عنصر مُجمّع:

{  "sourceUrl": "https://example.com/report",  "retrievedAt": "2026-04-24T12:00:00Z",  "asOf": "2026-04-24",  "title": "Example report",  "content": "..."}

اجعل سير العمل يرفض العناصر القديمة أو يضع علامة عليها قبل التلخيص. يجب أن تتلقى خطوة LLM JSON منظمًا فقط، ويجب أن يُطلب منها الحفاظ على sourceUrl وretrievedAt وasOf في مخرجاتها. استخدم LLM Task عندما تحتاج إلى خطوة نموذج مُتحقق منها بالمخطط داخل سير العمل.

بالنسبة إلى تدفقات العمل القابلة لإعادة الاستخدام للفِرق أو المجتمع، حزّم CLI، وملفات .lobster، وأي ملاحظات إعداد كـ skill أو plugin وانشرها عبر ClawHub. أبقِ حواجز الحماية الخاصة بسير العمل داخل تلك الحزمة ما لم تكن واجهة plugin API تفتقد قدرة عامة مطلوبة.

أوضاع المزامنة

الوضع المُدار

يمتلك Task Flow دورة الحياة من البداية إلى النهاية. ينشئ المهام كخطوات تدفق، ويدفعها إلى الإكمال، ويُقدّم حالة التدفق تلقائيًا.

مثال: تدفق تقرير أسبوعي يقوم بـ (1) جمع البيانات، و(2) إنشاء التقرير، و(3) تسليمه. ينشئ Task Flow كل خطوة كمهمة خلفية، وينتظر اكتمالها، ثم ينتقل إلى الخطوة التالية.

Flow: weekly-report  Step 1: gather-data     → task created → succeeded  Step 2: generate-report → task created → succeeded  Step 3: deliver         → task created → running

الوضع المعكوس

يراقب Task Flow المهام المُنشأة خارجيًا ويحافظ على مزامنة حالة التدفق دون امتلاك إنشاء المهام. يكون ذلك مفيدًا عندما تنشأ المهام من وظائف cron، أو أوامر CLI، أو مصادر أخرى، وتريد عرضًا موحدًا لتقدمها كتدفق.

مثال: ثلاث وظائف cron مستقلة تُشكّل معًا روتين "عمليات الصباح". يتتبع تدفق معكوس تقدمها الجماعي دون التحكم في وقت تشغيلها أو كيفية تشغيلها.

الحالة المتينة وتتبع المراجعات

يحتفظ كل تدفق بحالته الخاصة ويتتبع المراجعات بحيث ينجو التقدم من عمليات إعادة تشغيل Gateway. يتيح تتبع المراجعات اكتشاف التعارضات عندما تحاول مصادر متعددة تقديم التدفق نفسه في الوقت ذاته. يستخدم سجل التدفقات SQLite مع صيانة محدودة لسجل الكتابة المسبقة، بما في ذلك نقاط تحقق دورية وعند إيقاف التشغيل، حتى لا تحتفظ بوابات Gateway طويلة التشغيل بملفات جانبية غير محدودة من نوع registry.sqlite-wal.

سلوك الإلغاء

يضبط openclaw tasks flow cancel نية إلغاء ثابتة على التدفق. تُلغى المهام النشطة داخل التدفق، ولا تبدأ أي خطوات جديدة. تستمر نية الإلغاء عبر عمليات إعادة التشغيل، لذلك يبقى التدفق الملغى ملغى حتى إذا أُعيد تشغيل Gateway قبل انتهاء كل المهام الفرعية.

أوامر CLI

# List active and recent flowsopenclaw tasks flow list # Show details for a specific flowopenclaw tasks flow show <lookup> # Cancel a running flow and its active tasksopenclaw tasks flow cancel <lookup>

علاقة التدفقات بالمهام

تنسق التدفقات المهام ولا تستبدلها. قد يقود تدفق واحد عدة مهام خلفية طوال عمره. استخدم openclaw tasks لفحص سجلات المهام الفردية، وopenclaw tasks flow لفحص التدفق المنظم.

ذات صلة

• المهام الخلفية — سجل العمل المنفصل الذي تنسقه التدفقات
• CLI: المهام — مرجع أوامر CLI لـ openclaw tasks flow
• نظرة عامة على الأتمتة — جميع آليات الأتمتة بلمحة واحدة
• وظائف Cron — وظائف مجدولة قد تغذي التدفقات