جریان وظیفه

Task Flow زیرلایه هماهنگ‌سازی جریان است که بالای وظایف پس‌زمینه قرار می‌گیرد. این زیرلایه جریان‌های بادوام چندمرحله‌ای را با وضعیت، رهگیری بازبینی، و معناشناسی همگام‌سازی خودشان مدیریت می‌کند، در حالی که هر وظیفه همچنان واحد کار جداشده باقی می‌ماند.

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

وقتی کار شامل چند مرحله ترتیبی یا شاخه‌دار است و به رهگیری بادوام پیشرفت در طول راه‌اندازی‌های دوباره Gateway نیاز دارید، از Task Flow استفاده کنید. برای عملیات‌های پس‌زمینه تک‌مرحله‌ای، یک وظیفه ساده کافی است.

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

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

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

1. برای زمان‌بندی از وظایف زمان‌بندی‌شده استفاده کنید.
2. وقتی گردش‌کار باید بر زمینه قبلی تکیه کند، از یک نشست cron پایدار استفاده کنید.
3. برای مراحل قطعی، دروازه‌های تأیید، و توکن‌های ازسرگیری از Lobster استفاده کنید.
4. برای رهگیری اجرای چندمرحله‌ای در میان وظایف فرزند، انتظارها، تلاش‌های دوباره، و راه‌اندازی‌های دوباره Gateway از Task Flow استفاده کنید.

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

وقتی گردش‌کار تکرارشونده به تاریخچه آگاهانه، خلاصه‌های اجرای قبلی، یا زمینه پایدار نیاز دارد، به‌جای isolated از session:<id> استفاده کنید. وقتی هر اجرا باید تازه شروع شود و همه وضعیت موردنیاز به‌طور صریح در گردش‌کار آمده است، از 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 Task استفاده کنید.

برای گردش‌کارهای قابل‌استفاده‌مجدد تیمی یا اجتماعی، CLI، فایل‌های .lobster، و هر یادداشت راه‌اندازی را به‌صورت یک skill یا plugin بسته‌بندی کنید و آن را از طریق 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

# 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 استفاده کنید.

# مرتبط

• وظایف پس‌زمینه — دفتر کل کارهای جداشده‌ای که جریان‌ها هماهنگ می‌کنند
• CLI: وظایف — مرجع فرمان CLI برای openclaw tasks flow
• نمای کلی اتوماسیون — همه سازوکارهای اتوماسیون در یک نگاه
• کارهای Cron — کارهای زمان‌بندی‌شده‌ای که ممکن است به جریان‌ها خوراک بدهند