در این صفحه
در این صفحه
Get started
`openclaw tasks`
وظایف پس‌زمینهٔ پایدار و وضعیت Task Flow را بررسی کنید. در صورت نبود زیرفرمان،
openclaw tasks معادل openclaw tasks list است.
برای آشنایی با چرخهٔ حیات و مدل تحویل، به وظایف پس‌زمینه
و برای توضیحات کامل یافته‌ها به بخش tasks audit آن مراجعه کنید.
نحوهٔ استفاده
گزینه‌های ریشه
| پرچم | توضیحات |
|---|---|
--json |
خروجی JSON. |
--runtime <name> |
فیلتر بر اساس نوع: subagent، acp، cron یا cli. |
--status <name> |
فیلتر بر اساس وضعیت: queued، running، succeeded، failed، timed_out، cancelled یا lost. |
زیرفرمان‌ها
list
وظایف پس‌زمینهٔ رهگیری‌شده را از جدیدترین به قدیمی‌ترین فهرست می‌کند.
show
یک وظیفه را بر اساس شناسهٔ وظیفه، شناسهٔ اجرا یا کلید نشست نمایش می‌دهد.
notify
خط‌مشی اعلان را برای یک وظیفهٔ در حال اجرا تغییر می‌دهد.
cancel
یک وظیفهٔ پس‌زمینهٔ در حال اجرا را لغو می‌کند.
audit
رکوردهای کهنه، مفقود، ناموفق در تحویل یا به‌شکلی دیگر ناسازگارِ وظیفه و
Task Flow را آشکار می‌کند. وظایف مفقودی که تا cleanupAfter نگه داشته شده‌اند، هشدار هستند؛
وظایف مفقود منقضی‌شده یا بدون مُهر، خطا هستند.
--code کدهای وظیفه (stale_queued، stale_running، lost،
delivery_failed، missing_cleanup، inconsistent_timestamps) و کدهای Task
Flow (restore_failed، stale_waiting، stale_blocked،
cancel_stuck، missing_linked_tasks، blocked_task_missing) را می‌پذیرد. برای
جزئیات شدت و محرک هر کد، به وظایف پس‌زمینه
مراجعه کنید.
maintenance
پیش‌نمایشی از تطبیق وظیفه و Task Flow، مُهرگذاری پاک‌سازی، هرس و پاک‌سازی رجیستری نشست اجرای cron کهنه ارائه می‌دهد یا آن‌ها را اعمال می‌کند.
برای وظایف cron، تطبیق پیش از علامت‌گذاری یک وظیفهٔ فعال قدیمی به‌عنوان
lost، از گزارش‌های اجرای ماندگار/وضعیت کار استفاده می‌کند؛ بنابراین اجراهای تکمیل‌شدهٔ cron
صرفاً به‌دلیل از بین رفتن وضعیت زمان اجرای درون‌حافظه‌ای Gateway به خطاهای کاذب
ممیزی تبدیل نمی‌شوند. ممیزی آفلاین CLI برای مجموعهٔ محلیِ فرایندِ کارهای فعال cron
در Gateway مرجع قطعی نیست. وظایف CLI دارای شناسهٔ اجرا/شناسهٔ منبع، هنگامی که
بافت اجرای زندهٔ Gateway آن‌ها از بین رفته باشد، با lost علامت‌گذاری می‌شوند؛ حتی اگر
یک ردیف قدیمی نشست فرزند همچنان باقی مانده باشد.
هنگام اعمال، نگه‌داری همچنین ردیف‌های رجیستری نشست cron:<jobId>:run:<uuid>
قدیمی‌تر از 7 روز را هرس می‌کند، درحالی‌که کارهای cron در حال اجرا را حفظ کرده
و ردیف‌های نشست غیر cron را دست‌نخورده باقی می‌گذارد.
flow
وضعیت پایدار Task Flow را در دفتر وظایف بررسی یا لغو می‌کند.
flow list --status مقادیر queued، running، waiting، blocked،
succeeded، failed، cancelled یا lost را می‌پذیرد.
