openclaw workboard adalah permukaan terminal untuk Plugin Workboard
bawaan. Perintah ini memungkinkan operator mencantumkan kartu, membuat kartu,
memeriksa satu kartu, dan meminta Gateway yang sedang berjalan untuk
mengirimkan pekerjaan siap ke run pekerja subagen.
Aktifkan Plugin sebelum menggunakan perintah:
Penggunaan
list
| Flag | Tujuan |
|---|---|
--board <id> | Batasi hasil ke satu namespace board |
--status <status> | Batasi hasil ke satu status Workboard |
--include-archived | Sertakan kartu yang diarsipkan dalam output ringkas |
--json | Cetak daftar kartu lengkap sebagai JSON mesin |
/workboard list. Teruskan --include-archived untuk
menampilkannya. Output JSON mempertahankan daftar kartu lengkap, termasuk kartu
yang diarsipkan, untuk otomatisasi yang sudah ada.
create
| Flag | Tujuan |
|---|---|
--notes <text> | Catatan awal kartu |
--status <status> | Status awal, default todo |
--priority <priority> | Prioritas, default normal |
--agent <id> | Tetapkan kartu ke agen atau id pemilik |
--board <id> | Simpan kartu pada namespace board |
--labels <items> | Label yang dipisahkan koma |
--json | Cetak kartu yang dibuat sebagai JSON mesin |
create menulis langsung ke status SQLite Workboard. Kartu langsung terlihat di
tab Workboard Control UI dan bagi alat Workboard.
show
dispatch
dispatch terlebih dahulu memanggil metode RPC Gateway yang sedang berjalan
workboard.cards.dispatch. Jalur tersebut menggunakan runtime subagen yang sama
seperti tindakan dispatch dasbor, sehingga kartu siap menjadi run pekerja yang
dilacak tugas dengan kunci sesi tertaut. Kartu dengan agen yang ditetapkan
menggunakan kunci sesi subagen bercakupan agen; kartu tanpa penetapan
mempertahankan kunci subagen tanpa cakupan sehingga agen default yang
dikonfigurasi Gateway tetap dipertahankan.
Loop dispatch:
- Mempromosikan turunan yang dependensinya siap menjadi
ready. - Memblokir klaim yang kedaluwarsa atau run pekerja yang timeout.
- Merekam metadata dispatch pada kartu siap.
- Memilih batch kecil kartu siap yang belum diklaim.
- Mengklaim setiap kartu yang dipilih untuk dispatcher atau agen yang ditetapkan.
- Memulai run pekerja subagen dengan konteks kartu terbatas dan token klaim kartu.
- Menyimpan id run pekerja, kunci sesi, penautan tugas saat ledger tugas Gateway melaporkannya, status eksekusi, dan log pekerja pada kartu.
--url atau --token eksplisit dilaporkan secara
langsung.
Output teks melaporkan start pekerja:
started dan startFailures; fallback khusus data menyertakan
gatewayUnavailable: true. Token klaim disamarkan dari output JSON kartu.
Di dasbor, hasil dispatch yang sama ditampilkan sebagai ringkasan pendek sehingga
operator dapat melihat berapa banyak kartu yang dimulai, dipromosikan, diblokir,
direklaim, atau gagal tanpa membuka detail kartu.
Kesetaraan Perintah Slash
Channel yang mendukung perintah dapat menggunakan perintah slash yang sesuai:/workboard list dan /workboard show adalah perintah baca untuk pengirim
perintah yang berwenang. /workboard create dan /workboard dispatch mengubah
status board dan memerlukan status pemilik pada permukaan chat atau klien Gateway
dengan operator.write atau operator.admin.
Izin
Jalur dispatch CLI memanggil RPC Gateway dengan cakupanoperator.read dan
operator.write. Token Gateway hanya-baca dapat memeriksa data Workboard melalui
metode baca, tetapi tidak dapat membuat kartu atau mengirimkan pekerja.
Perintah lokal list, create, dan show beroperasi pada direktori status
OpenClaw lokal yang digunakan oleh profil saat ini. Gunakan --dev atau
--profile <name> pada perintah openclaw tingkat atas saat Anda memerlukan
root status yang berbeda.
Pemecahan Masalah
Tidak Ada Kartu yang Muncul
Pastikan Plugin diaktifkan untuk profil dan root status yang sama:--dev atau --profile yang sama.
Dispatch Mengatakan Khusus Data
Mulai atau mulai ulang Gateway:openclaw workboard dispatch. Fallback khusus data berguna untuk
pembersihan status lokal, tetapi run pekerja memerlukan Gateway yang aktif.
Dispatch Tidak Memulai Apa Pun
Periksa setidaknya ada satu kartuready tanpa klaim aktif:
done,
lepaskan klaim usang melalui alat Workboard, atau jalankan dispatch lagi setelah
pekerja aktif selesai.