Ruang kerja

Tab Ruang Kerja di UI Kontrol adalah antarmuka yang Anda dan agen Anda tata bersama. Tab, widget, posisinya pada kisi 12 kolom, dan pengikatan datanya berada dalam satu dokumen. Apa pun yang dapat mengedit dokumen tersebut dapat menyusun ruang kerja: Anda, CLI openclaw workspaces, atau agen yang memanggil alat workspace_*.

Setiap penulisan melewati jalur tervalidasi yang sama, sehingga tata letak milik manusia dan tata letak milik agen tidak dapat menyimpang. Setiap penulisan yang diterima menaikkan versi dan menyiarkan plugin.workspaces.changed, sehingga hasil edit agen muncul di peramban yang sudah terbuka tanpa perlu memuat ulang.

Mengaktifkan Ruang Kerja

Plugin Ruang Kerja bawaan dinonaktifkan secara default. Di UI Kontrol, buka Plugin, temukan Ruang Kerja, lalu pilih Aktifkan. Anda juga dapat mengaktifkannya dari CLI:

openclaw plugins enable workspaces

Mengaktifkan plugin akan menambahkan tab Ruang Kerja serta menyediakan CLI openclaw workspaces dan alat agen workspace_*. Menonaktifkannya akan menghapus antarmuka tersebut tanpa menghapus basis data ruang kerja atau aset widget.

Ruang kerja default

Saat pertama kali dimuat, Anda akan mendapatkan ruang kerja Ikhtisar: kartu biaya dan token, kesehatan instans, sesi, status cron, dan umpan aktivitas. Ini merupakan konten ruang kerja biasa — seret, ciutkan, sembunyikan, atau hapus.

Widget bawaan

Sembilan widget tepercaya disertakan bersama plugin dan dirender sebagai UI pihak pertama:

stat-card, markdown, table, iframe-embed, sessions, usage, cron, instances, activity.

Widget mendeklarasikan data melalui pengikatan; widget tidak pernah mengambil data sendiri:

Pengikatan file adalah cara paling sederhana untuk memasukkan angka Anda sendiri ke ruang kerja: tulis berkas JSON ke direktori data dan arahkan stat-card ke berkas tersebut.

Asal-usul

Tab dan widget membawa stempel createdBy — user, system, atau agent:<id> — yang ditetapkan berdasarkan pihak yang melakukan penulisan. Nilai ini tidak dapat diberikan oleh pemanggil, sehingga agen tidak dapat melabeli pekerjaannya sebagai milik Anda, dan cip "AI" pada widget buatan agen selalu benar-benar menunjukkan asalnya.

Widget khusus

Agen dapat membuat widget HTML sungguhan dengan workspace_widget_scaffold (atau Anda dapat membuatnya dengan openclaw workspaces widget-scaffold <name>). Kode buatan agen diperlakukan sebagai kode berbahaya:

• Widget yang dibuat melalui scaffold masuk ke registri dengan status tertunda. Tidak ada iframe yang dibuat, dan rute aset mengembalikan 404 untuk berkasnya hingga operator menyetujuinya.
• Persetujuan merupakan keputusan terpisah dari pengeditan tata letak: workspaces.widget.approve memerlukan cakupan operator.approvals, yaitu cakupan yang sama yang melindungi persetujuan eksekusi.
• Widget yang disetujui dirender dalam <iframe sandbox="allow-scripts"> — tidak pernah menggunakan allow-same-origin — sehingga origin-nya tidak transparan dan widget tidak dapat mengakses DOM, penyimpanan, atau kuki induknya.
• Asetnya disajikan dengan connect-src 'none', yang memblokir jaringan skrip seperti fetch, XHR, dan WebSocket. Widget tidak memiliki kredensial dan tidak pernah berkomunikasi dengan gateway.
• Data hanya diteruskan kepadanya melalui jembatan postMessage berversi. Kode khusus dapat menerima pengikatan static yang dideklarasikan, yaitu nilai ruang kerja yang telah dibuat oleh agen atau operator. Pengikatan RPC dan berkas tetap berada dalam widget bawaan tepercaya: peramban mengizinkan turunan dalam sandbox menavigasi frame-nya sendiri, sehingga data berhak istimewa tidak pernah dikirim ke HTML buatan agen.

Mengirim perintah ke obrolan dari widget juga memerlukan kapabilitas manifes, konfirmasi untuk setiap pemanggilan yang mengutip teks persisnya, dan tunduk pada batas laju.

CLI

openclaw workspaces tabs listopenclaw workspaces tabs create --title Financialsopenclaw workspaces widget-scaffold revenue-chart --title "Revenue Chart"openclaw workspaces widget-approve revenue-chart

widget-approve memerlukan perangkat yang dipasangkan dengan cakupan operator.approvals; persetujuan dari UI Kontrol tidak memerlukannya karena peramban sudah memiliki cakupan tersebut.

Penyimpanan

Dokumen ruang kerja, registri widget khusus, dan cincin pembatalan berisi 20 entri berada di <stateDir>/workspaces/workspaces.sqlite. Aset widget buatan agen tetap berada di disk dalam <stateDir>/workspaces/widgets/<name>/, sedangkan data pengikatan berkas berada di <stateDir>/workspaces/data/, karena agen membuatnya dengan alat berkas biasa dan rute widget menyajikan byte-nya.