CLI commands

`openclaw tasks`

Periksa tugas latar belakang persisten dan status Task Flow. Tanpa subperintah, openclaw tasks setara dengan openclaw tasks list.

Lihat Tugas Latar Belakang untuk siklus hidup dan model pengiriman.

Penggunaan

bash

openclaw tasksopenclaw tasks listopenclaw tasks list --runtime acpopenclaw tasks list --status runningopenclaw tasks show <lookup>openclaw tasks notify <lookup> state_changesopenclaw tasks cancel <lookup>openclaw tasks auditopenclaw tasks maintenanceopenclaw tasks maintenance --applyopenclaw tasks flow listopenclaw tasks flow show <lookup>openclaw tasks flow cancel <lookup>

Opsi Root

--json: keluarkan JSON.
--runtime <name>: filter menurut jenis: subagent, acp, cron, atau cli.
--status <name>: filter menurut status: queued, running, succeeded, failed, timed_out, cancelled, atau lost.

Subperintah

`list`

bash

openclaw tasks list [--runtime <name>] [--status <name>] [--json]

Mencantumkan tugas latar belakang yang dilacak, yang terbaru lebih dulu.

`show`

bash

openclaw tasks show <lookup> [--json]

Menampilkan satu tugas berdasarkan ID tugas, ID eksekusi, atau kunci sesi.

`notify`

bash

openclaw tasks notify <lookup> <done_only|state_changes|silent>

Mengubah kebijakan notifikasi untuk tugas yang sedang berjalan.

`cancel`

bash

openclaw tasks cancel <lookup>

Membatalkan tugas latar belakang yang sedang berjalan.

`audit`

bash

openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]

Memunculkan catatan tugas dan Task Flow yang basi, hilang, gagal dikirim, atau tidak konsisten. Tugas hilang yang dipertahankan hingga cleanupAfter adalah peringatan; tugas hilang yang kedaluwarsa atau tidak diberi stempel adalah kesalahan.

`maintenance`

bash

openclaw tasks maintenance [--apply] [--json]

Mempratinjau atau menerapkan rekonsiliasi tugas dan Task Flow, pemberian stempel pembersihan, pemangkasan, dan pembersihan registri sesi eksekusi cron yang basi. Untuk tugas cron, rekonsiliasi menggunakan log eksekusi/status pekerjaan yang dipersistenkan sebelum menandai tugas aktif lama sebagai lost, sehingga eksekusi cron yang selesai tidak menjadi kesalahan audit palsu hanya karena status runtime Gateway di memori sudah hilang. Audit CLI offline tidak otoritatif untuk kumpulan pekerjaan aktif cron lokal-proses milik Gateway. Tugas CLI dengan ID eksekusi/ID sumber ditandai lost saat konteks eksekusi Gateway langsungnya hilang, meskipun baris sesi anak lama masih ada. Saat diterapkan, pemeliharaan juga memangkas baris registri sesi cron:<jobId>:run:<uuid> yang lebih lama dari 7 hari sambil mempertahankan pekerjaan cron yang sedang berjalan dan membiarkan baris sesi non-cron tidak tersentuh.

`flow`

bash

openclaw tasks flow list [--status <name>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>

Memeriksa atau membatalkan status Task Flow persisten di bawah ledger tugas.

Terkait

Was this useful?