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 ที่มีรหัสการทำงาน/รหัสแหล่งที่มาจะถูกทำเครื่องหมายเป็น lost
เมื่อบริบทการทำงานจริงของ Gateway หายไป แม้ว่ายังมีแถวเซสชันลูกเก่าคงเหลืออยู่ก็ตาม
เมื่อดำเนินการ การบำรุงรักษาจะตัดแถวรีจิสทรีเซสชัน cron:<jobId>:run:<uuid>
ที่เก่ากว่า 7 วันด้วย โดยจะคงงาน 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
