---
read_when:
    - می‌خواهید بدانید TaskFlow چگونه با وظایف پس‌زمینه ارتباط دارد
    - با Task Flow یا جریان وظایف OpenClaw در یادداشت‌های انتشار یا مستندات روبه‌رو می‌شوید
    - می‌خواهید وضعیت ماندگار جریان را بررسی یا مدیریت کنید
summary: لایه ارکستراسیون جریان Task Flow بالای وظایف پس‌زمینه
title: جریان کار
x-i18n:
    generated_at: "2026-05-10T19:21:15Z"
    model: gpt-5.5
    provider: openai
    source_hash: 135227b250840cd579f10a8ab4211e9319c447bb4d6df25907738ea138fc2d2a
    source_path: automation/taskflow.md
    workflow: 16
---

Task Flow زیرلایهٔ هماهنگ‌سازی جریان است که بالای [وظایف پس‌زمینه](/fa/automation/tasks) قرار می‌گیرد. این بخش جریان‌های چندمرحله‌ای پایدار را با وضعیت، رهگیری بازبینی و معناشناسی همگام‌سازی مخصوص خود مدیریت می‌کند، در حالی که وظایف منفرد همچنان واحد کار جداشده باقی می‌مانند.

## چه زمانی از Task Flow استفاده کنیم

وقتی کار شامل چند مرحلهٔ ترتیبی یا شاخه‌دار است و به رهگیری پایدار پیشرفت در میان راه‌اندازی‌های دوبارهٔ Gateway نیاز دارید، از Task Flow استفاده کنید. برای عملیات پس‌زمینهٔ تکی، یک [وظیفه](/fa/automation/tasks) ساده کافی است.

| سناریو                               | استفاده             |
| ------------------------------------ | ------------------- |
| کار پس‌زمینهٔ تکی                    | وظیفهٔ ساده         |
| خط لولهٔ چندمرحله‌ای (A سپس B سپس C) | Task Flow (مدیریت‌شده) |
| مشاهدهٔ وظایف ایجادشده از بیرون      | Task Flow (بازتابی) |
| یادآور یک‌باره                       | کار Cron            |

## الگوی گردش‌کار زمان‌بندی‌شدهٔ قابل‌اعتماد

برای گردش‌کارهای تکرارشونده مانند گزارش‌های هوش بازار، زمان‌بندی، هماهنگ‌سازی و بررسی‌های اطمینان‌پذیری را به‌عنوان لایه‌های جداگانه در نظر بگیرید:

1. برای زمان‌بندی از [وظایف زمان‌بندی‌شده](/fa/automation/cron-jobs) استفاده کنید.
2. وقتی گردش‌کار باید بر زمینهٔ قبلی بنا شود، از یک نشست Cron پایدار استفاده کنید.
3. برای مراحل قطعی، دروازه‌های تأیید و توکن‌های ازسرگیری از [Lobster](/fa/tools/lobster) استفاده کنید.
4. برای رهگیری اجرای چندمرحله‌ای در میان وظایف فرزند، انتظارها، تلاش‌های دوباره و راه‌اندازی‌های دوبارهٔ Gateway از Task Flow استفاده کنید.

شکل نمونهٔ 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"
```

وقتی گردش‌کار تکرارشونده به تاریخچهٔ عمدی، خلاصه‌های اجرای قبلی یا زمینهٔ ثابت نیاز دارد، به‌جای `isolated` از `session:<id>` استفاده کنید. وقتی هر اجرا باید از نو شروع شود و همهٔ وضعیت موردنیاز به‌صورت صریح در گردش‌کار آمده است، از `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 واردشده لازم است. [مرورگر](/fa/tools/browser) را ببینید.
- اعتبارنامه‌های API و سهمیه برای هر منبع.
- دسترسی‌پذیری شبکه برای نقاط پایانی موردنیاز.
- ابزارهای موردنیاز فعال‌شده برای عامل، مانند `lobster`، `browser` و `llm-task`.
- مقصد شکست پیکربندی‌شده برای Cron تا شکست‌های پیش از اجرا قابل مشاهده باشند. [وظایف زمان‌بندی‌شده](/fa/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](/fa/tools/llm-task) استفاده کنید.

برای گردش‌کارهای قابل‌استفادهٔ مجدد تیمی یا اجتماعی، CLI، فایل‌های `.lobster` و هر یادداشت راه‌اندازی را به‌صورت یک skill یا plugin بسته‌بندی کنید و آن را از طریق [ClawHub](/fa/clawhub) منتشر کنید. گاردریل‌های مخصوص گردش‌کار را در همان بسته نگه دارید، مگر اینکه API plugin فاقد یک قابلیت عمومی موردنیاز باشد.

## حالت‌های همگام‌سازی

### حالت مدیریت‌شده

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 با نگه‌داری محدود write-ahead-log استفاده می‌کند، از جمله
checkpointهای دوره‌ای و هنگام خاموشی، تا 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` استفاده کنید.

## مرتبط

- [وظایف پس‌زمینه](/fa/automation/tasks) — دفترکل کار جداشده‌ای که جریان‌ها هماهنگ می‌کنند
- [CLI: وظایف](/fa/cli/tasks) — مرجع فرمان CLI برای `openclaw tasks flow`
- [نمای کلی خودکارسازی](/fa/automation) — همهٔ سازوکارهای خودکارسازی در یک نگاه
- [کارهای Cron](/fa/automation/cron-jobs) — کارهای زمان‌بندی‌شده‌ای که ممکن است به جریان‌ها خوراک بدهند