งานที่กำหนดเวลาไว้

Cron คือตัวกำหนดเวลาในตัวของ Gateway โดยจะจัดเก็บงานแบบถาวร ปลุกเอเจนต์ในเวลาที่เหมาะสม และสามารถส่งผลลัพธ์ไปยังช่องแชต Webhook หรือไม่ส่งไปที่ใดเลย

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

openclaw cron create "2027-02-01T16:00:00Z" \  --name "การเตือน" \  --session main \  --system-event "การเตือน: ตรวจสอบฉบับร่างเอกสาร cron" \  --wake now \  --delete-after-run

openclaw cron listopenclaw cron get <job-id>openclaw cron show <job-id>

openclaw cron runs --id <job-id>

วิธีการทำงานของ cron

• Cron ทำงาน ภายในกระบวนการ Gateway ไม่ใช่ภายในโมเดล Gateway ต้องทำงานอยู่เพื่อให้กำหนดการเริ่มทำงานได้
• ข้อกำหนดงาน สถานะรันไทม์ และประวัติการรันจะถูกจัดเก็บอย่างถาวรในฐานข้อมูลสถานะ SQLite ที่ใช้ร่วมกันของ OpenClaw ดังนั้นการเริ่มระบบใหม่จะไม่ทำให้กำหนดการสูญหาย
• การเรียกใช้ cron แต่ละครั้งจะสร้างระเบียน งานเบื้องหลัง
• งานแบบครั้งเดียว (--at) จะถูกลบโดยอัตโนมัติหลังจากสำเร็จตามค่าเริ่มต้น ให้ส่ง --keep-after-run เพื่อเก็บงานไว้
• งบประมาณเวลาตามนาฬิกาสำหรับแต่ละรอบ: --timeout-seconds เมื่อตั้งค่าไว้ มิฉะนั้น งานรอบเอเจนต์แบบแยก/แยกออกจากเซสชันจะถูกจำกัดด้วยตัวเฝ้าระวัง 60 นาทีของ cron ก่อนที่การหมดเวลาของรอบเอเจนต์พื้นฐาน (agents.defaults.timeoutSeconds ค่าเริ่มต้น 48 ชั่วโมง) จะมีผล งานคำสั่งมีค่าเริ่มต้น 10 นาที และเพย์โหลดสคริปต์มีค่าเริ่มต้น 5 นาที
• เมื่อ Gateway เริ่มทำงาน งานรอบเอเจนต์แบบแยกที่เลยกำหนดจะถูกกำหนดเวลาใหม่แทนการเล่นซ้ำทันที เพื่อไม่ให้งานเริ่มต้นโมเดล/เครื่องมือรบกวนช่วงเชื่อมต่อช่องทาง
• หากคุณเรียกใช้ openclaw agent จาก cron ของระบบหรือตัวกำหนดเวลาภายนอกอื่น ให้ครอบด้วยการยกระดับเป็นการบังคับยุติ แม้ว่า CLI จะจัดการ SIGTERM/SIGINT อยู่แล้วก็ตาม การรันที่รองรับโดย Gateway จะขอให้ Gateway ยกเลิกการรันที่ยอมรับแล้ว ส่วนการรันสำรองแบบภายในเครื่องและแบบฝังตัวจะได้รับสัญญาณยกเลิกเดียวกัน สำหรับ GNU timeout ให้เลือกใช้ timeout -k 60 600 openclaw agent ... แทน timeout 600 ... แบบธรรมดา — ค่า -k เป็นมาตรการสำรองหากกระบวนการไม่สามารถปิดงานที่ค้างอยู่ได้ทันเวลา สำหรับยูนิต systemd ให้ใช้สัญญาณหยุด SIGTERM พร้อมช่วงผ่อนผัน (TimeoutStopSec) ก่อนการบังคับยุติขั้นสุดท้าย การใช้ --run-id ซ้ำขณะที่การรัน Gateway เดิมยังทำงานอยู่ จะแจ้งว่ารายการซ้ำกำลังดำเนินการอยู่แทนการเริ่มรันครั้งที่สอง

ประเภทกำหนดการ

การประทับเวลาที่ไม่มีเขตเวลาจะถือว่าเป็น UTC เพิ่ม --tz America/New_York เพื่อตีความวันเวลาของ --at ที่ไม่มีออฟเซ็ต หรือเพื่อประเมินนิพจน์ cron ในเขตเวลา IANA นั้น นิพจน์ cron ที่ไม่มี --tz จะใช้เขตเวลาของโฮสต์ Gateway ไม่สามารถใช้ --tz ร่วมกับ --every หรือ --on-exit ได้

