English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Automation and tasks

تدفق المهام

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

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

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

السيناريو الاستخدام
مهمة خلفية واحدة مهمة عادية
خط أنابيب متعدد الخطوات (A ثم B ثم C) تدفق المهام (مُدار)
مراقبة المهام المنشأة خارجيًا تدفق المهام (معكوس)
تذكير لمرة واحدة مهمة Cron

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

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

  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-brief
steps:
  - 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، وأي ملاحظات إعداد كمهارة أو 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 flows
openclaw tasks flow list

# Show details for a specific flow
openclaw tasks flow show <lookup>

# Cancel a running flow and its active tasks
openclaw tasks flow cancel <lookup>
الأمر الوصف
openclaw tasks flow list يعرض التدفقات المتتبعة مع الحالة ووضع المزامنة
openclaw tasks flow show <id> افحص تدفقًا واحدًا حسب معرف التدفق أو مفتاح البحث
openclaw tasks flow cancel <id> ألغِ تدفقًا قيد التشغيل ومهامه النشطة

كيف ترتبط التدفقات بالمهام

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

ذات صلة