---
read_when:
    - تريد فهم علاقة تدفق المهام بالمهام الخلفية
    - تصادف TaskFlow أو تدفق مهام OpenClaw في ملاحظات الإصدار أو الوثائق
    - تريد فحص حالة التدفق الدائمة أو إدارتها
summary: طبقة تنسيق تدفق المهام فوق المهام الخلفية
title: تدفق المهام
x-i18n:
    generated_at: "2026-07-02T08:20:26Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: e4f5ff3c9a68eb0408a180bc947a03b410568d7914cb1c1d7f31d6013e036096
    source_path: automation/taskflow.md
    workflow: 16
---

تدفق المهام هو طبقة تنظيم التدفقات التي تقع فوق [المهام الخلفية](/ar/automation/tasks). يدير تدفقات متينة متعددة الخطوات لها حالتها الخاصة، وتتبع المراجعات، ودلالات المزامنة، بينما تبقى المهام الفردية وحدة العمل المنفصل.

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

استخدم تدفق المهام عندما يمتد العمل عبر خطوات متعددة متسلسلة أو متفرعة وتحتاج إلى تتبع متين للتقدم عبر إعادات تشغيل Gateway. بالنسبة إلى العمليات الخلفية الفردية، تكفي [مهمة](/ar/automation/tasks) عادية.

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

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

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

1. استخدم [المهام المجدولة](/ar/automation/cron-jobs) للتوقيت.
2. استخدم جلسة Cron مستمرة عندما ينبغي أن يبني سير العمل على سياق سابق.
3. استخدم [Lobster](/ar/tools/lobster) للخطوات الحتمية، وبوابات الموافقة، ورموز الاستئناف.
4. استخدم تدفق المهام لتتبع التشغيل متعدد الخطوات عبر المهام الفرعية، والانتظارات، وإعادات المحاولة، وإعادات تشغيل Gateway.

مثال على شكل Cron:

```bash
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:

```yaml
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 مسجلاً الدخول إليها مطلوبة. راجع [المتصفح](/ar/tools/browser).
- بيانات اعتماد API والحصة لكل مصدر.
- قابلية الوصول عبر الشبكة إلى نقاط النهاية المطلوبة.
- الأدوات المطلوبة مفعلة للوكيل، مثل `lobster` و`browser` و`llm-task`.
- وجهة الفشل مهيأة لـ Cron بحيث تكون إخفاقات ما قبل التشغيل مرئية. راجع [المهام المجدولة](/ar/automation/cron-jobs#delivery-and-output).

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

```json
{
  "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](/ar/tools/llm-task) عندما تحتاج إلى خطوة نموذج متحقق منها بالمخطط داخل سير العمل.

بالنسبة إلى سير العمل القابل لإعادة الاستخدام ضمن الفريق أو المجتمع، حزّم CLI وملفات `.lobster` وأي ملاحظات إعداد كـ skill أو plugin وانشرها عبر [ClawHub](/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

```bash
# 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` لفحص التدفق المنظم.

## ذات صلة

- [المهام الخلفية](/ar/automation/tasks) — سجل العمل المنفصل الذي تنسقه التدفقات
- [CLI: المهام](/ar/cli/tasks) — مرجع أوامر CLI لـ `openclaw tasks flow`
- [نظرة عامة على الأتمتة](/ar/automation) — جميع آليات الأتمتة في لمحة
- [مهام Cron](/ar/automation/cron-jobs) — مهام مجدولة قد تغذي التدفقات