Langsung ke konten utama

Otomatisasi & Tugas

OpenClaw menjalankan pekerjaan di latar belakang melalui tugas, pekerjaan terjadwal, event hook, dan instruksi tetap. Halaman ini membantu Anda memilih mekanisme yang tepat dan memahami bagaimana semuanya saling terkait.

Panduan keputusan cepat

Kasus penggunaanRekomendasiAlasan
Kirim laporan harian tepat pukul 9 pagiTugas Terjadwal (Cron)Waktu tepat, eksekusi terisolasi
Ingatkan saya dalam 20 menitTugas Terjadwal (Cron)Sekali jalan dengan waktu yang presisi (--at)
Jalankan analisis mendalam mingguanTugas Terjadwal (Cron)Tugas mandiri, dapat menggunakan model berbeda
Periksa inbox setiap 30 menitHeartbeatDigabungkan dengan pemeriksaan lain, sadar konteks
Pantau kalender untuk acara mendatangHeartbeatCocok secara alami untuk kesadaran berkala
Periksa status subagent atau eksekusi ACPTugas Latar BelakangBuku besar tugas melacak semua pekerjaan yang dilepas
Audit apa yang dijalankan dan kapanTugas Latar Belakangopenclaw tasks list dan openclaw tasks audit
Riset multi-langkah lalu rangkumTask FlowOrkestrasi tahan lama dengan pelacakan revisi
Jalankan skrip saat reset sesiHooksBerbasis peristiwa, dipicu pada peristiwa siklus hidup
Jalankan kode pada setiap pemanggilan toolHooksHooks dapat memfilter berdasarkan jenis peristiwa
Selalu periksa kepatuhan sebelum membalasStanding OrdersDisuntikkan ke setiap sesi secara otomatis

Tugas Terjadwal (Cron) vs Heartbeat

DimensiTugas Terjadwal (Cron)Heartbeat
WaktuTepat (ekspresi cron, sekali jalan)Perkiraan (default setiap 30 menit)
Konteks sesiBaru (terisolasi) atau bersamaKonteks sesi utama penuh
Catatan tugasSelalu dibuatTidak pernah dibuat
PenyampaianChannel, webhook, atau senyapInline di sesi utama
Paling cocok untukLaporan, pengingat, pekerjaan latar belakangPemeriksaan inbox, kalender, notifikasi
Gunakan Tugas Terjadwal (Cron) saat Anda membutuhkan waktu yang presisi atau eksekusi terisolasi. Gunakan Heartbeat saat pekerjaan mendapat manfaat dari konteks sesi penuh dan waktu perkiraan sudah memadai.

Konsep inti

Tugas terjadwal (cron)

Cron adalah penjadwal bawaan Gateway untuk waktu yang presisi. Cron menyimpan pekerjaan, membangunkan agen pada waktu yang tepat, dan dapat mengirimkan output ke channel obrolan atau endpoint webhook. Mendukung pengingat sekali jalan, ekspresi berulang, dan pemicu webhook masuk. Lihat Tugas Terjadwal.

Tugas

Buku besar tugas latar belakang melacak semua pekerjaan yang dilepas: eksekusi ACP, spawn subagent, eksekusi cron terisolasi, dan operasi CLI. Tugas adalah catatan, bukan penjadwal. Gunakan openclaw tasks list dan openclaw tasks audit untuk memeriksanya. Lihat Tugas Latar Belakang.

Task Flow

Task Flow adalah substrat orkestrasi alur di atas tugas latar belakang. Task Flow mengelola alur multi-langkah yang tahan lama dengan mode sinkronisasi terkelola dan tercermin, pelacakan revisi, serta openclaw tasks flow list|show|cancel untuk inspeksi. Lihat Task Flow.

Standing orders

Standing orders memberi agen wewenang operasional permanen untuk program yang ditentukan. Standing orders disimpan dalam file workspace (biasanya AGENTS.md) dan disuntikkan ke setiap sesi. Gabungkan dengan cron untuk penegakan berbasis waktu. Lihat Standing Orders.

Hooks

Hooks adalah skrip berbasis peristiwa yang dipicu oleh peristiwa siklus hidup agen (/new, /reset, /stop), pemadatan sesi, startup gateway, alur pesan, dan pemanggilan tool. Hooks ditemukan secara otomatis dari direktori dan dapat dikelola dengan openclaw hooks. Lihat Hooks.

Heartbeat

Heartbeat adalah giliran sesi utama berkala (default setiap 30 menit). Heartbeat menggabungkan beberapa pemeriksaan (inbox, kalender, notifikasi) dalam satu giliran agen dengan konteks sesi penuh. Giliran heartbeat tidak membuat catatan tugas. Gunakan HEARTBEAT.md untuk daftar periksa kecil, atau blok tasks: saat Anda menginginkan pemeriksaan berkala hanya-saat-jatuh-tempo di dalam heartbeat itu sendiri. File heartbeat kosong dilewati sebagai empty-heartbeat-file; mode tugas hanya-saat-jatuh-tempo dilewati sebagai no-tasks-due. Lihat Heartbeat.

Cara kerjanya bersama-sama

  • Cron menangani jadwal presisi (laporan harian, tinjauan mingguan) dan pengingat sekali jalan. Semua eksekusi cron membuat catatan tugas.
  • Heartbeat menangani pemantauan rutin (inbox, kalender, notifikasi) dalam satu giliran gabungan setiap 30 menit.
  • Hooks bereaksi terhadap peristiwa tertentu (pemanggilan tool, reset sesi, pemadatan) dengan skrip kustom.
  • Standing orders memberi agen konteks persisten dan batas wewenang.
  • Task Flow mengoordinasikan alur multi-langkah di atas tugas individual.
  • Tugas secara otomatis melacak semua pekerjaan yang dilepas sehingga Anda dapat memeriksa dan mengauditnya.

Terkait