Mengaktifkannya
Workboard disertakan tetapi dinonaktifkan secara default:- Buka Plugin di UI Kontrol, atau gunakan
/settings/pluginsrelatif terhadap jalur dasar UI Kontrol yang dikonfigurasi. Misalnya, jalur dasar/openclawmenggunakan/openclaw/settings/plugins. - Temukan Workboard dan pilih Aktifkan. Karena Workboard disertakan bersama OpenClaw, tindakan Instal tidak diperlukan.
- Jika UI melaporkan bahwa mulai ulang diperlukan, mulai ulang Gateway.
/workboard secara langsung saat plugin dinonaktifkan atau diblokir oleh
plugins.allow/plugins.deny menampilkan status plugin tidak tersedia, bukan data
kartu.
Alur kerja CLI yang setara adalah:
Konfigurasi
Workboard tidak memiliki konfigurasi khusus plugin. Aktifkan/nonaktifkan dengan entri plugin standar:Bidang kartu
Kartu juga memuat metadata ringkas untuk percobaan, komentar, tautan, bukti,
artefak, pengaturan otomatisasi, lampiran, log pekerja, status protokol
pekerja, klaim, diagnostik, notifikasi, id templat, status arsip, dan
deteksi sesi kedaluwarsa, serta daftar peristiwa terbaru (
created, edited,
moved, linked, specified, decomposed, claimed, heartbeat,
execution_updated, attempt_started, attempt_updated, comment_added,
link_added, proof_added, artifact_added, attachment_added,
diagnostic, notification, dispatch, orchestration,
protocol_violation, archived, unarchived, stale). Metadata ini memungkinkan
operator melihat bagaimana kartu berpindah melalui papan tanpa membuka sesi
tertaut; metadata tersebut merupakan konteks operasional lokal, bukan pengganti transkrip
sesi atau riwayat isu GitHub.
Plugin dan UI Kontrol menggunakan satu kontrak kartu Workboard. Oleh karena itu, penyegaran dasbor
mempertahankan asal-usul dan otoritas ruang kerja, status klaim, tindakan
diagnostik, serta nomor urut notifikasi, alih-alih memproyeksikan salinan kartu
khusus UI yang lebih kecil. Jenis diagnostik, tingkat keparahan diagnostik, dan
jenis notifikasi yang tidak dikenal diabaikan hingga kedua permukaan mendukungnya; semuanya tidak pernah
ditulis ulang menjadi status valid lainnya.
Dasbor yang terbuka diperbarui dari invalidasi plugin.workboard.changed. Setiap
peristiwa hanya berisi epoch dan revisi penyimpanan; UI kemudian membaca ulang kartu
kanonis melalui RPC operator.read normal. Beberapa revisi digabungkan menjadi
satu pembacaan lanjutan. Workboard menunda pembacaan tersebut saat kartu sedang diseret,
diedit, atau ditulis, lalu melanjutkannya setelah interaksi lokal selesai. Setiap
penyambungan ulang selalu melakukan pemuatan ulang kanonis. Tidak ada jajak pendapat rutin terhadap seluruh
kartu, dan Segarkan tetap tersedia sebagai pemulihan manual.
Jika terdapat lebih dari satu papan, bilah alat menyertakan filter Papan yang didukung
oleh metadata papan tersimpan, bukan hanya kartu yang sedang terlihat. Oleh karena itu, papan kosong
dan yang diarsipkan tetap dapat dipilih. Kartu tanpa id papan eksplisit
termasuk dalam papan kanonis default. Papan yang dipilih disimpan
dalam parameter kueri ?board=, sehingga URL Workboard yang difilter dapat ditandai
atau dibagikan; memilih Semua papan akan menghapus parameter tersebut.
Kartu disimpan dalam status Gateway milik plugin dan berpindah bersama
status OpenClaw lainnya milik Gateway tersebut (lihat Penyimpanan).
Memulai pekerjaan dari kartu
Kartu yang tidak tertaut dapat langsung memulai pekerjaan:- Jalankan Codex / Jalankan Claude memulai proses agen yang dilacak sebagai tugas dengan
mesin eksplisit, mengirim prompt kartu, dan menandai kartu sebagai
running. Proses Codex menggunakanopenai/gpt-5.6-sol; proses Claude menggunakananthropic/claude-sonnet-4-6. - Buka Codex / Buka Claude membuat sesi dasbor tertaut tanpa mengirim prompt kartu atau memindahkan kartu, untuk pekerjaan manual yang tetap terhubung ke papan.
review atau blocked menggunakan aturan sinkronisasi
yang sama seperti sesi tertaut (lihat Sinkronisasi siklus hidup sesi).
Alat agen
Status bukti merupakan hasil yang dilaporkan pekerja, bukan verifikasi independen. Entri
passed
berarti pekerja melaporkan bahwa perintah atau pemeriksaannya berhasil; konsumen yang memerlukan
gerbang kualitas independen harus memeriksa perintah, URL, atau artefak terlampir dan
menjalankan pemverifikasi mereka sendiri. workboard_proof mengembalikan proofId milik catatan baru. Ketika
workboard_complete melaporkan status terminal bukti yang sama, teruskan proofId agar
catatan tertunda diselesaikan di tempat tanpa kehilangan identitas atau stempel waktunya. Bukti yang
sudah memiliki status terminal yang sama digunakan kembali tanpa perubahan. Bukti penyelesaian tanpa
proofId tetap hanya dapat ditambahkan, sehingga percobaan ulang berikutnya tidak dapat menulis ulang riwayat lama hanya karena
perintah atau catatannya identik.
Kartu yang diklaim menolak mutasi alat agen dari agen lain kecuali pemanggil
memegang token klaim yang dikembalikan oleh workboard_claim. Setiap kartu yang dikembalikan oleh
alat agen atau panggilan RPC Gateway menyamarkan metadata.claim.token menjadi [redacted]
(token itu sendiri dikembalikan satu kali, pada tingkat teratas, hanya dari workboard_claim),
sehingga operator dasbor dan agen lain dapat memeriksa status klaim tanpa pernah
melihat token yang dapat digunakan. Pemulihan dilakukan melalui
workboard_promote/workboard_reassign/workboard_reclaim, yang tidak
memerlukan token.
Pengiriman
Pengiriman bersifat lokal pada Gateway: pengiriman tidak membuat proses OS arbitrer. Sesi subagen OpenClaw normal tetap memiliki eksekusi. Satu putaran pengiriman:- Mempromosikan kartu yang dependensinya siap.
- Mencatat metadata pengiriman pada kartu yang siap.
- Memblokir klaim yang kedaluwarsa atau proses yang kehabisan waktu.
- Menandai kartu triase yang dikonfigurasi papan sebagai kandidat orkestrasi.
- Mengklaim sejumlah kecil kartu yang siap dan memulai proses pekerja melalui runtime subagen Gateway.
operator.write dapat menggunakan ruang kerja agen yang dikonfigurasi;
klien operator.admin dapat menggunakan checkout host lainnya. Alat agen dalam sandbox menggunakan
akses ruang kerja sandbox-nya, sedangkan alat khusus ruang kerja tanpa sandbox menggunakan
root ruang kerja yang dikonfigurasi. Workboard mencatat otoritas tersebut ketika ruang kerja
ditetapkan dan mengiriskannya kembali dengan otoritas pemanggil saat ini ketika dikirimkan,
sehingga kartu yang tersimpan tidak dapat memperluas akses pemanggil berikutnya. Kartu lama dengan
ruang kerja host eksplisit tetapi tanpa otoritas yang tercatat harus menyimpan ulang ruang kerja tersebut
sebelum pengiriman host penuh; kartu tanpa jalur host mengadopsi
otoritas pemanggil saat ini ketika pertama kali dikirimkan.
Pengiriman yang terikat ruang kerja hanya menerima direktori atau checkout Git jika
root repositorinya sama persis dengan ruang kerja agen target. Permintaan worktree
dipersempit ke direktori tersebut dan disimpan sebagai ruang kerja direktori, sehingga
host tidak mewujudkan checkout atau menjalankan kode penyiapan repositori. Pekerja
target harus menggunakan sandbox Docker yang dapat ditulisi dan tidak digunakan bersama untuk ruang kerja
yang sama persis tersebut, tanpa eksekusi dengan hak akses tinggi, pengesampingan eksekusi host/node yang tersimpan, atau
alat plugin dan MCP yang belum diklasifikasikan. Workboard menghitung alat terdaftarnya
alih-alih memercayai prefiks workboard_*, dan pengiriman menolak kontainer Docker
aktif yang hash mount/konfigurasi langsungnya sudah usang. Pengiriman melaporkan
kebijakan target yang tidak kompatibel alih-alih memulai pekerja dengan pembatasan yang lebih longgar.
Pengiriman host penuh dapat menargetkan checkout lokal lain dan mempertahankan penyiapan
worktree terkelola normal.
Otoritas ruang kerja tidak membuat model izin siklus hidup kartu kedua.
Pemanggil yang dapat memutasi kartu Workboard dapat memindahkannya secara manual melalui status
yang sama pada setiap permukaan; akses ruang kerja hanya-baca hanya mencegah pengiriman
pekerja yang memerlukan akses tulis.
Pemilihan pekerja
Setiap putaran memulai paling banyak 3 worker secara default. Kartu siap diurutkan berdasarkan prioritas, lalu posisi, lalu waktu pembuatan. Satu putaran hanya memulai satu kartu per pemilik/agen dan melewati pemilik yang sudah memiliki pekerjaan yang sedang berjalan atau dalam review di papan. Kartu yang diarsipkan, kartu dengan klaim aktif, dan kartu yang tidak berstatusready
tidak pernah dipilih untuk memulai worker (kartu tersebut masih dapat dipengaruhi oleh
sisi data dari dispatch: pembersihan klaim kedaluwarsa, promosi dependensi, pembersihan
batas waktu).
Kunci sesi bersifat deterministik per papan/kartu, sehingga dispatch berulang diarahkan
kembali ke jalur worker yang sama alih-alih membuat sesi yang tidak terkait:
- Kartu yang ditetapkan:
agent:<agentId>:subagent:workboard-<boardId>-<cardId> - Kartu yang belum ditetapkan:
subagent:workboard-<boardId>-<cardId>(Gateway menentukan agen default yang dikonfigurasi)
Titik masuk
- Tindakan dispatch dasbor
openclaw workboard dispatch/workboard dispatchpada kanal yang mendukung perintah
unknown method untuk Gateway
lama), serta tidak ada target eksplisit --url/--token dan tidak ada Gateway jarak jauh
yang dikonfigurasi (OPENCLAW_GATEWAY_URL atau gateway.mode: remote) yang berlaku, CLI menjalankan
dispatch khusus data terhadap status SQLite lokal—dispatch ini dapat mempromosikan dependensi,
membersihkan klaim kedaluwarsa, dan memblokir eksekusi yang melampaui batas waktu, tetapi tidak dapat memulai worker. Kegagalan autentikasi,
izin, dan validasi dari Gateway yang dapat dijangkau tidak dianggap
sebagai tidak tersedia; kegagalan tersebut ditampilkan sebagai galat perintah, demikian pula setiap kegagalan Gateway
ketika target eksplisit --url/--token diberikan.
Metadata papan dapat menetapkan autoDecompose, autoDecomposePerDispatch,
defaultAssignee, dan orchestratorProfile. OpenClaw mencatat maksud ini dan
menampilkannya dalam konteks worker; spesifikasi/dekomposisi aktual tetap berjalan
melalui alat Workboard normal.
CLI dan perintah garis miring
list menyembunyikan kartu yang diarsipkan secara default (--include-archived
mengesampingkannya); --json selalu menyertakan kartu yang diarsipkan, sesuai dengan kontrak kartu lengkap
yang digunakan oleh skrip yang ada. show dan move menerima prefiks id yang tidak ambigu.
list, create, show, dan move selalu membaca/menulis status Plugin lokal
secara langsung. Hanya dispatch yang memanggil Gateway yang sedang berjalan, dengan fallback
yang dijelaskan di atas.
Lihat CLI Workboard untuk flag lengkap, keluaran JSON, perilaku fallback
Gateway, penanganan prefiks id, aturan pemilihan dispatch, dan
pemecahan masalah.
/workboard list, /workboard show <card-id>, /workboard create <title>,
/workboard move <card-id> --status <status>, dan /workboard dispatch mencerminkan
CLI. Daftar dan tampilkan adalah operasi baca untuk setiap pengirim perintah yang berwenang.
Buat, pindahkan, dan dispatch memerlukan status pemilik pada permukaan chat, atau klien Gateway
dengan operator.write/operator.admin. Pemindahan operator manual menggunakan
perilaku pengesampingan klaim yang sama seperti seret dan lepas pada dasbor. Akses worktree-nya
tetap mengikuti batas ruang kerja yang sama seperti dijelaskan di atas.
Sinkronisasi siklus hidup sesi
Kartu dapat ditautkan ke sesi dasbor yang ada, atau sesi yang dibuat ketika Anda memulai pekerjaan dari kartu. Kartu tertaut menampilkan siklus hidup sesi secara langsung: berjalan, kedaluwarsa, tertaut tetapi menganggur, selesai, gagal, atau hilang. Anda juga dapat mengambil sesi yang ada dari tab Sessions dengan Add to Workboard; kartu ditautkan ke sesi tersebut, menggunakan label sesi atau prompt pengguna terbaru sebagai judul, dan mengisi awal catatan dari prompt pengguna terbaru serta respons asisten terkini jika tersedia. Jika sesi tertaut hilang, kartu tetap tertaut untuk konteks dan tetap menawarkan kontrol mulai untuk memulai ulang ke sesi baru. Jika sesi tertaut yang aktif berhenti melaporkan aktivitas terbaru, Workboard menandai kartu sebagaistale dan menyimpannya sebagai metadata hingga siklus hidup menghapusnya.
Saat kartu berada dalam status pekerjaan aktif, Workboard mengikuti sesi tertaut:
Status review manual diprioritaskan. Memindahkan kartu ke
review, blocked, atau done
menghentikan sinkronisasi otomatis untuk kartu tersebut hingga Anda memindahkannya kembali ke todo atau running.
Memulai kartu menggunakan sesi Gateway normal; Workboard hanya menyimpan
metadata dan tautan kartu. Transkrip percakapan, pemilihan model, dan siklus hidup
eksekusi tetap dikelola oleh sistem sesi reguler. Gunakan Stop pada kartu tertaut
yang aktif untuk membatalkan eksekusi aktif—Workboard menandai kartu tersebut sebagai blocked agar
tetap terlihat untuk tindak lanjut.
Kartu baru dapat dimulai dari templat Workboard (bugfix, docs, release,
pr_review, plugin). Templat mengisi awal judul, catatan, label, dan prioritas;
id templat disimpan sebagai metadata kartu.
Alur kerja dasbor
- Buka tab Workboard di Control UI.
- Buat kartu dengan judul, catatan, prioritas, label, agen opsional, dan sesi tertaut opsional—atau buka Sessions dan pilih Add to Workboard untuk sesi yang ada.
- Seret kartu di antara kolom, atau fokuskan kontrol status ringkasnya dan gunakan menu atau ArrowLeft/ArrowRight. Selama penyeretan, kartu sumber meredup dan kolom tujuan yang tersedia mendapatkan garis luar.
- Mulai pekerjaan dari kartu untuk membuat atau menggunakan kembali sesi dasbor.
- Buka sesi tertaut dari kartu saat agen bekerja.
- Biarkan sinkronisasi siklus hidup memindahkan pekerjaan yang sedang berjalan ke
review/blocked, lalu secara manual pindahkan kartu kedonesetelah diterima.
Diagnostik
Diagnostik dihitung dari metadata kartu lokal. Pemeriksaan bawaan menandai:Izin
Metode RPC Gateway berada di bawahworkboard.*:
Tidak ada metode RPC yang memerlukan
operator.admin. Browser yang terhubung dengan akses
operator hanya-baca dapat memeriksa papan tetapi tidak dapat mengubah kartu. Cakupan admin
memperluas jalur host Workboard yang diterima; cakupan ini tidak mengubah metode yang tersedia.
Penyimpanan
Workboard menyimpan data persisten dalam basis data SQLite relasional milik Plugin di bawah direktori status OpenClaw: papan, kartu, label, peristiwa siklus hidup, upaya eksekusi, komentar, tautan dependensi, bukti, referensi artefak, metadata dan blob lampiran, diagnostik, notifikasi, log worker, status protokol, dan langganan semuanya berada di tabel Workboard (bukan entri nilai-kunci Plugin). Ekspor kartu mempertahankan narasi papan tanpa menyematkan isi blob lampiran. Instalasi yang menggunakan Workboard dalam rilis.28 dapat menjalankan
openclaw doctor --fix untuk memigrasikan namespace status Plugin lama yang telah dirilis
(workboard.cards, workboard.boards, workboard.notify, dan, jika ada,
workboard.attachments) ke basis data relasional.
Pemecahan masalah
Tab menyatakan Workboard tidak tersediaplugins.allow dikonfigurasi, tambahkan workboard ke dalamnya. Jika plugins.deny
berisi workboard, hapus sebelum mengaktifkan Plugin.
Kartu tidak tersimpan
Pastikan koneksi browser memiliki akses operator.write. Sesi operator
hanya-baca dapat mencantumkan kartu tetapi tidak dapat membuat, mengedit, memindahkan, atau menghapusnya.
Memulai kartu tidak membuka sesi yang diharapkan
Periksa id agen dan sesi tertaut kartu, lalu buka Sessions atau Chat untuk
memeriksa status eksekusi yang sebenarnya.
Dispatch tidak memulai worker
Pastikan ada setidaknya satu kartu ready tanpa klaim aktif: