CLI commands
`openclaw tasks`
وظایف پسزمینهٔ ماندگار و وضعیت Task Flow را بررسی کنید. در صورت نبود زیرفرمان،
openclaw tasks معادل openclaw tasks list است.
برای آگاهی از چرخهٔ حیات و مدل تحویل، به وظایف پسزمینه و برای توضیحات کامل یافتهها به بخش tasks audit آن مراجعه کنید.
نحوهٔ استفاده
openclaw tasksopenclaw tasks listopenclaw tasks list --runtime acpopenclaw tasks list --status runningopenclaw tasks show <lookup>openclaw tasks notify <lookup> state_changesopenclaw tasks cancel <lookup>openclaw tasks auditopenclaw tasks maintenanceopenclaw tasks maintenance --applyopenclaw tasks flow listopenclaw tasks flow show <lookup>openclaw tasks flow cancel <lookup>گزینههای ریشه
| پرچم | توضیحات |
|---|---|
--json |
خروجی را در قالب JSON ارائه میکند. |
--runtime <name> |
بر اساس نوع فیلتر میکند: subagent، acp، cron یا cli. |
--status <name> |
بر اساس وضعیت فیلتر میکند: queued، running، succeeded، failed، timed_out، cancelled یا lost. |
زیرفرمانها
list
openclaw tasks list [--runtime <name>] [--status <name>] [--json]وظایف پسزمینهٔ رهگیریشده را از جدیدترین به قدیمیترین فهرست میکند.
show
openclaw tasks show <lookup> [--json]یک وظیفه را بر اساس شناسهٔ وظیفه، شناسهٔ اجرا یا کلید نشست نمایش میدهد.
notify
openclaw tasks notify <lookup> <done_only|state_changes|silent>سیاست اعلان یک وظیفهٔ در حال اجرا را تغییر میدهد.
cancel
openclaw tasks cancel <lookup>یک وظیفهٔ پسزمینهٔ در حال اجرا را لغو میکند.
audit
openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]رکوردهای کهنه، ازدسترفته، ناموفق در تحویل یا بهشکل دیگری ناسازگارِ وظایف و
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
openclaw tasks maintenance [--apply] [--json]همگامسازی وظایف و Task Flow، ثبت مهر پاکسازی، هرسکردن و پاکسازی رجیستری نشست اجرای cron کهنه را پیشنمایش یا اعمال میکند.
برای وظایف cron، فرایند همگامسازی پیش از علامتگذاری یک وظیفهٔ فعال قدیمی بهعنوان lost
از گزارشهای اجرای پایدارشده و وضعیت کار استفاده میکند؛ بنابراین اجرای تکمیلشدهٔ cron صرفاً بهدلیل از بین رفتن
وضعیت زماناجرای درونحافظهای Gateway به خطای ممیزی کاذب تبدیل نمیشود.
ممیزی آفلاین CLI برای مجموعهٔ محلیِ فرایندِ کارهای فعال cron در Gateway
مرجع قطعی نیست. وظایف CLI دارای شناسهٔ اجرا/شناسهٔ منبع، هنگامی که
بافت اجرای زندهٔ Gateway آنها از بین رفته باشد lost علامتگذاری میشوند، حتی اگر یک ردیف قدیمی نشست فرزند
باقی مانده باشد.
هنگام اعمال، نگهداری همچنین ردیفهای رجیستری نشست cron:<jobId>:run:<uuid> را که
بیش از ۷ روز قدمت دارند هرس میکند، درحالیکه کارهای cron در حال اجرا را حفظ کرده
و ردیفهای نشست غیر cron را دستنخورده باقی میگذارد.
flow
openclaw tasks flow list [--status <name>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>وضعیت ماندگار Task Flow را در دفتر وظایف بررسی یا لغو میکند.
flow list --status مقادیر queued، running، waiting، blocked،
succeeded، failed، cancelled یا lost را میپذیرد.
