Arsitektur Dasbor

​

Visi

• Papan adalah salah satu tampilan sesi, bukan objek baru. Setiap sesi (utas) memiliki dua tampilan: transkrip dan papan. Sesi tanpa widget yang disematkan adalah obrolan biasa. Sematkan satu widget dan papan pun tersedia. Papan mewarisi identitas sesi, kepemilikan agen, penamaan, penyematan, dan siklus hidup. Tidak ada dashboard_create, registri papan, ataupun model ACL terpisah.
• Kesetaraan agen. Segala hal yang dapat dilakukan pengguna pada papan, dapat dilakukan agen dengan alat: menambahkan/memperbarui/menghapus widget, mengaturnya, mengelola tab, mengganti tab yang terlihat, serta menambatkan atau menyembunyikan obrolan.
• Native, bukan tersemat. Papan terdiri dari komponen Lit dalam shell Control UI (sistem desain yang sama dengan bagian aplikasi lainnya). Hanya konten widget yang diisolasi dalam iframe. Tidak ada bilah URL atau krom peramban.
• Permukaan agen yang kecil. Widget dituju berdasarkan nama stabil dan diperbarui di tempat. Tata letaknya berupa kisi fleksibel yang memadat otomatis; agen menyatakan ukuran dan jangkar, bukan piksel atau koordinat.
• Kapabilitas, bukan kepercayaan. Kode widget adalah HTML/JS arbitrer buatan agen dalam sandbox yang ketat. Jangkauan (data Gateway, tindakan, jaringan) hanya tersedia melalui manifes kapabilitas yang dideklarasikan dan diberikan oleh operator.

​

Konsep

​

Alur UX

• Promosi: agen memanggil show_widget dalam obrolan apa pun → widget dirender sebaris dalam transkrip persis seperti saat ini → mengarahkan kursor menampilkan Sematkan ke dasbor → widget muncul pada papan sesi. Agen dapat meneruskan pin: true untuk melakukan hal yang sama.
• Tampilan papan: sesi yang memiliki papan mendapatkan pengalih tampilan (Obrolan / Dasbor). Tampilan papan = strip tab (hanya jika >1 tab) + kisi fleksibel + panel obrolan tertambat. Tambatan obrolan dapat diubah ukurannya, dipindahkan (kiri/kanan/bawah), dan diciutkan persis seperti bilah sisi. Status tambatan per tab diingat.
• Seret: pengguna menyeret widget; kisi memadat otomatis (widget mengambang ke atas, widget di sekitarnya mengalir ulang). Pengubahan ukuran melalui pegangan menyesuaikan ke tahapan ukuran. Tidak ada penempatan berdasarkan piksel — bagi siapa pun.
• Peringatan reset: /new / /reset pada sesi yang memiliki papan meminta konfirmasi di UI web (“konteks direset, dasbor tetap ada”) dan mempertahankan papan.
• Bilah sisi: sesi tersemat merender tampilan papannya jika tersedia. Papan sesi Beranda adalah “dasbor agen” default.
• Interaksi (tiga tingkat, lihat di bawah): peristiwa status senyap, pengiriman prompt yang terlihat, dan pemicu otomatisasi.

​

Tingkat interaksi

1. Peristiwa status (default). Interaksi UI widget yang perlu diketahui model tetapi tidak perlu ditanggapi. bridge.emitState({...}) menambahkan pemberitahuan sesi terstruktur (mekanisme yang sama dengan pemberitahuan aktivitas grup). Tidak ada giliran agen yang dimulai; model melihat pemberitahuan yang terakumulasi pada proses berikutnya.
2. Prompt (percakapan eksplisit). bridge.sendPrompt(text) — memerlukan aktivasi pengguna; mengirim pesan pengguna yang terlihat ke dalam sesi (obrolan tertambat menampilkannya). Dibatasi lajunya; setiap pengiriman dikonfirmasi pengguna kecuali widget memiliki pemberian kapabilitas prompt.
3. Otomatisasi. bridge.runAction(name, args) — memicu tindakan yang dideklarasikan dalam manifes. Kumpulan verba awal: cron.trigger (jalankan tugas Cron yang sudah ada sekarang) dan binding.refresh. Tugas Cron sudah berjalan dalam sesi proses terisolasi yang terlihat dan dapat menggunakan model yang lebih murah: itulah jalur “model kecil mendukung widget”. Tidak ada sesi tersembunyi di mana pun.

​

Model dan hosting widget

