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.

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

เมื่อใดควรใช้ Task Flow

ใช้ Task Flow เมื่องานครอบคลุมหลายขั้นตอนแบบต่อเนื่องหรือแตกแขนง และคุณต้องการติดตามความคืบหน้าที่คงทนข้ามการรีสตาร์ต Gateway สำหรับการดำเนินการเบื้องหลังแบบเดี่ยว task ปกติก็เพียงพอแล้ว
สถานการณ์ใช้
งานเบื้องหลังเดี่ยวงานปกติ
ไปป์ไลน์หลายขั้นตอน (A แล้ว B แล้ว C)Task Flow (จัดการแล้ว)
สังเกตงานที่สร้างจากภายนอกTask Flow (สะท้อนสถานะ)
การเตือนครั้งเดียวงาน Cron

รูปแบบเวิร์กโฟลว์ตามกำหนดเวลาที่เชื่อถือได้

สำหรับเวิร์กโฟลว์ที่เกิดซ้ำ เช่น บรีฟข่าวกรองตลาด ให้ถือว่ากำหนดเวลา การจัดลำดับงาน และการตรวจสอบความน่าเชื่อถือเป็นเลเยอร์ที่แยกจากกัน:
  1. ใช้ งานตามกำหนดเวลา สำหรับการกำหนดเวลา
  2. ใช้เซสชัน cron แบบคงอยู่เมื่อเวิร์กโฟลว์ควรต่อยอดจากบริบทก่อนหน้า
  3. ใช้ Lobster สำหรับขั้นตอนที่กำหนดแน่นอน เกตการอนุมัติ และโทเค็นสำหรับดำเนินการต่อ
  4. ใช้ Task Flow เพื่อติดตามการรันหลายขั้นตอนข้ามงานลูก การรอ การลองใหม่ และการรีสตาร์ต Gateway
ตัวอย่างรูปแบบ cron:
openclaw cron add \
  --name "Market intelligence brief" \
  --cron "0 7 * * 1-5" \
  --tz "America/New_York" \
  --session session:market-intel \
  --message "Run the market-intel Lobster workflow. Verify source freshness before summarizing." \
  --announce \
  --channel slack \
  --to "channel:C1234567890"
ใช้ session:<id> แทน isolated เมื่อเวิร์กโฟลว์ที่เกิดซ้ำต้องการประวัติอย่างตั้งใจ สรุปจากการรันก่อนหน้า หรือบริบทถาวร ใช้ isolated เมื่อแต่ละรอบควรเริ่มใหม่ และสถานะที่จำเป็นทั้งหมดระบุไว้อย่างชัดเจนในเวิร์กโฟลว์ ภายในเวิร์กโฟลว์ ให้วางการตรวจสอบความน่าเชื่อถือไว้ก่อนขั้นตอนสรุปของ LLM:
name: market-intel-brief
steps:
  - id: preflight
    command: market-intel check --json
  - id: collect
    command: market-intel collect --json
    stdin: $preflight.json
  - id: summarize
    command: market-intel summarize --json
    stdin: $collect.json
  - id: approve
    command: market-intel deliver --preview
    stdin: $summarize.json
    approval: required
  - id: deliver
    command: market-intel deliver --execute
    stdin: $summarize.json
    condition: $approve.approved
การตรวจสอบก่อนรันที่แนะนำ:
  • ความพร้อมใช้งานของเบราว์เซอร์และการเลือกโปรไฟล์ เช่น openclaw สำหรับสถานะที่จัดการแล้ว หรือ user เมื่อต้องใช้เซสชัน Chrome ที่ลงชื่อเข้าใช้อยู่ ดู เบราว์เซอร์
  • ข้อมูลรับรอง API และโควตาสำหรับแต่ละแหล่งข้อมูล
  • การเข้าถึงเครือข่ายสำหรับปลายทางที่จำเป็น
  • เครื่องมือที่จำเป็นเปิดใช้งานสำหรับเอเจนต์ เช่น lobster, browser และ llm-task
  • ปลายทางเมื่อเกิดความล้มเหลวได้รับการกำหนดค่าสำหรับ cron เพื่อให้เห็นความล้มเหลวก่อนรัน ดู งานตามกำหนดเวลา
ฟิลด์แหล่งที่มาของข้อมูลที่แนะนำสำหรับทุกรายการที่รวบรวม:
{
  "sourceUrl": "https://example.com/report",
  "retrievedAt": "2026-04-24T12:00:00Z",
  "asOf": "2026-04-24",
  "title": "Example report",
  "content": "..."
}
ให้เวิร์กโฟลว์ปฏิเสธหรือทำเครื่องหมายรายการที่ล้าสมัยก่อนการสรุป ขั้นตอน LLM ควรได้รับเฉพาะ JSON ที่มีโครงสร้าง และควรถูกขอให้คง sourceUrl, retrievedAt และ asOf ไว้ในผลลัพธ์ ใช้ งาน LLM เมื่อคุณต้องการขั้นตอนโมเดลที่ตรวจสอบกับสคีมาได้ภายในเวิร์กโฟลว์ สำหรับเวิร์กโฟลว์ที่ใช้ซ้ำได้โดยทีมหรือชุมชน ให้แพ็กเกจ CLI, ไฟล์ .lobster และบันทึกการตั้งค่าใด ๆ เป็น skill หรือ plugin แล้วเผยแพร่ผ่าน ClawHub เก็บ guardrail เฉพาะเวิร์กโฟลว์ไว้ในแพ็กเกจนั้น เว้นแต่ API ของ plugin จะขาดความสามารถทั่วไปที่จำเป็น

