Skip to main content
OpenClaw menjalankan pekerjaan di latar belakang melalui tugas, pekerjaan terjadwal, komitmen yang disimpulkan, hook peristiwa, dan instruksi tetap. Gunakan halaman ini untuk memilih mekanisme yang tepat.

Panduan keputusan cepat

Tugas Terjadwal (Cron) dibandingkan dengan Heartbeat

Gunakan Tugas Terjadwal (Cron) saat Anda memerlukan waktu yang presisi atau eksekusi terisolasi. Gunakan Heartbeat saat pekerjaan memperoleh manfaat dari konteks sesi lengkap 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 keluaran ke kanal percakapan 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 terpisah: proses ACP, pembuatan subagen, 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.

Komitmen yang disimpulkan

Komitmen adalah memori tindak lanjut jangka pendek yang harus diaktifkan secara eksplisit. OpenClaw menyimpulkannya dari percakapan biasa, membatasinya pada agen dan kanal yang sama, serta menyampaikan tindak lanjut yang jatuh tempo melalui Heartbeat. Pengingat dengan waktu tepat yang diminta pengguna tetap menjadi ranah cron. Lihat Komitmen yang Disimpulkan.

Task Flow

Task Flow adalah landasan orkestrasi alur di atas tugas latar belakang. Task Flow mengelola alur multilangkah persisten dengan mode sinkronisasi terkelola dan tercermin, pelacakan revisi, serta openclaw tasks flow list|show|cancel untuk pemeriksaan. Lihat Task Flow.

Perintah tetap

Perintah tetap memberikan wewenang operasional permanen kepada agen untuk program yang ditentukan. Perintah tersebut berada dalam berkas ruang kerja (biasanya AGENTS.md) dan disuntikkan ke setiap sesi. Gabungkan dengan cron untuk penerapan berbasis waktu. Lihat Perintah Tetap.

Hook

Hook internal adalah skrip berbasis peristiwa yang dipicu oleh peristiwa siklus hidup agen (/new, /reset, /stop), Compaction sesi, startup Gateway, dan alur pesan. Hook ditemukan dari direktori hook dan dikelola dengan openclaw hooks. Untuk pencegatan pemanggilan alat dalam proses, gunakan hook Plugin. Lihat Hook.

Heartbeat

Heartbeat adalah giliran sesi utama berkala (bawaan setiap 30 menit). Heartbeat menggabungkan beberapa pemeriksaan (kotak masuk, kalender, notifikasi) dalam satu giliran agen dengan konteks sesi lengkap. Giliran Heartbeat tidak membuat catatan tugas dan tidak memperpanjang kebaruan pengaturan ulang sesi harian/tidak aktif. Gunakan HEARTBEAT.md untuk daftar periksa singkat, atau blok tasks: jika Anda menginginkan pemeriksaan berkala yang hanya dijalankan saat jatuh tempo di dalam Heartbeat itu sendiri. Berkas Heartbeat kosong dilewati sebagai empty-heartbeat-file; mode tugas khusus jatuh tempo dilewati sebagai no-tasks-due. Heartbeat ditunda saat pekerjaan cron aktif atau mengantre, dan heartbeat.skipWhenBusy juga dapat menunda agen saat lajur subagen berbasis kunci sesi atau lajur bertingkat milik agen yang sama sedang sibuk. Lihat Heartbeat.

Cara semuanya bekerja bersama

  • Cron menangani jadwal presisi (laporan harian, tinjauan mingguan) dan pengingat sekali jalan. Semua eksekusi cron membuat catatan tugas.
  • Heartbeat menangani pemantauan rutin (kotak masuk, kalender, notifikasi) dalam satu giliran gabungan setiap 30 menit.
  • Hook merespons peristiwa tertentu (pengaturan ulang sesi, Compaction, alur pesan) dengan skrip khusus. Hook Plugin mencakup pemanggilan alat.
  • Perintah tetap memberikan konteks persisten dan batas wewenang kepada agen.
  • Task Flow mengoordinasikan alur multilangkah di atas tugas individual.
  • Tugas secara otomatis melacak semua pekerjaan terpisah agar Anda dapat memeriksa dan mengauditnya.

Terkait