Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw รันงานเบื้องหลังผ่านงาน, งานตามกำหนดเวลา, commitment ที่อนุมานได้, event hook และคำสั่งถาวร หน้านี้ช่วยให้คุณเลือกกลไกที่เหมาะสมและเข้าใจว่ากลไกเหล่านี้ทำงานร่วมกันอย่างไร

คู่มือตัดสินใจแบบรวดเร็ว

กรณีใช้งานแนะนำเหตุผล
ส่งรายงานรายวันตรงเวลา 9 โมงเช้างานตามกำหนดเวลา (Cron)เวลาที่แน่นอน, การดำเนินการแบบแยกส่วน
เตือนฉันในอีก 20 นาทีงานตามกำหนดเวลา (Cron)แบบครั้งเดียวด้วยเวลาที่แม่นยำ (--at)
รันการวิเคราะห์เชิงลึกรายสัปดาห์งานตามกำหนดเวลา (Cron)งานแบบสแตนด์อโลน, ใช้โมเดลอื่นได้
ตรวจกล่องจดหมายทุก 30 นาทีHeartbeatรวมเป็นชุดกับการตรวจอื่น ๆ, รับรู้บริบท
ตรวจปฏิทินสำหรับเหตุการณ์ที่กำลังจะมาถึงHeartbeatเหมาะโดยธรรมชาติกับการรับรู้เป็นระยะ
เช็กหลังการสัมภาษณ์ที่มีการกล่าวถึงcommitment ที่อนุมานได้การติดตามผลแบบคล้ายหน่วยความจำ, ไม่ใช่คำขอเตือนเวลาที่แน่นอน
เช็กอินอย่างนุ่มนวลหลังบริบทของผู้ใช้commitment ที่อนุมานได้จำกัดขอบเขตอยู่ที่ agent และช่องทางเดิม
ตรวจสอบสถานะของ subagent หรือการรัน ACPงานเบื้องหลังบัญชีแยกประเภทของงานติดตามงานแยกทั้งหมด
ตรวจสอบว่ามีอะไรรันและเมื่อใดงานเบื้องหลังopenclaw tasks list และ openclaw tasks audit
วิจัยหลายขั้นตอนแล้วสรุปTask Flowการจัดลำดับงานที่คงทนพร้อมการติดตาม revision
รันสคริปต์เมื่อรีเซ็ต sessionHookขับเคลื่อนด้วย event, เรียกทำงานเมื่อมี lifecycle event
ดำเนินการโค้ดทุกครั้งที่เรียก toolPlugin hookhook ในกระบวนการสามารถดัก tool call ได้
ตรวจ compliance ทุกครั้งก่อนตอบกลับคำสั่งถาวรถูกฉีดเข้าไปในทุก session โดยอัตโนมัติ

งานตามกำหนดเวลา (Cron) เทียบกับ Heartbeat

มิติงานตามกำหนดเวลา (Cron)Heartbeat
เวลาแน่นอน (cron expression, ครั้งเดียว)โดยประมาณ (ค่าเริ่มต้นทุก 30 นาที)
บริบท sessionใหม่ (แยกส่วน) หรือใช้ร่วมกันบริบท session หลักแบบเต็ม
ระเบียนงานสร้างเสมอไม่สร้าง
การส่งมอบช่องทาง, webhook หรือเงียบแบบ inline ใน session หลัก
เหมาะสำหรับรายงาน, การเตือน, งานเบื้องหลังการตรวจกล่องจดหมาย, ปฏิทิน, การแจ้งเตือน
ใช้ งานตามกำหนดเวลา (Cron) เมื่อคุณต้องการเวลาที่แม่นยำหรือการดำเนินการแบบแยกส่วน ใช้ Heartbeat เมื่องานได้ประโยชน์จากบริบท session แบบเต็มและเวลาที่ประมาณได้ก็เพียงพอ

แนวคิดหลัก

งานตามกำหนดเวลา (cron)

Cron คือ scheduler ในตัวของ Gateway สำหรับเวลาที่แม่นยำ โดยจะคงงานไว้, ปลุก agent ในเวลาที่เหมาะสม และส่งผลลัพธ์ไปยังช่องทางแชตหรือ endpoint ของ webhook ได้ รองรับการเตือนแบบครั้งเดียว, expression แบบเกิดซ้ำ และ trigger ของ webhook ขาเข้า ดู งานตามกำหนดเวลา

งาน

