جریان کار

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

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

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

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

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

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-briefsteps:  - 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 و هر یادداشت راه‌اندازی را به‌صورت یک 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 flowsopenclaw tasks flow list # Show details for a specific flowopenclaw tasks flow show <lookup> # Cancel a running flow and its active tasksopenclaw tasks flow cancel <lookup>

ارتباط جریان‌ها با وظایف

جریان‌ها وظایف را هماهنگ می‌کنند، نه اینکه جایگزین آن‌ها شوند. یک جریان تکی ممکن است در طول عمر خود چندین وظیفهٔ پس‌زمینه را هدایت کند. برای بررسی رکوردهای وظیفهٔ منفرد از openclaw tasks و برای بررسی جریان هماهنگ‌کننده از openclaw tasks flow استفاده کنید.

مرتبط

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