---
read_when:
    - تريد فهم كيفية ارتباط Task Flow بالمهام الخلفية
    - تصادف Task Flow أو openclaw tasks flow في ملاحظات الإصدار أو المستندات
    - تريد فحص حالة التدفق المستدامة أو إدارتها
summary: طبقة تنسيق التدفقات Task Flow فوق المهام الخلفية
title: Task Flow
x-i18n:
    generated_at: "2026-04-05T12:34:14Z"
    model: gpt-5.4
    provider: openai
    source_hash: 172871206b839845db807d9c627015890f7733b862e276853d5dbfbe29e03883
    source_path: automation/taskflow.md
    workflow: 15
---

# Task Flow

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

## متى تستخدم Task Flow

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

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

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

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

تتولى 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 مستقلة تشكّل معًا روتين "عمليات الصباح". يتتبع التدفق المعكوس تقدمها الجماعي من دون التحكم في وقت تشغيلها أو كيفية تشغيلها.

## الحالة المستدامة وتتبع المراجعات

يحفظ كل تدفق حالته الخاصة ويتتبع المراجعات بحيث يستمر التقدم عبر عمليات إعادة تشغيل البوابة. ويتيح تتبع المراجعات اكتشاف التعارضات عندما تحاول مصادر متعددة تقديم التدفق نفسه بالتزامن.

## سلوك الإلغاء

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

## أوامر 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` لفحص التدفق المنسِّق.

## ذو صلة

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