Kapan menggunakan Task Flow
Gunakan Task Flow ketika pekerjaan mencakup beberapa langkah berurutan atau bercabang dan Anda membutuhkan pelacakan progres yang durabel di seluruh restart gateway. Untuk operasi latar belakang tunggal, tugas biasa sudah memadai.| Skenario | Penggunaan |
|---|---|
| Pekerjaan latar belakang tunggal | Tugas biasa |
| Pipeline multi-langkah (A lalu B lalu C) | Task Flow (terkelola) |
| Mengamati tugas yang dibuat secara eksternal | Task Flow (tercermin) |
| Pengingat sekali jalan | Cron job |
Pola alur kerja terjadwal yang andal
Untuk alur kerja berulang seperti ringkasan intelijen pasar, perlakukan jadwal, orkestrasi, dan pemeriksaan keandalan sebagai lapisan terpisah:- Gunakan Tugas Terjadwal untuk pengaturan waktu.
- Gunakan sesi cron persisten ketika alur kerja harus dibangun di atas konteks sebelumnya.
- Gunakan Lobster untuk langkah deterministik, gerbang persetujuan, dan token lanjutkan.
- Gunakan Task Flow untuk melacak eksekusi multi-langkah di seluruh tugas turunan, penantian, percobaan ulang, dan restart gateway.
session:<id> alih-alih isolated ketika alur kerja berulang membutuhkan riwayat yang disengaja, ringkasan eksekusi sebelumnya, atau konteks tetap. Gunakan isolated ketika setiap eksekusi harus dimulai dari awal dan semua status yang diperlukan dinyatakan secara eksplisit dalam alur kerja.
Di dalam alur kerja, letakkan pemeriksaan keandalan sebelum langkah ringkasan LLM:
- Ketersediaan browser dan pilihan profil, misalnya
openclawuntuk status terkelola atauuserketika sesi Chrome yang sudah masuk diperlukan. Lihat Browser. - Kredensial API dan kuota untuk setiap sumber.
- Keterjangkauan jaringan untuk endpoint yang diperlukan.
- Alat yang diperlukan diaktifkan untuk agen, seperti
lobster,browser, danllm-task. - Tujuan kegagalan dikonfigurasi untuk cron agar kegagalan preflight terlihat. Lihat Tugas Terjadwal.
sourceUrl, retrievedAt, dan asOf dalam outputnya. Gunakan LLM Task ketika Anda membutuhkan langkah model yang divalidasi skema di dalam alur kerja.
Untuk alur kerja tim atau komunitas yang dapat digunakan ulang, kemas CLI, file .lobster, dan catatan penyiapan apa pun sebagai skill atau plugin lalu terbitkan melalui ClawHub. Simpan guardrail khusus alur kerja di paket tersebut kecuali API plugin tidak memiliki kemampuan generik yang diperlukan.
Mode sinkronisasi
Mode terkelola
Task Flow memiliki siklus hidup dari awal sampai akhir. Ia membuat tugas sebagai langkah alur, mendorongnya hingga selesai, dan memajukan status alur secara otomatis. Contoh: alur laporan mingguan yang (1) mengumpulkan data, (2) menghasilkan laporan, dan (3) mengirimkannya. Task Flow membuat setiap langkah sebagai tugas latar belakang, menunggu penyelesaian, lalu berpindah ke langkah berikutnya.Mode tercermin
Task Flow mengamati tugas yang dibuat secara eksternal dan menjaga status alur tetap sinkron tanpa mengambil alih kepemilikan pembuatan tugas. Ini berguna ketika tugas berasal dari cron job, perintah CLI, atau sumber lain dan Anda menginginkan tampilan terpadu atas progresnya sebagai alur. Contoh: tiga cron job independen yang bersama-sama membentuk rutinitas “operasi pagi”. Alur tercermin melacak progres kolektifnya tanpa mengontrol kapan atau bagaimana tugas tersebut berjalan.Status durabel dan pelacakan revisi
Setiap alur mempertahankan statusnya sendiri dan melacak revisi sehingga progres bertahan melewati restart gateway. Pelacakan revisi memungkinkan deteksi konflik ketika beberapa sumber mencoba memajukan alur yang sama secara bersamaan. Registri alur menggunakan SQLite dengan pemeliharaan write-ahead-log terbatas, termasuk checkpoint berkala dan saat shutdown, sehingga gateway yang berjalan lama tidak menyimpan file sidecarregistry.sqlite-wal tanpa batas.
Perilaku pembatalan
openclaw tasks flow cancel menetapkan maksud pembatalan yang melekat pada alur. Tugas aktif di dalam alur dibatalkan, dan tidak ada langkah baru yang dimulai. Maksud pembatalan tetap ada melewati restart, sehingga alur yang dibatalkan tetap dibatalkan bahkan jika gateway dimulai ulang sebelum semua tugas turunan berakhir.
Perintah CLI
| Perintah | Deskripsi |
|---|---|
openclaw tasks flow list | Menampilkan alur terlacak beserta status dan mode sinkronisasi |
openclaw tasks flow show <id> | Memeriksa satu alur berdasarkan id alur atau kunci pencarian |
openclaw tasks flow cancel <id> | Membatalkan alur yang sedang berjalan dan tugas aktifnya |
Hubungan alur dengan tugas
Alur mengoordinasikan tugas, bukan menggantikannya. Satu alur dapat menggerakkan beberapa tugas latar belakang sepanjang masa hidupnya. Gunakanopenclaw tasks untuk memeriksa catatan tugas individual dan openclaw tasks flow untuk memeriksa alur yang mengorkestrasi.
Terkait
- Tugas Latar Belakang — ledger pekerjaan terlepas yang dikoordinasikan oleh alur
- CLI: tugas — referensi perintah CLI untuk
openclaw tasks flow - Ikhtisar Otomasi — semua mekanisme otomasi secara sekilas
- Cron Jobs — pekerjaan terjadwal yang dapat mengalir ke dalam alur