Alur tugas

Alur Tugas adalah lapisan orkestrasi di atas tugas latar belakang. Alur merupakan catatan persisten untuk pekerjaan bertahap dengan status, state JSON, penghitung revisi, dan catatan tugas tertautnya sendiri. Alur tetap bertahan setelah Gateway dimulai ulang; setiap tugas tetap menjadi unit pekerjaan terpisah.

Kapan menggunakan Alur Tugas

Mode sinkronisasi

Mode terkelola

Alur terkelola memiliki pengontrol: kode Plugin yang membuat alur melalui API Alur Tugas runtime Plugin dengan tujuan dan ID pengontrol wajib, lalu menggerakkannya secara eksplisit.

• Setiap langkah berjalan sebagai tugas latar belakang yang dibuat di bawah alur; kunci pemilik dan asal peminta alur diteruskan ke tugas anak.
• Pengontrol memajukan alur di antara status running, waiting, dan status terminal, serta menyimpan state langkah JSON arbitrer pada catatan alur.
• Setiap mutasi menyertakan revisi yang diharapkan dari alur. Penulisan dengan revisi usang ditolak sebagai konflik revisi alih-alih menimpa state yang lebih baru.
• Setelah pembatalan diminta, tugas anak baru ditolak, dan alur diselesaikan sebagai cancelled ketika tidak ada tugas anak yang masih aktif.

Contoh: alur laporan mingguan yang (1) mengumpulkan data, (2) membuat laporan, dan (3) mengirimkannya, dengan satu tugas latar belakang per langkah:

Alur: laporan-mingguan  Langkah 1: kumpulkan-data → tugas dibuat → berhasil  Langkah 2: buat-laporan   → tugas dibuat → berhasil  Langkah 3: kirim          → tugas dibuat → berjalan

Mode pencerminan

OpenClaw secara otomatis membuat alur satu tugas yang dicerminkan ketika proses ACP atau subagen terpisah dimulai (tugas dalam cakupan sesi dengan penyelesaian yang dapat dikirimkan). Catatan alur mencerminkan satu tugas pendukungnya—status, tujuan, dan waktu—sehingga peluncuran terpisah memperoleh pegangan alur yang stabil untuk antarmuka status dan percobaan ulang tanpa pengontrol. Alur yang dicerminkan menampilkan mode sinkronisasi task_mirrored di CLI.

Status alur

State persisten dan pelacakan revisi

Catatan alur disimpan dalam basis data state SQLite bersama (~/.openclaw/state/openclaw.sqlite, tabel flow_runs) bersama catatan tugas, sehingga kemajuan tetap bertahan setelah Gateway dimulai ulang. Setiap penulisan menaikkan revision alur; penulis bersamaan yang menyertakan revisi usang akan menerima konflik dan harus membaca ulang. Pertumbuhan WAL dibatasi oleh pemeriksaan titik otomatis SQLite ditambah pemeriksaan titik pasif berkala, dengan pemeriksaan titik pemangkasan saat penghentian. Sidecar lama flows/registry.sqlite dari instalasi terdahulu diimpor oleh openclaw doctor.

Perilaku pembatalan

openclaw tasks flow cancel menetapkan niat pembatalan yang persisten pada alur, membatalkan tugas anak yang aktif, dan menolak tugas anak terkelola yang baru. Setelah tidak ada tugas anak yang masih aktif, alur diselesaikan sebagai cancelled—segera, atau melalui penyisiran pemeliharaan jika tugas anak memerlukan waktu lebih lama untuk mencapai status akhir. Niat tersebut disimpan, sehingga alur yang dibatalkan tetap dibatalkan meskipun Gateway dimulai ulang sebelum semua tugas anak dihentikan.

Perintah CLI

# List active and recent flowsopenclaw tasks flow list [--status <status>] [--json] # Show details for a specific flowopenclaw tasks flow show <lookup> [--json] # Cancel a running flow and its active tasksopenclaw tasks flow cancel <lookup>

Alur juga dicakup oleh openclaw tasks audit (temuan alur usang atau rusak) dan openclaw tasks maintenance (menyelesaikan pembatalan yang macet serta memangkas alur terminal setelah 7 hari).

Pola alur kerja terjadwal yang andal

