งานเบื้องหลัง

งานเบื้องหลังติดตามงานที่ทำงาน นอกเซสชันการสนทนาหลัก ได้แก่ การทำงานของ ACP, การสร้างเอเจนต์ย่อย, การดำเนินงาน cron และการดำเนินการที่เริ่มต้นผ่าน CLI

งาน ไม่ ได้มาแทนที่เซสชัน งาน cron หรือ Heartbeat แต่เป็น บัญชีบันทึกกิจกรรม ที่บันทึกว่าเกิดงานแบบแยกออกไปใดขึ้น เมื่อใด และสำเร็จหรือไม่

สรุปย่อ

• งานคือ ระเบียน ไม่ใช่ตัวกำหนดเวลา โดย cron และ Heartbeat เป็นผู้ตัดสินว่า เมื่อใด งานจะทำงาน ส่วนงานจะติดตามว่า เกิดอะไรขึ้น
• ACP, เอเจนต์ย่อย, งาน cron ทั้งหมด และการดำเนินการ CLI จะสร้างงาน แต่รอบ Heartbeat จะไม่สร้าง
• งานแต่ละรายการจะเปลี่ยนสถานะผ่าน queued → running → terminal (สำเร็จ ล้มเหลว หมดเวลา ถูกยกเลิก หรือสูญหาย)
• งาน cron จะยังคงทำงานอยู่ตราบใดที่รันไทม์ cron ยังเป็นเจ้าของงานนั้น หากสถานะรันไทม์ในหน่วยความจำหายไป การบำรุงรักษางานจะตรวจสอบประวัติการทำงาน cron แบบถาวรก่อนทำเครื่องหมายว่างานสูญหาย
• การเสร็จสิ้นขับเคลื่อนด้วยการส่งข้อมูล: งานแบบแยกออกไปสามารถแจ้งเตือนได้โดยตรงหรือปลุกเซสชัน/Heartbeat ของผู้ร้องขอเมื่อเสร็จสิ้น ดังนั้นลูปสำรวจสถานะจึงมักไม่ใช่รูปแบบที่เหมาะสม
• การทำงาน cron แบบแยกและการเสร็จสิ้นของเอเจนต์ย่อยจะพยายามล้างแท็บ/โพรเซสของเบราว์เซอร์ที่ติดตามสำหรับเซสชันลูกก่อนบันทึกการล้างข้อมูลขั้นสุดท้าย
• การส่งมอบ cron แบบแยกจะระงับการตอบกลับระหว่างทางของพาเรนต์ที่ล้าสมัย ขณะที่งานของเอเจนต์ย่อยสืบทอดยังอยู่ระหว่างการดำเนินงานให้เสร็จ และจะเลือกผลลัพธ์สุดท้ายจากงานสืบทอดหากผลลัพธ์นั้นมาถึงก่อนการส่งมอบ
• การแจ้งเตือนเมื่อเสร็จสิ้นจะถูกส่งไปยังช่องโดยตรงหรือเข้าคิวสำหรับ Heartbeat ครั้งถัดไป
• openclaw tasks list แสดงงานทั้งหมด ส่วน openclaw tasks audit แสดงปัญหา
• ระเบียนสถานะสิ้นสุดจะเก็บไว้ 7 วัน (ระเบียน lost เก็บไว้ 24 ชั่วโมง) จากนั้นจะถูกล้างโดยอัตโนมัติ

เริ่มต้นใช้งานอย่างรวดเร็ว

# แสดงงานทั้งหมด (งานล่าสุดก่อน)openclaw tasks list # กรองตามรันไทม์หรือสถานะopenclaw tasks list --runtime acpopenclaw tasks list --status running

# แสดงรายละเอียดของงานที่ระบุ (ตาม ID งาน, ID การทำงาน หรือคีย์เซสชัน)openclaw tasks show <lookup>

# ยกเลิกงานที่กำลังทำงาน (ยุติเซสชันลูก)openclaw tasks cancel <lookup> # เปลี่ยนนโยบายการแจ้งเตือนสำหรับงานopenclaw tasks notify <lookup> state_changes

# ดำเนินการตรวจสอบสถานภาพopenclaw tasks audit # แสดงตัวอย่างหรือนำการบำรุงรักษาไปใช้openclaw tasks maintenanceopenclaw tasks maintenance --apply

# ตรวจสอบสถานะ TaskFlowopenclaw tasks flow listopenclaw tasks flow show <lookup>openclaw tasks flow cancel <lookup>

สิ่งที่สร้างงาน

วงจรชีวิตของงาน