นิพจน์แบบเกิดซ้ำเมื่อต้นชั่วโมง (นาที 0 โดยฟิลด์ชั่วโมงเป็นไวลด์การ์ด) จะถูกกระจายเวลาโดยอัตโนมัติสูงสุด 5 นาที เพื่อลดการพุ่งสูงของโหลด ใช้ --exact เพื่อบังคับเวลาที่แม่นยำ หรือ --stagger 30s เพื่อกำหนดช่วงเวลาอย่างชัดเจน (เฉพาะกำหนดการ cron)

จังหวะแบบไดนามิก (การกำหนดระยะ)

งานที่เกิดซ้ำสามารถตั้งค่า pacing.min และ/หรือ pacing.max เป็นสตริงระยะเวลา เช่น 15m หรือ 4h โดยต้องกำหนดขอบเขตอย่างน้อยหนึ่งค่า ใช้ --pacing-min และ --pacing-max ร่วมกับ cron add|edit (--clear-pacing จะลบขอบเขตทั้งสอง)

ระหว่างการรันแบบแยก งานที่กำหนดระยะสามารถเรียกเครื่องมือ cron ด้วย action: "next_check" และ in: "30m" ข้อเสนอจะมีผลเฉพาะกับงานที่กำลังทำงานอยู่ในขณะนั้น และวัดจากเวลาที่การรันเสร็จสมบูรณ์ OpenClaw จะจำกัดค่าให้อยู่ภายในขอบเขตที่กำหนดไว้อย่างเงียบ ๆ

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

วันของเดือนและวันของสัปดาห์ใช้ตรรกะ OR

นิพจน์ Cron จะถูกแยกวิเคราะห์โดย croner เมื่อทั้งฟิลด์วันของเดือนและวันของสัปดาห์ไม่ใช่ไวลด์การ์ด croner จะถือว่าตรงกันเมื่อฟิลด์ ใดฟิลด์หนึ่ง ตรงกัน ไม่ใช่ทั้งสองฟิลด์ นี่คือพฤติกรรมมาตรฐานของ Vixie cron

# เจตนา: "9 นาฬิกาของวันที่ 15 เฉพาะเมื่อเป็นวันจันทร์"# ผลจริง: "9 นาฬิกาของทุกวันที่ 15 และ 9 นาฬิกาของทุกวันจันทร์"0 9 15 * 1

กำหนดการนี้จะเริ่มทำงานประมาณ 5-6 ครั้งต่อเดือน แทนที่จะเป็น 0-1 ครั้งต่อเดือน หากต้องการให้ตรงตามเงื่อนไขทั้งสอง ให้ใช้ตัวแก้ไขวันของสัปดาห์ + ของ croner (0 9 15 * +1) หรือกำหนดเวลาตามฟิลด์หนึ่งและตรวจสอบอีกฟิลด์ในพรอมต์หรือคำสั่งของงาน

ทริกเกอร์เหตุการณ์ (ตัวเฝ้าดูเงื่อนไข)

ทริกเกอร์เหตุการณ์จะเพิ่มสคริปต์เงื่อนไขแบบไม่มีส่วนติดต่อให้กับกำหนดการ every หรือ cron Cron จะประเมินสคริปต์เมื่อถึงกำหนดของงาน และรันเพย์โหลดปกติเฉพาะเมื่อสคริปต์คืนค่า fire: true:

