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

งานเบื้องหลังติดตามงานที่ทำงาน นอกเซสชันสนทนาหลักของคุณ: การรัน ACP, การสร้าง subagent, การรันงาน Cron แบบแยก, และการดำเนินการที่เริ่มจาก CLI

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

# สรุปสั้น

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

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

# List all tasks (newest first)
openclaw tasks list

# Filter by runtime or status
openclaw tasks list --runtime acp
openclaw tasks list --status running

# Show details for a specific task (by ID, run ID, or session key)
openclaw tasks show <lookup>

# Cancel a running task (kills the child session)
openclaw tasks cancel <lookup>

# Change notification policy for a task
openclaw tasks notify <lookup> state_changes

# Run a health audit
openclaw tasks audit

# Preview or apply maintenance
openclaw tasks maintenance
openclaw tasks maintenance --apply

# Inspect TaskFlow state
openclaw tasks flow list
openclaw tasks flow show <lookup>
openclaw tasks flow cancel <lookup>

# อะไรสร้างงาน

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

stateDiagram-v2
    [*] --> queued
    queued --> running : agent starts
    running --> succeeded : completes ok
    running --> failed : error
    running --> timed_out : timeout exceeded
    running --> cancelled : operator cancels
    queued --> lost : session gone > 5 min
    running --> lost : session gone > 5 min

การเปลี่ยนสถานะเกิดขึ้นโดยอัตโนมัติ - เมื่อการรัน agent ที่เกี่ยวข้องสิ้นสุด สถานะงานจะอัปเดตให้ตรงกัน

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

lost รับรู้ตาม runtime:

• งาน ACP: metadata ของเซสชัน ACP ลูกที่สนับสนุนหายไป
• งาน subagent: เซสชันลูกที่สนับสนุนหายไปจาก store ของ agent เป้าหมาย
• งาน Cron: runtime ของ Cron ไม่ติดตามงานว่าใช้งานอยู่อีกต่อไป และประวัติการรัน Cron ที่คงทนไม่แสดงผลลัพธ์ปลายทางสำหรับการรันนั้น การตรวจสอบสุขภาพผ่าน CLI แบบออฟไลน์จะไม่ถือว่าสถานะ runtime ของ Cron ในโปรเซสตัวเองที่ว่างเปล่าเป็นแหล่งอ้างอิง
• งาน CLI: งานเซสชันลูกแบบแยกใช้เซสชันลูก; งาน CLI ที่มีแชตรองรับใช้บริบทการรันสดแทน ดังนั้นแถวเซสชันช่องทาง/กลุ่ม/โดยตรงที่ค้างอยู่จะไม่ทำให้ยังมีชีวิตอยู่ การรัน openclaw agent ที่มี Gateway รองรับยังสิ้นสุดจากผลการรันด้วย ดังนั้นการรันที่เสร็จแล้วจะไม่ค้างเป็น active จนกว่า sweeper จะทำเครื่องหมายเป็น lost

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

เมื่องานถึงสถานะปลายทาง OpenClaw จะแจ้งคุณ มีเส้นทางการส่งมอบสองแบบ:

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

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

นั่นหมายความว่า workflow ปกติเป็นแบบ push-based: เริ่มงานแบบแยกหนึ่งครั้ง แล้วปล่อยให้ runtime ปลุกหรือแจ้งคุณเมื่อเสร็จสิ้น Poll สถานะงานเฉพาะเมื่อคุณต้องการดีบัก แทรกแซง หรือตรวจสอบสุขภาพอย่างชัดเจน

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

ควบคุมว่าคุณจะได้ยินเกี่ยวกับแต่ละงานมากแค่ไหน:

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

openclaw tasks notify <lookup> state_changes

# อ้างอิง CLI

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

openclaw tasks show <lookup>

openclaw tasks cancel <lookup>

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

openclaw tasks audit [--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

# การผสานรวมสถานะ (แรงกดดันจากงาน)

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

Tasks: 3 queued · 2 running · 1 issues

สรุปรายงาน:

• active - จำนวน queued + running
• failures - จำนวน failed + timed_out + lost
• byRuntime - การแจกแจงตาม acp, subagent, cron, cli

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

# พื้นที่จัดเก็บและการบำรุงรักษา

# งานอยู่ที่ไหน

ระเบียนงานคงอยู่ใน SQLite ที่:

$OPENCLAW_STATE_DIR/tasks/runs.sqlite

รีจิสทรีโหลดเข้าสู่หน่วยความจำเมื่อ Gateway เริ่มทำงาน และซิงค์การเขียนไปยัง SQLite เพื่อความคงทนข้ามการรีสตาร์ต Gateway จำกัดขนาด write-ahead log ของ SQLite โดยใช้เกณฑ์ autocheckpoint เริ่มต้นของ SQLite ร่วมกับ checkpoint แบบ TRUNCATE เป็นระยะและตอนปิดระบบ

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

sweeper ทำงานทุก 60 วินาที และจัดการสี่เรื่อง:

# งานสัมพันธ์กับระบบอื่นอย่างไร

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

• Automation & Tasks - กลไกอัตโนมัติทั้งหมดโดยสรุป
• CLI: Tasks - ข้อมูลอ้างอิงคำสั่ง CLI
• Heartbeat - turn ของ main-session เป็นระยะ
• Scheduled Tasks - การกำหนดเวลางานเบื้องหลัง
• Task Flow - การประสาน flow เหนืองาน