stateDiagram-v2
    [*] --> queued
    queued --> running : เอเจนต์เริ่มทำงาน
    running --> succeeded : เสร็จสมบูรณ์
    running --> failed : ข้อผิดพลาด
    running --> timed_out : เกินเวลาที่กำหนด
    queued --> cancelled : ผู้ปฏิบัติงานยกเลิก
    running --> cancelled : ผู้ปฏิบัติงานยกเลิก
    queued --> lost : สถานะรองรับหายไป > 5 นาที
    running --> lost : สถานะรองรับหายไป > 5 นาที

การเปลี่ยนสถานะเกิดขึ้นโดยอัตโนมัติ เหตุการณ์ในวงจรชีวิตการทำงานของเอเจนต์ (เริ่มต้น สิ้นสุด ข้อผิดพลาด) จะอัปเดตสถานะงาน โดยไม่ต้องจัดการด้วยตนเอง

การเสร็จสิ้นของการทำงานเอเจนต์เป็นข้อมูลชี้ขาดสำหรับระเบียนงานที่กำลังทำงาน การทำงานแบบแยกที่สำเร็จจะสิ้นสุดเป็น succeeded ข้อผิดพลาดทั่วไปของการทำงานจะสิ้นสุดเป็น failed การหมดเวลาจะสิ้นสุดเป็น timed_out และผลลัพธ์จากการยกเลิก/ยุติจะสิ้นสุดเป็น cancelled เมื่องานอยู่ในสถานะสิ้นสุดแล้ว สัญญาณวงจรชีวิตที่มาภายหลังจะไม่ลดระดับสถานะ งานที่ผู้ปฏิบัติงานยกเลิกหรือเป็น failed/timed_out/lost อยู่แล้วจะคงสถานะเดิม แม้ว่าจะมีสัญญาณความสำเร็จมาถึงในภายหลังก็ตาม

lost คำนึงถึงรันไทม์:

• งาน ACP: เฉพาะรอบ ACP ภายในโพรเซสที่ทำงานอยู่ใน Gateway เท่านั้นที่พิสูจน์ได้ว่าการทำงานยังดำเนินอยู่ เมทาดาทาของเซสชันที่บันทึกถาวรเพียงอย่างเดียวไม่เพียงพอ การตรวจสอบ CLI แบบออฟไลน์จะดำเนินการอย่างระมัดระวังและไม่เรียกคืนงาน ACP
• งานเอเจนต์ย่อย: เซสชันลูกที่รองรับหายไปจากที่เก็บของเอเจนต์เป้าหมาย (หรือมีทูมสโตนสำหรับการกู้คืนหลังรีสตาร์ต)
• งาน cron: รันไทม์ cron ไม่ได้ติดตามงานนั้นว่ากำลังทำงานอีกต่อไป และประวัติการทำงาน cron แบบถาวรไม่แสดงผลลัพธ์สถานะสิ้นสุดสำหรับการทำงานนั้น การตรวจสอบ CLI แบบออฟไลน์จะไม่ถือว่าสถานะรันไทม์ cron ภายในโพรเซสของตนที่ว่างเปล่าเป็นข้อมูลชี้ขาด
• งาน CLI: งานที่มี ID การทำงาน/ID แหล่งที่มาจะใช้บริบทการทำงานที่ใช้งานอยู่ ดังนั้นแถวเซสชันลูกหรือเซสชันแชตที่ค้างอยู่จะไม่ทำให้งานยังมีสถานะทำงานต่อไปหลังจากการทำงานที่ Gateway เป็นเจ้าของหายไป งาน CLI แบบเดิมที่ไม่มีข้อมูลระบุตัวตนของการทำงานจะยังคงย้อนกลับไปใช้เซสชันลูก การทำงาน openclaw agent ที่มี Gateway รองรับจะสิ้นสุดตามผลลัพธ์การทำงานด้วย ดังนั้นการทำงานที่เสร็จแล้วจะไม่ค้างอยู่ในสถานะทำงานจนกว่าตัวกวาดจะทำเครื่องหมายเป็น lost

การส่งมอบและการแจ้งเตือน

เมื่องานเข้าสู่สถานะสิ้นสุด OpenClaw จะแจ้งเตือน มีเส้นทางการส่งมอบสองแบบ:

การส่งมอบโดยตรง - หากงานมีเป้าหมายช่อง (requesterOrigin) ข้อความแจ้งการเสร็จสิ้นจะส่งตรงไปยังช่องนั้น (Discord, Slack, Telegram เป็นต้น) ส่วนการเสร็จสิ้นของงานในกลุ่มและช่องจะถูกกำหนดเส้นทางผ่านเซสชันผู้ร้องขอ เพื่อให้เอเจนต์พาเรนต์เขียนการตอบกลับที่มองเห็นได้ สำหรับการเสร็จสิ้นของเอเจนต์ย่อย OpenClaw จะรักษาการกำหนดเส้นทางเธรด/หัวข้อที่ผูกไว้เมื่อมีข้อมูล และสามารถเติม to / บัญชีที่ขาดหายไปจากเส้นทางที่จัดเก็บไว้ของเซสชันผู้ร้องขอ (lastChannel / lastTo / lastAccountId) ก่อนยุติความพยายามส่งโดยตรง

การส่งมอบแบบเข้าคิวในเซสชัน - หากการส่งมอบโดยตรงล้มเหลวหรือไม่ได้กำหนดต้นทาง การอัปเดตจะถูกเข้าคิวเป็นเหตุการณ์ระบบในเซสชันของผู้ร้องขอ และแสดงขึ้นใน Heartbeat ครั้งถัดไป

ซึ่งหมายความว่าเวิร์กโฟลว์ปกติจะอิงการส่งข้อมูล: เริ่มงานแบบแยกเพียงครั้งเดียว แล้วปล่อยให้รันไทม์ปลุกหรือแจ้งเตือนเมื่อเสร็จสิ้น สำรวจสถานะงานเฉพาะเมื่อต้องแก้ไขข้อบกพร่อง แทรกแซง หรือตรวจสอบอย่างชัดเจน

นโยบายการแจ้งเตือน

ควบคุมปริมาณข้อมูลที่จะได้รับเกี่ยวกับแต่ละงาน:

เปลี่ยนนโยบายขณะที่งานกำลังทำงาน:

openclaw tasks notify <lookup> state_changes

เอกสารอ้างอิง CLI

openclaw tasks list [--runtime <acp|subagent|cron|cli>] [--status <status>] [--json]

openclaw tasks show <lookup> [--json]

openclaw tasks cancel <lookup>

openclaw tasks notify <lookup> <done_only|state_changes|silent>

openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]

openclaw tasks maintenance [--json]openclaw tasks maintenance --apply [--json]