• Widget sebaris (transkrip) mempertahankan pipeline dokumen canvas saat ini: ditulis di bawah direktori status, dilayani oleh Gateway, dipangkas per cakupan, tanpa persetujuan (widget tersebut secara konstruksi tidak memiliki kapabilitas — pengiriman prompt dikonfirmasi pengguna).
• Widget papan adalah status sesi: bita berada di DB SQLite milik agen (board_widgets), dilayani oleh rute Gateway inti (/__openclaw__/board/<agentId>/<sessionKey>/<name>/) yang membaca DB. Menyematkan widget transkrip akan menyalin bitanya. Batas: 256 KB per widget, 48 widget per papan.
• Pembaruan di tempat: memancarkan ulang widget dengan name yang sama akan mengganti bita, menaikkan revision, menyiarkan board.changed, dan tampilan aktif hanya memuat ulang iframe tersebut.
• Pembekuan bita: kapabilitas yang diberikan terikat pada sha256 dari bita widget. Mengubah bita mempertahankan pemberian data/net/actions hanya jika revisi baru mendeklarasikan subset dari manifes yang diberikan; manifes yang diperluas akan meminta persetujuan operator kembali.

​

Widget menghosting konten; aplikasi MCP adalah salah satu jenis konten

• html — dibuat agen melalui show_widget, bita dalam penyimpanan papan.
• mcp-app — tampilan aplikasi MCP pihak ketiga (sumber daya ui:// dari server yang dikonfigurasi) yang dihosting di dalam sel widget.

• Satu host sandbox. Widget html dirender melalui pipeline tangguh yang sama dengan yang digunakan MCP Apps saat dirilis (iframe ganda pada origin sandbox khusus, CSP per widget yang dideklarasikan dan didekode dengan mekanisme gagal-tertutup), bukan melalui host iframe khusus kedua. Proksi menerima HTML berdasarkan nilai, sehingga konten lokal adalah kasus alami.
• Satu model otorisasi. Jangkauan widget adalah daftar izin yang diberikan, apa pun jenisnya: untuk widget html, alat host; untuk widget mcp-app, alat server yang terlihat oleh aplikasi (melalui mekanisme allowedAppToolNames yang sudah ada, dibuat persisten per widget alih-alih per proses pencetakan).
• Alat host untuk widget html (diekspos melalui jembatan widget, diperiksa terhadap pemberian):
  • openclaw.prompt.send — tingkat 2; dirutekan melalui komposer yang terlihat, dikonfirmasi pengguna kecuali telah diberikan
  • openclaw.state.emit — pemberitahuan sesi tingkat 1 (digabungkan, dibatasi ukurannya)
  • openclaw.data.read — pengikatan hanya-baca berparameter (kumpulan RPC baca yang sudah ada dan masuk daftar izin), diselesaikan di sisi Gateway
  • openclaw.cron.trigger — otomatisasi tingkat 3
• net = CSP. Jangkauan jaringan menggunakan deklarasi CSP per widget yang sudah dirilis (connect-src origin) — widget cuaca yang memperbarui diri mengambil API-nya langsung dari sandbox, tanpa keterlibatan Gateway.
• Pemberian. Widget yang tidak mendeklarasikan apa pun langsung dirender (tersandbox, default-src 'none', pengiriman prompt dikonfirmasi satu per satu) — tingkat kepercayaan yang sama dengan widget obrolan sebaris saat ini. Alat/origin yang dideklarasikan menempatkan widget dalam pending pada papan: kartu placeholder mencantumkannya dalam bentuk yang mudah dibaca manusia dengan sekali ketuk Izinkan/Tolak. Pemberian berlaku per nama widget; untuk widget html pemberian tersebut dibekukan berdasarkan bita (sha256), dan bita yang berubah mempertahankan pemberian hanya jika deklarasinya menyusut.
• Shim pembuatan. Pembungkus dokumen menyuntikkan window.openclaw.prompt, window.openclaw.state, window.openclaw.data, dan window.openclaw.cron sebagai API pembuat yang stabil. Panggilan dasbor berbagi satu saluran permintaan yang terikat pada tiket tampilan; pelaporan ukuran dan token tema tetap menjadi notifikasi host yang terpisah.

​

Deklarasi kapabilitas Plugin

​

Residual yang dimodelkan: saluran data WebRTC

​

Tampilan transkrip: satu kartu widget

​

Widget yang bersumber dari server (aplikasi MCP yang disematkan)

​

Integrasi WorkBoard

​

Tata letak: kisi fleksibel

• size: sm (3×3) · md (6×4) · lg (8×6) · xl (12×8) · full (tab satu widget)
• after: <widgetName> jangkar pengurutan opsional; jika dihilangkan = tambahkan di akhir
• Pengguna bebas menyeret/mengubah ukuran; model urutan+ukuran yang sama dapat dipertukarkan dua arah.

​

Model data (DB per agen)

CREATE TABLE board_tabs (
  session_key TEXT NOT NULL,
  tab_id      TEXT NOT NULL,           -- slug
  title       TEXT NOT NULL,
  position    INTEGER NOT NULL,
  chat_dock   TEXT NOT NULL DEFAULT 'right',  -- left|right|bottom|hidden
  created_by  TEXT NOT NULL,           -- 'user' | 'agent'
  PRIMARY KEY (session_key, tab_id)
) STRICT;

CREATE TABLE board_widgets (
  session_key  TEXT NOT NULL,
  name         TEXT NOT NULL,          -- stable widget name
  tab_id       TEXT NOT NULL,
  title        TEXT,
  html         BLOB NOT NULL,          -- wrapped document source
  sha256       TEXT NOT NULL,
  revision     INTEGER NOT NULL,
  size_w       INTEGER NOT NULL,
  size_h       INTEGER NOT NULL,
  position     INTEGER NOT NULL,       -- order within tab (auto-compact input)
  manifest     TEXT NOT NULL DEFAULT '{}',  -- capability manifest JSON
  grant_state  TEXT NOT NULL DEFAULT 'none', -- none|pending|granted|rejected
  granted_sha  TEXT,                   -- byte-frozen grant
  created_by   TEXT NOT NULL,
  created_at   INTEGER NOT NULL,
  updated_at   INTEGER NOT NULL,
  PRIMARY KEY (session_key, name)
) STRICT;

​

Permukaan protokol

• board.get { sessionKey } → tab + metadata widget (tanpa byte) — operator.read
• board.update { sessionKey, ops[] } — CRUD/pengurutan ulang tab, pemindahan/perubahan ukuran/ penghapusan/pelepasan sematan widget, status dock, fokus tab — operator.write
• board.widget.put { sessionKey, name, html, manifest, placement } — operator.write (jalur alat agen dan jalur penyematan)
• board.widget.grant { sessionKey, name, decision } — operator.approvals
• board.event { ticket, payload } — penerimaan peristiwa status tingkat-1 yang terikat tiket; bentuk host tepercaya warisan { sessionKey, widget, payload } tetap dipertahankan — operator.write
• board.prompt.authorize { ticket } — mengembalikan apakah pengiriman prompt yang terlihat masih memerlukan konfirmasi per klik — operator.read
• board.data.read { ticket, bindingId, params? } — resolusi binding baca inti atau plugin aktif yang masuk daftar izin di sisi gateway — operator.read
• board.action { ticket, action, ... } — pengiriman otomatisasi dengan grant yang tepat melalui jalur jalankan-sekarang cron yang sudah ada atau verba tindakan tervalidasi milik plugin aktif — operator.write

• board.changed { sessionKey, revision, widget? } — status persisten berubah; UI mengambil ulang (dan memuat ulang satu iframe saat widget tersedia).
• board.command { sessionKey, command } — pengendalian UI sementara (agen mengganti tab yang terlihat, mengalihkan dock obrolan) — pola ui.command.

​

Alat agen

• show_widget { title, widget_code, name?, pin?, size?, tab?, after?, capabilities? } — buat/perbarui berdasarkan nama; pin menempatkannya pada board. Tanpa name/pin, perilakunya persis seperti saat ini (sebaris, sementara).
• dashboard { action, ... } — verba pengelolaan board: read, tab_create, tab_update, tab_delete, tabs_reorder, widget_move, widget_remove, unpin, focus_tab, set_chat_dock.
• Alat cron yang sudah ada mencakup tingkat otomatisasi; tidak diperlukan alat baru.

​

Yang digantikan oleh ini

• extensions/workspaces dihapus. Bersifat eksperimental, enabledByDefault: false, tidak pernah ada dalam rilis stabil (pertama kali muncul dalam versi beta 2026.7.2). Tidak ada migrasi; aturan doctor menghapus <stateDir>/workspaces/ usang jika ada. Gagasan yang diambil: matematika kisi murni, model keamanan bridge (bootstrap port, pembatasan binding, batas laju), persetujuan yang dibekukan per byte.
• Hosting widget dipindahkan dari extensions/canvas ke inti. Penyimpanan dokumen canvas, pembungkus dokumen, penyajian HTTP, dan alat show_widget menjadi bagian inti (src/canvas/); plugin mempertahankan alat kontrol node-canvas (canvas) dan A2UI. Pengiklanan pluginSurfaceUrls["canvas"] dan jalur /__openclaw__/canvas merupakan kontrak klien native yang telah dirilis dan tetap stabil. Sesi Discord mempertahankan varian show_widget milik Discord.

​

Di luar sasaran (program ini)

• Berbagi board multi-pengguna/ACL (mendatang; akan hadir melalui berbagi sesi).
• Rendering board native macOS/iOS (tersedia di mana pun Control UI disematkan; jalur widget sebaris tidak berubah).
• Widget data bawaan (kartu sesi/penggunaan/cron) — bridge kapabilitas ditambah widget buatan agen mencakup v1; registri jenis bawaan dapat ditambahkan nanti.

​

Rencana implementasi