{  schedule: { kind: "every", everyMs: 30000 },  trigger: {    // เริ่มทำงานเฉพาะเมื่อสถานะที่สังเกตได้แตกต่างจากการประเมินครั้งล่าสุด    script: "const res = await tools.call('exec', { command: 'gh pr checks 123 --json state -q \\'.[].state\\' | sort -u' }); const status = String(res?.result?.details?.aggregated ?? '').trim(); json({ fire: status !== trigger.state?.status, message: `CI ของ PR 123: ${trigger.state?.status ?? 'ไม่ทราบ'} -> ${status}`, state: { status } });",    once: false,  },  payload: { kind: "agentTurn", message: "ตรวจสอบการเปลี่ยนแปลงสถานะ CI" },}

สคริปต์ต้องคืนค่า { fire, message?, state? } สถานะ JSON ก่อนหน้าจะพร้อมใช้งานในรูปแบบ trigger.state ที่ถูกตรึงอย่างลึก ให้คืนค่า state ใหม่เพื่อจัดเก็บอย่างถาวร สถานะถูกจำกัดไว้ที่ 16 KB เมื่อผลลัพธ์ที่เริ่มทำงานมี message cron จะผนวกค่านั้นต่อท้ายข้อความเหตุการณ์ระบบหรือข้อความรอบเอเจนต์ก่อนดำเนินการ once: true จะปิดใช้งานงานหลังจากเพย์โหลดที่เริ่มทำงานครั้งแรกสำเร็จ

fire: false จะจัดเก็บสถานะการประเมินและตัวนับอย่างถาวร จากนั้นกำหนดเวลาใหม่โดยไม่สร้างประวัติการรัน หากการรันเพย์โหลดที่เริ่มทำงานล้มเหลว state ที่คืนมาจะ ไม่ ถูกจัดเก็บ — การประเมินครั้งถัดไปจะเห็นสถานะก่อนหน้าและสามารถเริ่มทำงานอีกครั้ง ดังนั้นควรเขียนสคริปต์เป็นการตรวจสอบแบบอ่านอย่างเดียว และเก็บการดำเนินการไว้ในเพย์โหลด กำหนดการทริกเกอร์มีช่วงเวลาขั้นต่ำที่กำหนดค่าได้ (ค่าเริ่มต้น 30 วินาที) การประเมินแต่ละครั้งมีงบประมาณเวลาตามนาฬิกา 30 วินาที และเรียกเครื่องมือได้สูงสุด 5 ครั้ง

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

สร้างตัวเฝ้าดูจากไฟล์สคริปต์ในเครื่อง (- จะอ่านสคริปต์จาก stdin):

openclaw cron add \  --name "ตัวเฝ้าดู CI ของ PR" \  --every 30s \  --trigger-script ./watch-pr-ci.js \  --message "ตอบสนองต่อการเปลี่ยนแปลงสถานะ CI" \  --session isolated

เพย์โหลด

ทุกงานมีเพย์โหลดเพียงหนึ่งชนิด ซึ่งเลือกด้วยแฟล็ก:

ตัวเลือกรอบการทำงานของเอเจนต์

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

ลำดับความสำคัญในการเลือกโมเดลสำหรับงานแบบแยก จากสูงสุดก่อน:

1. เพย์โหลดรายงาน model (การกำหนดค่าแบบชัดเจน หากโมเดลไม่ได้รับอนุญาต การทำงานจะล้มเหลว)
2. การแทนที่โมเดลจากฮุก Gmail (เฉพาะเมื่อการทำงานมาจาก Gmail และการแทนที่นั้นได้รับอนุญาต)
3. การแทนที่โมเดลของเซสชัน Cron ที่จัดเก็บไว้และผู้ใช้เลือก
4. การเลือกโมเดลของเอเจนต์/ค่าเริ่มต้น

โหมดเร็วเป็นไปตามการเลือกแบบสดที่แปลงค่าแล้ว หากการกำหนดค่าโมเดลที่เลือกมี params.fastMode งาน Cron แบบแยกจะใช้ค่านั้นเป็นค่าเริ่มต้น แต่การแทนที่ fastMode ที่จัดเก็บไว้ในเซสชัน (จากนั้นคือ fastModeDefault ของเอเจนต์) ยังคงมีลำดับความสำคัญเหนือการกำหนดค่าโมเดลได้ทั้งสองทิศทาง โหมดอัตโนมัติใช้เกณฑ์ตัด params.fastAutoOnSeconds ของโมเดล โดยมีค่าเริ่มต้นเป็น 60 วินาที

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

ก่อนเริ่มการทำงานแบบแยก OpenClaw จะตรวจสอบเอนด์พอยต์ภายในที่เข้าถึงได้สำหรับผู้ให้บริการ api: "ollama" และ api: "openai-completions" ที่กำหนดค่าไว้ ซึ่ง baseUrl เป็นลูปแบ็ก เครือข่ายส่วนตัว หรือ .local การตรวจสอบล่วงหน้านี้จะไล่ตามเชนโมเดลสำรองที่กำหนดค่าไว้ของงาน และจะทำเครื่องหมายการทำงานเป็น skipped ก็ต่อเมื่อผู้สมัครทั้งหมดเข้าถึงไม่ได้ ส่วน --fallbacks "" จะจำกัดการไล่ตรวจสอบอย่างเข้มงวดให้เหลือเฉพาะโมเดลหลัก เอนด์พอยต์ที่ใช้งานไม่ได้จะบันทึกการทำงานเป็น skipped พร้อมข้อผิดพลาดที่ชัดเจน แทนที่จะเริ่มเรียกโมเดล ผลลัพธ์จะถูกแคชเป็นเวลา 5 นาทีต่อเอนด์พอยต์ (ไม่ใช่ต่องานหรือโมเดล) ดังนั้นงานจำนวนมากที่ถึงกำหนดและใช้เซิร์ฟเวอร์ Ollama/vLLM/SGLang/LM Studio ภายในที่หยุดทำงานร่วมกัน จะมีค่าใช้จ่ายเพียงการตรวจสอบหนึ่งครั้งแทนที่จะเกิดคำขอจำนวนมากพร้อมกัน การทำงานที่ข้ามเนื่องจากการตรวจสอบล่วงหน้าจะไม่เพิ่มการหน่วงเวลาหลังข้อผิดพลาดในการดำเนินการ ตั้งค่า failureAlert.includeSkipped เพื่อเลือกรับการแจ้งเตือนการข้ามซ้ำ

เพย์โหลดคำสั่ง

เพย์โหลดคำสั่งเรียกใช้สคริปต์แบบกำหนดผลลัพธ์ได้ภายในตัวจัดกำหนดการของ Gateway โดยไม่เริ่มรอบการทำงานที่ใช้โมเดล สคริปต์ทำงานบนโฮสต์ Gateway บันทึก stdout/stderr บันทึกการทำงานไว้ในประวัติ Cron และใช้โหมดการนำส่ง announce, webhook และ none แบบเดียวกับงานรอบการทำงานของเอเจนต์

openclaw cron create "*/15 * * * *" \  --name "Queue depth probe" \  --command "scripts/check-queue.sh" \  --command-cwd "/srv/app" \  --announce \  --channel telegram \  --to "-1001234567890"

--command <shell> จัดเก็บ argv: ["sh", "-lc", <shell>] ใช้ --command-argv '["node","scripts/report.mjs"]' สำหรับการดำเนินการ argv แบบตรงตัวโดยไม่มีการแยกวิเคราะห์ของเชลล์ ตัวเลือกเสริม --command-env KEY=VALUE (ระบุซ้ำได้), --command-input, --timeout-seconds (ค่าเริ่มต้น 10 นาที), --no-output-timeout-seconds และ --output-max-bytes ใช้ควบคุมสภาพแวดล้อมของโพรเซส stdin และขอบเขตเอาต์พุต

ข้อความที่นำส่งจะได้มาจากเอาต์พุตของโพรเซส โดย stdout ที่ไม่ว่างจะมีลำดับความสำคัญ หาก stdout ว่างและ stderr ไม่ว่าง ระบบจะนำส่ง stderr หากมีทั้งสองอย่าง Cron จะส่งบล็อก stdout: / stderr: ขนาดเล็ก รหัสออก 0 จะบันทึกการทำงานเป็น ok ส่วนรหัสออกที่ไม่ใช่ศูนย์ สัญญาณ หมดเวลา หรือหมดเวลาเนื่องจากไม่มีเอาต์พุต จะบันทึกเป็น error และอาจทริกเกอร์การแจ้งเตือนความล้มเหลว คำสั่งที่พิมพ์เพียง NO_REPLY จะใช้การระงับโทเค็นเงียบตามปกติของ Cron และไม่โพสต์สิ่งใดกลับไปยังแชต

เพย์โหลดสคริปต์

เพย์โหลดสคริปต์ทำงานแบบไม่มีส่วนติดต่อผู้ใช้ในตัวดำเนินการโหมดโค้ดเดียวกับสคริปต์ทริกเกอร์ โดยไม่เริ่มรอบการสนทนาของเอเจนต์ เปิดใช้ cron.triggers.enabled ก่อนสร้างหรือเรียกใช้ โดยเกตระบบอัตโนมัติที่เป็นอันตรายนี้ครอบคลุมทั้งสคริปต์ทริกเกอร์และเพย์โหลดสคริปต์ งานสคริปต์รองรับเฉพาะเป้าหมายเซสชัน main และ isolated

openclaw cron create "0 * * * *" \  --name "Hourly queue check" \  --script ./automation/check-queue.js \  --script-timeout-seconds 300 \  --script-tool-budget 50 \  --session isolated \  --announce

ใช้ --script <file|-> เพื่ออ่าน JavaScript จากไฟล์หรือ stdin ค่าหมดเวลามีค่าเริ่มต้นเป็น 300 วินาทีและจำกัดสูงสุดที่ 900 ส่วนงบประมาณเครื่องมือมีค่าเริ่มต้นเป็น 50 การเรียกและจำกัดสูงสุดที่ 200 งบประมาณเพย์โหลดเหล่านี้แยกจากงบประมาณการประเมินเกตทริกเกอร์ที่มีขนาดเล็กกว่า

สคริปต์อาจส่งคืนอ็อบเจ็กต์ที่มีฟิลด์เสริมต่อไปนี้:

• notify: ข้อความที่นำส่งผ่านโหมดการนำส่ง announce, webhook หรือ none ของงาน หากละไว้ จะไม่มีการนำส่งใด ๆ สำหรับงาน main ข้อความจะกลายเป็นเหตุการณ์ระบบ
• wake: "now" ร้องขอ Heartbeat ทันทีหลังจากนำ notify (หรือเหตุการณ์เสร็จสิ้นแบบย่อ) เข้าคิว ส่วน "next-heartbeat" จะนำเหตุการณ์เข้าคิวสำหรับ Heartbeat ครั้งถัดไป
• state: สถานะ JSON จำกัดที่ 16 KB และบันทึกถาวรหลังจากการทำงานสำเร็จเท่านั้น การทำงานครั้งถัดไปจะได้รับสำเนาแบบตรึงเป็น trigger.state ซึ่งสอดคล้องกับสคริปต์ทริกเกอร์ เนื่องจากเนมสเปซนั้นมีเจ้าของสถานะถาวรเพียงรายเดียว เพย์โหลดสคริปต์จึงไม่สามารถใช้ร่วมกับทริกเกอร์แบบมีเงื่อนไขในงานเดียวกันได้
• nextCheck: ระยะเวลา เช่น "15m" ใช้ได้เฉพาะกับงานที่เปิดใช้การกำหนดจังหวะ และใช้ขีดจำกัดการกำหนดจังหวะเดียวกับข้อเสนอของรอบการทำงานเอเจนต์

การโยนข้อผิดพลาด การหมดเวลา งบประมาณเครื่องมือหมด ผลลัพธ์ไม่ถูกต้อง และ nextCheck ที่ไม่มีการกำหนดจังหวะ ล้วนเป็นข้อผิดพลาดการทำงาน Cron ตามปกติ โดยจะเข้าสู่ประวัติการทำงาน การหน่วงเวลาหลังข้อผิดพลาด และการจัดการการแจ้งเตือนความล้มเหลว โดยไม่บันทึกสถานะที่ส่งคืนไว้อย่างถาวร

รูปแบบการดำเนินการ

การนำส่งและเอาต์พุต

ใช้ --announce --channel telegram --to "-1001234567890" สำหรับการนำส่งผ่านช่องทาง สำหรับหัวข้อฟอรัม Telegram ให้ใช้ -1001234567890:topic:123; OpenClaw ยังรองรับรูปแบบย่อ -1001234567890:123 ที่ Telegram เป็นเจ้าของด้วย ผู้เรียก RPC/การกำหนดค่าโดยตรงสามารถส่ง delivery.threadId เป็นสตริงหรือตัวเลขได้ เป้าหมาย Slack/Discord/Mattermost ใช้คำนำหน้าที่ระบุชัดเจน (channel:<id>, user:<id>) ID ห้อง Matrix แยกตัวพิมพ์เล็กและใหญ่ ให้ใช้ ID ห้องที่ตรงกันทุกประการหรือรูปแบบ room:!room:server จาก Matrix

เมื่อการนำส่งประกาศใช้ channel: "last" หรือละเว้น channel เป้าหมายที่มีคำนำหน้าผู้ให้บริการ เช่น telegram:123 สามารถเลือกช่องทางได้ ก่อนที่ cron จะย้อนกลับไปใช้ประวัติเซสชันหรือช่องทางเดียวที่กำหนดค่าไว้ มีเพียงคำนำหน้าที่ Plugin ซึ่งโหลดอยู่ประกาศไว้เท่านั้นที่เป็นตัวเลือกผู้ให้บริการ หากระบุ delivery.channel อย่างชัดเจน คำนำหน้าเป้าหมายต้องระบุผู้ให้บริการเดียวกัน โดย channel: "whatsapp" ร่วมกับ to: "telegram:123" จะถูกปฏิเสธ แทนที่จะปล่อยให้ WhatsApp ตีความ ID Telegram เป็นหมายเลขโทรศัพท์ คำนำหน้าประเภทเป้าหมายและบริการ (channel:<id>, user:<id>, imessage:<handle>, sms:<number>) ยังคงเป็นไวยากรณ์เป้าหมายที่ช่องทางเป็นเจ้าของ ไม่ใช่ตัวเลือกผู้ให้บริการ

สำหรับงานแบบแยก การนำส่งแชตจะใช้ร่วมกัน หากมีเส้นทางแชต เอเจนต์สามารถใช้เครื่องมือ message ได้แม้ใช้ --no-deliver หากเอเจนต์ส่งไปยังเป้าหมายที่กำหนดค่าไว้/เป้าหมายปัจจุบัน OpenClaw จะข้ามการประกาศสำรอง มิฉะนั้น announce, webhook และ none จะควบคุมเฉพาะสิ่งที่ตัวรันทำกับคำตอบสุดท้ายหลังจบรอบของเอเจนต์

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

การนำส่งประกาศโดยนัยใช้รายการอนุญาตของช่องทางที่กำหนดค่าไว้เพื่อตรวจสอบความถูกต้องและเปลี่ยนเส้นทางเป้าหมายที่ล้าสมัย การอนุมัติจากที่เก็บการจับคู่ DM ไม่ใช่ผู้รับของระบบอัตโนมัติสำรอง ให้ตั้งค่า delivery.to หรือกำหนดค่ารายการ allowFrom ของช่องทาง เมื่องานตามกำหนดเวลาควรส่งไปยัง DM เชิงรุก

การแจ้งเตือนความล้มเหลว

การแจ้งเตือนความล้มเหลวใช้เส้นทางปลายทางแยกต่างหาก:

• cron.failureDestination ตั้งค่าเริ่มต้นส่วนกลางสำหรับการแจ้งเตือนความล้มเหลว
• job.delivery.failureDestination เขียนทับค่านั้นเป็นรายงาน
• หากไม่ได้ตั้งค่าทั้งสองรายการและงานนำส่งผ่าน announce อยู่แล้ว การแจ้งเตือนความล้มเหลวจะย้อนกลับไปใช้เป้าหมายประกาศหลักนั้น
• delivery.failureDestination รองรับเฉพาะงาน sessionTarget="isolated" เว้นแต่โหมดการนำส่งหลักจะเป็น webhook
• failureAlert.includeSkipped: true เลือกให้งานหรือนโยบายการแจ้งเตือน cron ส่วนกลางส่งการแจ้งเตือนเมื่อข้ามการทำงานซ้ำ งานที่ถูกข้ามจะมีตัวนับการข้ามติดต่อกันแยกต่างหาก จึงไม่ส่งผลต่อการหน่วงแบบถอยกลับเมื่อเกิดข้อผิดพลาดในการดำเนินการ
• openclaw cron edit เปิดให้ปรับแต่งการแจ้งเตือนเป็นรายงาน ได้แก่ --failure-alert/--no-failure-alert, --failure-alert-after <n>, --failure-alert-channel, --failure-alert-to, --failure-alert-cooldown, --failure-alert-include-skipped/--failure-alert-exclude-skipped, --failure-alert-mode และ --failure-alert-account-id

ภาษาของเอาต์พุต

งาน Cron จะไม่อนุมานภาษาสำหรับตอบกลับจากช่องทาง โลแคล หรือข้อความก่อนหน้า ให้ใส่กฎด้านภาษาไว้ในข้อความหรือเทมเพลตตามกำหนดเวลา:

openclaw cron edit <jobId> \  --message "สรุปการอัปเดต ตอบเป็นภาษาจีน โดยคง URL, โค้ด และชื่อผลิตภัณฑ์ไว้เหมือนเดิม"

สำหรับไฟล์เทมเพลต ให้คงคำสั่งด้านภาษาไว้ในพรอมต์ที่เรนเดอร์แล้ว และตรวจสอบว่าตัวยึดตำแหน่ง เช่น {{language}} ถูกเติมค่าก่อนงานทำงาน หากเอาต์พุตมีหลายภาษาปะปนกัน ให้ระบุกฎอย่างชัดเจน เช่น: "ใช้ภาษาจีนสำหรับข้อความบรรยายและคงศัพท์เทคนิคเป็นภาษาอังกฤษ"

ตัวอย่าง CLI

openclaw cron add \  --name "ตรวจสอบปฏิทิน" \  --at "20m" \  --session main \  --system-event "Heartbeat ครั้งถัดไป: ตรวจสอบปฏิทิน" \  --wake now

openclaw cron create "0 7 * * *" \  "สรุปการอัปเดตข้ามคืน" \  --name "สรุปช่วงเช้า" \  --tz "America/Los_Angeles" \  --session isolated \  --announce \  --channel slack \  --to "channel:C1234567890"

openclaw cron add \  --name "การวิเคราะห์เชิงลึก" \  --cron "0 6 * * 1" \  --tz "America/Los_Angeles" \  --session isolated \  --message "การวิเคราะห์เชิงลึกรายสัปดาห์เกี่ยวกับความคืบหน้าของโครงการ" \  --model "opus" \  --thinking high \  --announce

openclaw cron create "0 18 * * 1-5" \  "สรุปการปรับใช้ของวันนี้เป็น JSON" \  --name "สรุปการปรับใช้" \  --webhook "https://example.invalid/openclaw/cron"

openclaw cron create "*/15 * * * *" \  --name "โพรบความลึกของคิว" \  --command "scripts/check-queue.sh" \  --command-cwd "/srv/app" \  --announce \  --channel telegram \  --to "-1001234567890"

การจัดการงาน

# แสดงงานทั้งหมดopenclaw cron list # รับงานที่จัดเก็บไว้หนึ่งงานเป็น JSONopenclaw cron get <jobId> # แสดงงานหนึ่งงาน รวมถึงเส้นทางการนำส่งที่แก้ค่าแล้วopenclaw cron show <jobId> # เปิด/ปิดใช้งานโดยไม่ลบopenclaw cron enable <jobId>openclaw cron disable <jobId> # แก้ไขงานopenclaw cron edit <jobId> --message "พรอมต์ที่อัปเดตแล้ว" --model "opus" # บังคับเรียกใช้งานทันทีopenclaw cron run <jobId> # บังคับเรียกใช้งานทันทีและรอสถานะสิ้นสุดopenclaw cron run <jobId> --wait --wait-timeout 10m --poll-interval 2s # เรียกใช้เฉพาะเมื่อถึงกำหนดopenclaw cron run <jobId> --due # ดูประวัติการทำงานopenclaw cron runs --id <jobId> --limit 50 # ดูการทำงานที่ตรงกันหนึ่งรายการopenclaw cron runs --id <jobId> --run-id <runId> # ลบงานopenclaw cron remove <jobId> # การเลือกเอเจนต์ (การตั้งค่าแบบหลายเอเจนต์)openclaw cron create "0 6 * * *" "ตรวจสอบคิวปฏิบัติการ" --name "กวาดตรวจปฏิบัติการ" --session isolated --agent opsopenclaw cron edit <jobId> --clear-agent

การเก็บเซสชันเข้าคลัง (ผ่าน Control UI หรือ sessions.patch { archived: true } จากผู้เรียกที่เป็นผู้ดูแลระบบของผู้ปฏิบัติงาน) จะปิดใช้งานงาน cron ที่เปิดใช้งานอยู่ทั้งหมดซึ่งผูกกับเซสชันนั้น ได้แก่ เซสชัน cron:<jobId> แบบแยก เป้าหมาย session:<key> หรือเลนการนำส่ง/ปลุก sessionKey การกู้คืนเซสชันจะไม่เปิดใช้งานงานเหล่านั้นอีกครั้ง ให้ใช้ openclaw cron enable <jobId> เซสชันที่มีงานที่ผูกไว้และเปิดใช้งานอยู่จะแสดงป้ายรูปนาฬิกาในแถบด้านข้างของ Control UI

openclaw cron run <jobId> จะส่งคืนหลังจากเพิ่มการทำงานด้วยตนเองลงในคิว ใช้ --wait สำหรับฮุกปิดระบบ สคริปต์บำรุงรักษา หรือระบบอัตโนมัติอื่นที่ต้องบล็อกจนกว่าการทำงานในคิวจะเสร็จสิ้น โดยจะสำรวจ runId ที่ส่งคืนมา (ระยะหมดเวลาเริ่มต้น 10m, ช่วงเวลาสำรวจ 2s) และออกด้วย 0 สำหรับสถานะ ok และออกด้วยค่าที่ไม่ใช่ศูนย์สำหรับ error, skipped หรือการรอหมดเวลา

เครื่องมือ cron ของเอเจนต์ส่งคืนสรุปงานแบบกระชับ (id, name, enabled, nextRunAtMs, scheduleKind, lastRunStatus) จาก cron(action: "list"); ใช้ cron(action: "get", jobId: "...") สำหรับคำจำกัดความงานแบบเต็มหนึ่งรายการ ผู้เรียก Gateway โดยตรงสามารถส่ง compact: true ไปยัง cron.list; การละเว้นค่านี้จะคงการตอบกลับแบบเต็มพร้อมตัวอย่างการนำส่ง

openclaw cron create เป็นนามแฝงของ openclaw cron add งานใหม่สามารถใช้กำหนดการแบบระบุตำแหน่ง ("0 9 * * 1", "every 1h", "20m" หรือการประทับเวลา ISO) ตามด้วยพรอมต์เอเจนต์แบบระบุตำแหน่ง ใช้ --webhook <url> กับ cron add|create หรือ cron edit เพื่อ POST เพย์โหลดการทำงานที่เสร็จสิ้นแล้วไปยังปลายทาง HTTP; การนำส่ง Webhook ไม่สามารถใช้ร่วมกับแฟล็กการนำส่งแชต (--announce, --channel, --to, --thread-id, --account) สำหรับ cron edit, --clear-channel, --clear-to, --clear-thread-id และ --clear-account ให้ยกเลิกการตั้งค่าฟิลด์การกำหนดเส้นทางเหล่านั้นทีละรายการ (แต่ละรายการจะถูกปฏิเสธหากใช้ร่วมกับแฟล็กตั้งค่าที่ตรงกัน) ซึ่งต่างจาก --no-deliver ที่ปิดใช้งานเฉพาะการนำส่งสำรองของตัวรัน

Webhook

Gateway สามารถเปิดเผยปลายทาง HTTP Webhook สำหรับทริกเกอร์ภายนอก เปิดใช้งานในการกำหนดค่า:

{  hooks: {    enabled: true,    token: "shared-secret",    path: "/hooks",  },}

การยืนยันตัวตน

ทุกคำขอต้องมีโทเค็นฮุกผ่านส่วนหัว:

• Authorization: Bearer <token> (แนะนำ)
• x-openclaw-token: <token>

โทเค็นในสตริงคิวรีจะถูกปฏิเสธ

curl -X POST http://127.0.0.1:18789/hooks/wake \  -H 'Authorization: Bearer SECRET' \  -H 'Content-Type: application/json' \  -d '{"text":"ได้รับอีเมลใหม่","mode":"now"}'

curl -X POST http://127.0.0.1:18789/hooks/agent \  -H 'Authorization: Bearer SECRET' \  -H 'Content-Type: application/json' \  -d '{"message":"สรุปกล่องขาเข้า","name":"อีเมล","model":"openai/gpt-5.6-sol"}'

การผสานรวม Gmail PubSub

เชื่อมทริกเกอร์กล่องจดหมาย Gmail เข้ากับ OpenClaw ผ่าน Google PubSub

การตั้งค่าด้วยตัวช่วยสร้าง (แนะนำ)

openclaw webhooks gmail setup --account openclaw@gmail.com

คำสั่งนี้จะเขียนการกำหนดค่า hooks.gmail, เปิดใช้ค่าที่ตั้งไว้ล่วงหน้าสำหรับ Gmail และกำหนดค่าเริ่มต้นเป็น Tailscale Funnel สำหรับตำแหน่งข้อมูลพุช (--tailscale funnel|serve|off)

การเริ่ม Gateway โดยอัตโนมัติ

เมื่อตั้งค่า hooks.enabled=true และ hooks.gmail.account แล้ว Gateway จะเริ่ม gog gmail watch serve ระหว่างการบูตและต่ออายุการเฝ้าดูโดยอัตโนมัติ ตั้งค่า OPENCLAW_SKIP_GMAIL_WATCHER=1 เพื่อเลือกไม่ใช้

การตั้งค่าด้วยตนเองครั้งเดียว

gcloud auth logingcloud config set project <project-id>gcloud services enable gmail.googleapis.com pubsub.googleapis.com

gcloud pubsub topics create gog-gmail-watchgcloud pubsub topics add-iam-policy-binding gog-gmail-watch \  --member=serviceAccount:gmail-api-push@system.gserviceaccount.com \  --role=roles/pubsub.publisher

gog gmail watch start \  --account openclaw@gmail.com \  --label INBOX \  --topic projects/<project-id>/topics/gog-gmail-watch

การแทนที่โมเดลสำหรับ Gmail

{  hooks: {    gmail: {      model: "openai/gpt-5.6-sol",      thinking: "high",    },  },}

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

การกำหนดค่า

{  cron: {    enabled: true,    store: "~/.openclaw/cron/jobs.json",    triggers: {      enabled: false,    },    webhookToken: "replace-with-dedicated-webhook-token",    sessionRetention: "24h",  },}

webhookToken จะถูกส่งเป็น Authorization: Bearer <token> ในคำขอ POST ของ Webhook Cron

cron.store เป็นคีย์ที่เก็บข้อมูลเชิงตรรกะและพาธการย้ายข้อมูลของ doctor ไม่ใช่ไฟล์ JSON ที่ใช้งานอยู่สำหรับแก้ไขด้วยตนเอง ข้อมูลงานอยู่ใน SQLite ให้ใช้ CLI หรือ API ของ Gateway เพื่อแก้ไข

ปิดใช้ Cron: cron.enabled: false หรือ OPENCLAW_SKIP_CRON=1

การแก้ไขปัญหา

ลำดับคำสั่ง

openclaw statusopenclaw gateway statusopenclaw cron statusopenclaw cron listopenclaw cron runs --id <jobId> --limit 20openclaw system heartbeat lastopenclaw logs --followopenclaw doctor

เนื้อหาที่เกี่ยวข้อง

• ระบบอัตโนมัติ — กลไกการทำงานอัตโนมัติทั้งหมดโดยสรุป
• งานเบื้องหลัง — บัญชีรายการงานสำหรับการดำเนินการ Cron
• Heartbeat — เทิร์นของเซสชันหลักเป็นระยะ
• เขตเวลา — การกำหนดค่าเขตเวลา