Untuk alur kerja berulang seperti laporan intelijen pasar, perlakukan jadwal, orkestrasi, dan pemeriksaan keandalan sebagai lapisan terpisah:

1. Gunakan Tugas Terjadwal untuk pengaturan waktu.
2. Gunakan sesi Cron persisten ketika alur kerja harus melanjutkan konteks sebelumnya.
3. Gunakan Lobster untuk langkah deterministik, gerbang persetujuan, dan token pelanjutan.
4. Gunakan Alur Tugas untuk melacak proses bertahap di seluruh tugas anak, penantian, percobaan ulang, dan mulai ulang Gateway.

Contoh struktur Cron:

openclaw cron add \  --name "Market intelligence brief" \  --cron "0 7 * * 1-5" \  --tz "America/New_York" \  --session session:market-intel \  --message "Run the market-intel Lobster workflow. Verify source freshness before summarizing." \  --announce \  --channel slack \  --to "channel:C1234567890"

Gunakan --session session:<id> alih-alih isolated ketika alur kerja berulang memerlukan riwayat yang disengaja, ringkasan proses sebelumnya, atau konteks tetap. Gunakan isolated ketika setiap proses harus dimulai dari awal dan semua state yang diperlukan dinyatakan secara eksplisit dalam alur kerja.

Di dalam alur kerja, tempatkan pemeriksaan keandalan sebelum langkah ringkasan LLM:

name: market-intel-briefsteps:  - id: preflight    command: market-intel check --json  - id: collect    command: market-intel collect --json    stdin: $preflight.json  - id: summarize    command: market-intel summarize --json    stdin: $collect.json  - id: approve    command: market-intel deliver --preview    stdin: $summarize.json    approval: required  - id: deliver    command: market-intel deliver --execute    stdin: $summarize.json    condition: $approve.approved

Pemeriksaan praproses yang disarankan:

• Ketersediaan peramban dan pilihan profil, misalnya openclaw untuk state terkelola atau user ketika sesi Chrome yang sudah masuk diperlukan. Lihat Peramban.
• Kredensial API dan kuota untuk setiap sumber.
• Keterjangkauan jaringan untuk endpoint yang diperlukan.
• Alat yang diperlukan telah diaktifkan untuk agen, seperti lobster, browser, dan llm-task.
• Tujuan kegagalan telah dikonfigurasi untuk Cron agar kegagalan praproses terlihat. Lihat Tugas Terjadwal.

Kolom asal-usul data yang disarankan untuk setiap item yang dikumpulkan:

{  "sourceUrl": "https://example.com/report",  "retrievedAt": "2026-04-24T12:00:00Z",  "asOf": "2026-04-24",  "title": "Example report",  "content": "..."}

Atur alur kerja agar menolak atau menandai item usang sebelum peringkasan. Langkah LLM hanya boleh menerima JSON terstruktur dan harus diminta mempertahankan sourceUrl, retrievedAt, dan asOf dalam keluarannya. Gunakan Tugas LLM ketika Anda memerlukan langkah model yang divalidasi berdasarkan skema di dalam alur kerja.

Untuk alur kerja tim atau komunitas yang dapat digunakan kembali, kemas CLI, berkas .lobster, dan catatan penyiapan apa pun sebagai skill atau Plugin, lalu publikasikan melalui ClawHub. Simpan pembatas khusus alur kerja dalam paket tersebut, kecuali API Plugin belum menyediakan kemampuan generik yang diperlukan.

Hubungan alur dengan tugas

Alur mengoordinasikan tugas, bukan menggantikannya. Satu alur dapat menggerakkan beberapa tugas latar belakang selama masa aktifnya. Gunakan openclaw tasks untuk memeriksa setiap catatan tugas dan openclaw tasks flow untuk memeriksa alur yang mengorkestrasikannya.

Terkait

• Tugas Latar Belakang - buku besar pekerjaan terpisah yang dikoordinasikan oleh alur
• CLI: tugas - referensi perintah CLI untuk openclaw tasks flow
• Ikhtisar Otomatisasi - sekilas tentang semua mekanisme otomatisasi
• Pekerjaan Cron - pekerjaan terjadwal yang dapat memasok tugas ke dalam alur