โหมดการซิงค์

โหมดจัดการแล้ว

Task Flow เป็นเจ้าของวงจรชีวิตตั้งแต่ต้นจนจบ โดยสร้างงานเป็นขั้นตอนของโฟลว์ ขับเคลื่อนให้เสร็จสมบูรณ์ และเลื่อนสถานะของโฟลว์โดยอัตโนมัติ ตัวอย่าง: โฟลว์รายงานรายสัปดาห์ที่ (1) รวบรวมข้อมูล (2) สร้างรายงาน และ (3) ส่งมอบรายงาน Task Flow สร้างแต่ละขั้นตอนเป็นงานเบื้องหลัง รอให้เสร็จสมบูรณ์ แล้วจึงย้ายไปขั้นตอนถัดไป
Flow: weekly-report
  Step 1: gather-data     → task created → succeeded
  Step 2: generate-report → task created → succeeded
  Step 3: deliver         → task created → running

โหมดสะท้อนสถานะ

Task Flow สังเกตงานที่สร้างจากภายนอกและทำให้สถานะของโฟลว์ซิงค์กัน โดยไม่เป็นเจ้าของการสร้างงาน วิธีนี้มีประโยชน์เมื่องานมาจากงาน cron, คำสั่ง CLI หรือแหล่งอื่น ๆ และคุณต้องการมุมมองรวมของความคืบหน้าในรูปแบบโฟลว์ ตัวอย่าง: งาน cron อิสระสามรายการที่รวมกันเป็นรูทีน “ปฏิบัติการช่วงเช้า” โฟลว์แบบสะท้อนสถานะติดตามความคืบหน้าโดยรวมโดยไม่ควบคุมว่าจะรันเมื่อใดหรืออย่างไร

สถานะที่คงทนและการติดตามรีวิชัน

แต่ละโฟลว์คงสถานะของตัวเองและติดตามรีวิชัน เพื่อให้ความคืบหน้ายังคงอยู่ข้ามการรีสตาร์ต Gateway การติดตามรีวิชันช่วยตรวจจับข้อขัดแย้งเมื่อหลายแหล่งพยายามเลื่อนโฟลว์เดียวกันพร้อมกัน รีจิสทรีของโฟลว์ใช้ SQLite พร้อมการบำรุงรักษา write-ahead log แบบมีขอบเขต รวมถึง checkpoint เป็นระยะและเมื่อปิดระบบ เพื่อให้ Gateway ที่รันยาวนานไม่เก็บ ไฟล์ sidecar registry.sqlite-wal แบบไร้ขอบเขต

พฤติกรรมการยกเลิก

openclaw tasks flow cancel ตั้งเจตนาการยกเลิกแบบค้างอยู่บนโฟลว์ งานที่ใช้งานอยู่ภายในโฟลว์จะถูกยกเลิก และจะไม่เริ่มขั้นตอนใหม่ เจตนาการยกเลิกจะคงอยู่ข้ามการรีสตาร์ต ดังนั้นโฟลว์ที่ถูกยกเลิกจะยังคงถูกยกเลิกแม้ว่า Gateway จะรีสตาร์ตก่อนที่งานลูกทั้งหมดจะสิ้นสุด

คำสั่ง CLI

# List active and recent flows
openclaw tasks flow list

# Show details for a specific flow
openclaw tasks flow show <lookup>

# Cancel a running flow and its active tasks
openclaw tasks flow cancel <lookup>
คำสั่งคำอธิบาย
openclaw tasks flow listแสดงโฟลว์ที่ติดตามพร้อมสถานะและโหมดซิงค์
openclaw tasks flow show <id>ตรวจสอบโฟลว์หนึ่งรายการด้วย id ของโฟลว์หรือคีย์ค้นหา
openclaw tasks flow cancel <id>ยกเลิกโฟลว์ที่กำลังรันและงานที่ใช้งานอยู่ของโฟลว์นั้น

โฟลว์สัมพันธ์กับงานอย่างไร

โฟลว์ประสานงาน ไม่ได้แทนที่งาน โฟลว์เดียวอาจขับเคลื่อนงานเบื้องหลังหลายรายการตลอดอายุของมัน ใช้ openclaw tasks เพื่อตรวจสอบระเบียนงานแต่ละรายการ และใช้ openclaw tasks flow เพื่อตรวจสอบโฟลว์ที่ทำหน้าที่จัดลำดับงาน

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

  • งานเบื้องหลัง — บัญชีแยกประเภทของงานที่แยกไปรันเอง ซึ่งโฟลว์ใช้ประสานงาน
  • CLI: tasks — เอกสารอ้างอิงคำสั่ง CLI สำหรับ openclaw tasks flow
  • ภาพรวมระบบอัตโนมัติ — กลไกระบบอัตโนมัติทั้งหมดโดยสรุป
  • งาน Cron — งานตามกำหนดเวลาที่อาจป้อนเข้าสู่โฟลว์