บัญชีแยกประเภทของงานเบื้องหลังติดตามงานแยกทั้งหมด: การรัน ACP, การ spawn subagent, การดำเนินการ cron แบบแยกส่วน และการทำงานของ CLI งานเป็นระเบียน ไม่ใช่ scheduler ใช้ openclaw tasks list และ openclaw tasks audit เพื่อตรวจสอบ ดู งานเบื้องหลัง

commitment ที่อนุมานได้

commitment เป็นหน่วยความจำติดตามผลแบบ opt-in และมีอายุสั้น OpenClaw อนุมานจากบทสนทนาปกติ จำกัดขอบเขตไว้ที่ agent และช่องทางเดิม และส่งเช็กอินที่ถึงกำหนดผ่าน heartbeat การเตือนเวลาที่แน่นอนซึ่งผู้ใช้ร้องขอยังคงเป็นหน้าที่ของ cron ดู commitment ที่อนุมานได้

Task Flow

Task Flow คือฐานรองรับการจัดลำดับ flow ที่อยู่เหนือกว่างานเบื้องหลัง จัดการ flow หลายขั้นตอนที่คงทนด้วยโหมด sync แบบ managed และ mirrored, การติดตาม revision และ openclaw tasks flow list|show|cancel สำหรับการตรวจสอบ ดู Task Flow

คำสั่งถาวร

คำสั่งถาวรมอบอำนาจการปฏิบัติงานแบบถาวรให้ agent สำหรับโปรแกรมที่กำหนดไว้ คำสั่งเหล่านี้อยู่ในไฟล์ workspace (โดยทั่วไปคือ AGENTS.md) และถูกฉีดเข้าไปในทุก session ใช้ร่วมกับ cron สำหรับการบังคับใช้ตามเวลา ดู คำสั่งถาวร

Hook

hook ภายในคือสคริปต์ที่ขับเคลื่อนด้วย event ซึ่งถูก trigger โดย lifecycle event ของ agent (/new, /reset, /stop), session compaction, การเริ่มต้น gateway และ message flow ระบบจะค้นพบโดยอัตโนมัติจากไดเรกทอรีและจัดการได้ด้วย openclaw hooks สำหรับการดัก tool-call ในกระบวนการ ให้ใช้ Plugin hook ดู Hook

Heartbeat

Heartbeat คือ turn ของ session หลักที่เกิดขึ้นเป็นระยะ (ค่าเริ่มต้นทุก 30 นาที) โดยรวมการตรวจหลายอย่าง (กล่องจดหมาย, ปฏิทิน, การแจ้งเตือน) ไว้ใน turn เดียวของ agent พร้อมบริบท session แบบเต็ม turn ของ Heartbeat จะไม่สร้างระเบียนงานและไม่ต่ออายุความสดของการรีเซ็ต session รายวัน/ว่าง ใช้ HEARTBEAT.md สำหรับเช็กลิสต์สั้น ๆ หรือบล็อก tasks: เมื่อคุณต้องการการตรวจเป็นระยะเฉพาะรายการที่ถึงกำหนดภายใน heartbeat เอง ไฟล์ heartbeat ว่างจะข้ามเป็น empty-heartbeat-file; โหมดงานเฉพาะที่ถึงกำหนดจะข้ามเป็น no-tasks-due Heartbeat จะเลื่อนออกไปขณะงาน cron กำลังทำงานหรืออยู่ในคิว และ heartbeat.skipWhenBusy ยังสามารถเลื่อน agent ออกไปเมื่อ subagent ที่อิง session-key หรือ lane ซ้อนของ agent เดียวกันกำลังยุ่งอยู่ได้ ดู Heartbeat

วิธีที่สิ่งเหล่านี้ทำงานร่วมกัน

  • Cron จัดการกำหนดเวลาที่แม่นยำ (รายงานรายวัน, รีวิวรายสัปดาห์) และการเตือนแบบครั้งเดียว การดำเนินการ cron ทั้งหมดสร้างระเบียนงาน
  • Heartbeat จัดการการเฝ้าตรวจตามปกติ (กล่องจดหมาย, ปฏิทิน, การแจ้งเตือน) ใน turn แบบรวมชุดหนึ่งครั้งทุก 30 นาที
  • Hook ตอบสนองต่อ event เฉพาะ (การรีเซ็ต session, compaction, message flow) ด้วยสคริปต์ที่กำหนดเอง Plugin hook ครอบคลุม tool call
  • คำสั่งถาวร ให้บริบทถาวรและขอบเขตอำนาจแก่ agent
  • Task Flow ประสาน flow หลายขั้นตอนที่อยู่เหนือกว่างานแต่ละรายการ
  • งาน ติดตามงานแยกทั้งหมดโดยอัตโนมัติเพื่อให้คุณตรวจสอบและ audit ได้

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