تدفق المهام

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

متى تستخدم تدفق المهام

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

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

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

1. استخدم المهام المجدولة للتوقيت.
2. استخدم جلسة Cron مستمرة عندما ينبغي أن يبني سير العمل على سياق سابق.
3. استخدم Lobster للخطوات الحتمية، وبوابات الموافقة، ورموز الاستئناف.
4. استخدم تدفق المهام لتتبع التشغيل متعدد الخطوات عبر المهام الفرعية، والانتظارات، وإعادات المحاولة، وإعادات تشغيل 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

فحوصات ما قبل التشغيل الموصى بها:

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

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

{  "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 عندما تحتاج إلى خطوة نموذج متحقق منها بالمخطط داخل سير العمل.

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

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

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

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

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

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

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

يراقب تدفق المهام المهام المنشأة خارجياً ويحافظ على تزامن حالة التدفق دون امتلاك إنشاء المهام. هذا مفيد عندما تنشأ المهام من مهام 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 — مهام مجدولة قد تغذي التدفقات