Langsung ke konten utama

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 menjalankan pekerjaan di latar belakang melalui tugas, pekerjaan terjadwal, komitmen tersirat, hook peristiwa, dan instruksi tetap. Halaman ini membantu Anda memilih mekanisme yang tepat dan memahami bagaimana semuanya saling terhubung.

​
Panduan keputusan cepat

Kasus penggunaanDirekomendasikanAlasan
Kirim laporan harian tepat pukul 09.00Tugas Terjadwal (Cron)Waktu tepat, eksekusi terisolasi
Ingatkan saya dalam 20 menitTugas Terjadwal (Cron)Sekali jalan dengan waktu presisi (--at)
Jalankan analisis mendalam mingguanTugas Terjadwal (Cron)Tugas mandiri, dapat menggunakan model berbeda
Periksa kotak masuk setiap 30 menitHeartbeatDikelompokkan dengan pemeriksaan lain, sadar konteks
Pantau kalender untuk acara mendatangHeartbeatCocok alami untuk kesadaran berkala
Tindak lanjuti setelah wawancara yang disebutkanKomitmen TersiratTindak lanjut seperti memori, tanpa permintaan pengingat tepat
Pemeriksaan perhatian ringan setelah konteks penggunaKomitmen TersiratDicakup ke agen dan kanal yang sama
Periksa status subagen atau eksekusi ACPTugas Latar BelakangBuku besar tugas melacak semua pekerjaan terlepas
Audit apa yang berjalan dan kapanTugas Latar Belakangopenclaw tasks list dan openclaw tasks audit
Riset multi-langkah lalu ringkasTask FlowOrkestrasi tahan lama dengan pelacakan revisi
Jalankan skrip saat sesi diresetHookBerbasis peristiwa, aktif pada peristiwa siklus hidup
Eksekusi kode pada setiap pemanggilan alatHook PluginHook dalam proses dapat mencegat pemanggilan alat
Selalu periksa kepatuhan sebelum membalasPerintah TetapDisuntikkan otomatis ke setiap sesi

​
Tugas Terjadwal (Cron) vs Heartbeat

DimensiTugas Terjadwal (Cron)Heartbeat
WaktuTepat (ekspresi cron, sekali jalan)Perkiraan (bawaan setiap 30 menit)
Konteks sesiBaru (terisolasi) atau bersamaKonteks sesi utama penuh
Catatan tugasSelalu dibuatTidak pernah dibuat
PengirimanKanal, webhook, atau senyapSebaris dalam sesi utama
Paling cocok untukLaporan, pengingat, pekerjaan latar belakangPemeriksaan kotak masuk, kalender, notifikasi
Gunakan Tugas Terjadwal (Cron) saat Anda membutuhkan waktu presisi atau eksekusi terisolasi. Gunakan Heartbeat saat pekerjaan diuntungkan oleh konteks sesi penuh dan waktu perkiraan sudah memadai.

​
Konsep inti

​
Tugas terjadwal (cron)

Cron adalah penjadwal bawaan Gateway untuk waktu presisi. Cron menyimpan pekerjaan, membangunkan agen pada waktu yang tepat, dan dapat mengirim keluaran ke kanal chat 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 terlepas: eksekusi ACP, pemunculan 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 tersirat

Komitmen adalah memori tindak lanjut yang ikut serta dan berumur pendek. OpenClaw menyimpulkannya dari percakapan normal, mencakupnya ke agen dan kanal yang sama, dan mengirim pemeriksaan saat jatuh tempo melalui heartbeat. Pengingat tepat yang diminta pengguna tetap menjadi ranah cron. Lihat Komitmen Tersirat.

​
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.

​
Perintah tetap

Perintah tetap memberi agen otoritas operasi permanen untuk program yang ditentukan. Perintah ini berada di file workspace (biasanya AGENTS.md) dan disuntikkan ke setiap sesi. Gabungkan dengan cron untuk penegakan 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 otomatis dari direktori dan dapat dikelola dengan openclaw hooks. Untuk intersepsi pemanggilan alat dalam proses, gunakan Hook Plugin. Lihat Hook.

​
Heartbeat

Heartbeat adalah giliran sesi utama berkala (bawaan setiap 30 menit). Heartbeat mengelompokkan beberapa pemeriksaan (kotak masuk, kalender, notifikasi) dalam satu giliran agen dengan konteks sesi penuh. Giliran heartbeat tidak membuat catatan tugas dan tidak memperpanjang kesegaran reset sesi harian/menganggur. Gunakan HEARTBEAT.md untuk checklist kecil, atau blok tasks: saat Anda menginginkan pemeriksaan berkala hanya yang jatuh tempo di dalam heartbeat itu sendiri. File heartbeat kosong dilewati sebagai empty-heartbeat-file; mode tugas hanya jatuh tempo dilewati sebagai no-tasks-due. Heartbeat ditunda saat pekerjaan cron aktif atau mengantre, dan heartbeat.skipWhenBusy juga dapat menunda agen saat subagen atau jalur bertingkat berkunci sesi 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 berkelompok setiap 30 menit.
  • Hook bereaksi terhadap peristiwa tertentu (reset sesi, Compaction, alur pesan) dengan skrip khusus. Hook Plugin mencakup pemanggilan alat.
  • Perintah tetap memberi agen konteks persisten dan batas otoritas.
  • Task Flow mengoordinasikan alur multi-langkah di atas tugas individual.
  • Tugas otomatis melacak semua pekerjaan terlepas agar Anda dapat memeriksa dan mengauditnya.

​
Terkait