openclaw tasks flow list [--status <status>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>

กระดานงานในแชต (/tasks)

ใช้ /tasks ในเซสชันแชตใดก็ได้เพื่อดูงานเบื้องหลังที่เชื่อมโยงกับเซสชันนั้น กระดานจะแสดงงานที่กำลังทำงานและงานที่เพิ่งเสร็จสิ้นสูงสุดห้างาน พร้อมรันไทม์ สถานะ เวลา และรายละเอียดความคืบหน้าหรือข้อผิดพลาด

เมื่อเซสชันปัจจุบันไม่มีงานที่เชื่อมโยงและมองเห็นได้ /tasks จะเปลี่ยนไปใช้จำนวนงานภายในเอเจนต์ เพื่อให้ยังคงเห็นภาพรวมโดยไม่เปิดเผยรายละเอียดของเซสชันอื่น

สำหรับบัญชีรายการฉบับเต็มของผู้ดำเนินการ ให้ใช้ CLI: openclaw tasks list

Control UI

Control UI บนเว็บมีหน้า งาน ในแถบด้านข้าง ซึ่งแสดงงานเบื้องหลังที่กำลังทำงานและงานล่าสุดแบบสด ใช้หน้านี้เพื่อตรวจสอบความคืบหน้า เปิดเซสชันที่เชื่อมโยง รีเฟรชบัญชีรายการ หรือยกเลิกงานที่อยู่ในคิวและกำลังทำงาน

บานหน้าต่างแชตยังมีแถบ งานเบื้องหลัง ที่ยุบได้และจำกัดขอบเขตตามเอเจนต์ของบานหน้าต่าง โดยประกอบด้วยงานและ subagent ที่กำลังทำงานพร้อมตัวควบคุมหยุด ส่วนงานที่เสร็จแล้ว และลิงก์ดูทรานสคริปต์ไปยังเซสชันลูกของแต่ละงาน เปิดแถบนี้จากปุ่มสลับกิจกรรมในส่วนหัวของบานหน้าต่าง (หรือปุ่มกิจกรรมแบบลอยในแชตแบบบานหน้าต่างเดียว)

เลือกงานในแถบเพื่อตรวจสอบพรอมต์อินพุตที่มีขอบเขตจำกัด รวมถึงเอาต์พุตล่าสุดหรือสรุปข้อผิดพลาด งานที่กำลังทำงานจะแยกจากงานที่เสร็จแล้ว และแถวที่เสร็จแล้วจะแสดงว่างานสำเร็จหรือล้มเหลว บน iOS ให้เปิด Chat actions → Background Tasks บน Android ให้เปิดเมนูรายการเพิ่มเติมของ Chat แล้วเลือก Background tasks มุมมองบนอุปกรณ์เคลื่อนที่ทั้งสองใช้การจัดกลุ่ม Running และ Finished แบบเดียวกัน และเปิดรายละเอียดงานเมื่อเลือก

การผสานรวมสถานะ (ภาระงาน)

openclaw status มีบรรทัดสรุปงานที่ดูได้อย่างรวดเร็ว:

งาน    ทำงานอยู่ 2 · อยู่ในคิว 1 · กำลังทำงาน 1 · มีปัญหา 1 · การตรวจสอบสะอาด · ติดตามอยู่ 6

สรุปนี้นับงานที่กำลังทำงาน (queued + running) ความล้มเหลว (failed + timed_out + lost) ผลการตรวจสอบ และระเบียนที่ติดตามทั้งหมด ส่วนเพย์โหลด JSON ยังแจกแจงจำนวนตามรันไทม์ (acp, subagent, cron, cli)

ทั้ง /status และเครื่องมือ session_status ใช้สแนปช็อตงานที่รับรู้การล้างข้อมูล โดยให้ความสำคัญกับงานที่กำลังทำงาน ซ่อนแถวที่หมดอายุ และแสดงงานที่สิ้นสุดแล้วเฉพาะในช่วงเวลาสั้น ๆ หลังจากนั้น (5 นาที) พร้อมเน้นความล้มเหลวเมื่อไม่มีงานที่กำลังทำงานเหลืออยู่ วิธีนี้ทำให้การ์ดสถานะมุ่งเน้นสิ่งที่สำคัญในขณะนี้

การจัดเก็บและการบำรุงรักษา

ตำแหน่งที่จัดเก็บงาน

ระเบียนงานและสถานะการนำส่งจะถูกจัดเก็บถาวรในฐานข้อมูลสถานะ SQLite ที่ใช้ร่วมกันของ OpenClaw:

~/.openclaw/state/openclaw.sqlite   (ตาราง: task_runs, task_delivery_state, flow_runs)

ตั้งค่า OPENCLAW_STATE_DIR เพื่อย้ายรากสถานะทั้งหมด (ค่าเริ่มต้น ~/.openclaw) ไปยังตำแหน่งอื่น เส้นทางฐานข้อมูลที่ใช้ร่วมกันจะย้ายตามไปด้วย

รีจิสทรีจะโหลดเข้าสู่หน่วยความจำเมื่อใช้งานครั้งแรก และบันทึกการเขียนทุกครั้งกลับไปยัง SQLite ทำให้ระเบียนยังคงอยู่หลัง Gateway รีสตาร์ต การเติบโตของ WAL ถูกจำกัดด้วยเกณฑ์ autocheckpoint เริ่มต้นของ SQLite ร่วมกับ checkpoint PASSIVE ตามรอบเวลา ส่วน checkpoint เมื่อปิดระบบและเมื่อบำรุงรักษาโดยตรงจะใช้ TRUNCATE เพื่อให้การปิดตามปกติเรียกคืนพื้นที่ WAL ได้โดยไม่ทำให้ตัวกวาดเบื้องหลังต้องรอรีดเดอร์ที่กำลังทำงาน

สโตร์ sidecar แบบเดิมจากการติดตั้งรุ่นเก่า (tasks/runs.sqlite, flows/registry.sqlite) จะถูกนำเข้าสู่ฐานข้อมูลที่ใช้ร่วมกันโดย openclaw doctor

การบำรุงรักษาอัตโนมัติ

ตัวกวาดจะทำงานทุก 60 วินาที (รอบแรกประมาณ 5 วินาทีหลัง Gateway เริ่มทำงาน) และจัดการสี่อย่าง:

ความสัมพันธ์ระหว่างงานกับระบบอื่น

ที่เกี่ยวข้อง

• ระบบอัตโนมัติ - กลไกระบบอัตโนมัติทั้งหมดในภาพรวม
• CLI: งาน - เอกสารอ้างอิงคำสั่ง CLI
• Heartbeat - รอบการทำงานเป็นระยะของเซสชันหลัก
• งานตามกำหนดเวลา - การกำหนดเวลางานเบื้องหลัง
• TaskFlow - การประสานโฟลว์เหนือระดับงาน