UI Kontrol

• Chat dengan model melalui Gateway WS (chat.history, chat.send, chat.abort, chat.inject).
• Penyegaran riwayat chat meminta jendela terbaru yang dibatasi dengan batas teks per pesan sehingga sesi besar tidak memaksa browser merender payload transkrip lengkap sebelum chat dapat digunakan.
• Bicara melalui sesi realtime browser. OpenAI menggunakan WebRTC langsung, Google Live menggunakan token browser sekali pakai terbatas melalui WebSocket, dan Plugin suara realtime khusus backend menggunakan transport relay Gateway. Sesi provider milik klien dimulai dengan talk.client.create; sesi relay Gateway dimulai dengan talk.session.create. Relay menjaga kredensial provider di Gateway sementara browser melakukan streaming PCM mikrofon melalui talk.session.appendAudio, meneruskan panggilan tool provider openclaw_agent_consult melalui talk.client.toolCall untuk kebijakan Gateway dan model OpenClaw terkonfigurasi yang lebih besar, serta merutekan pengarahan suara active-run melalui talk.client.steer atau talk.session.steer.
• Streaming panggilan tool + kartu output tool langsung di Chat (peristiwa agen).
• Tab aktivitas dengan ringkasan lokal browser, redaction-first, dari aktivitas tool langsung dari pengiriman peristiwa session.tool / tool yang ada.

• Channel: status channel bawaan plus Plugin channel bundled/eksternal, login QR, dan konfigurasi per channel (channels.status, web.login.*, config.patch).
• Penyegaran probe channel mempertahankan snapshot sebelumnya tetap terlihat saat pemeriksaan provider yang lambat selesai, dan snapshot parsial diberi label saat probe atau audit melampaui anggaran UI-nya.
• Instans: daftar kehadiran + penyegaran (system-presence).
• Sesi: mencantumkan sesi agen terkonfigurasi secara bawaan, menyematkan sesi yang sering digunakan, mengganti namanya, mengarsipkan atau memulihkan sesi tidak aktif, fallback dari kunci sesi agen tidak terkonfigurasi yang basi, dan menerapkan override model/thinking/fast/verbose/trace/reasoning per sesi (sessions.list, sessions.patch). Sesi yang disematkan diurutkan di atas sesi terbaru yang tidak disematkan; sesi yang diarsipkan berada di tampilan arsip halaman Sesi dan mempertahankan transkripnya.
• Mimpi: status dreaming, toggle aktifkan/nonaktifkan, dan pembaca Dream Diary (doctor.memory.status, doctor.memory.dreamDiary, config.patch).

• Job Cron: cantumkan/tambah/edit/jalankan/aktifkan/nonaktifkan + riwayat eksekusi (cron.*).
• Skills: status, aktifkan/nonaktifkan, instal, pembaruan kunci API (skills.*).
• Node: cantumkan + kapabilitas (node.list), buat kode penyiapan seluler, dan setujui pemasangan perangkat (device.pair.*).
• Persetujuan exec: edit daftar izin gateway atau node + kebijakan tanya untuk exec host=gateway/node (exec.approvals.*).

• Lihat/edit ~/.openclaw/openclaw.json (config.get, config.set).
• MCP memiliki halaman pengaturan khusus untuk server yang dikonfigurasi, pengaktifan, ringkasan OAuth/filter/paralel, perintah operator umum, dan editor konfigurasi mcp berskala.
• Terapkan + mulai ulang dengan validasi (config.apply) dan bangunkan sesi aktif terakhir.
• Penulisan menyertakan penjaga hash dasar untuk mencegah penimpaan edit serentak.
• Penulisan (config.set/config.apply/config.patch) melakukan preflight resolusi SecretRef aktif untuk ref dalam payload konfigurasi yang dikirim; ref aktif yang dikirim dan tidak terselesaikan ditolak sebelum penulisan.
• Penyimpanan formulir membuang placeholder tersunting usang yang tidak dapat dipulihkan dari konfigurasi tersimpan sambil mempertahankan nilai tersunting yang masih dipetakan ke rahasia tersimpan.
• Skema + rendering formulir (config.schema / config.schema.lookup, termasuk field title / description, petunjuk UI yang cocok, ringkasan anak langsung, metadata docs pada node objek bersarang/wildcard/array/komposisi, plus skema plugin + channel bila tersedia); editor JSON mentah hanya tersedia ketika snapshot memiliki round-trip mentah yang aman.
• Jika sebuah snapshot tidak dapat melakukan round-trip teks mentah dengan aman, Control UI memaksa mode Formulir dan menonaktifkan mode Mentah untuk snapshot tersebut.
• Editor JSON mentah "Reset ke tersimpan" mempertahankan bentuk yang ditulis mentah (pemformatan, komentar, tata letak $include) alih-alih merender ulang snapshot yang diratakan, sehingga edit eksternal tetap bertahan setelah reset ketika snapshot dapat melakukan round-trip dengan aman.
• Nilai objek SecretRef terstruktur dirender hanya-baca dalam input teks formulir untuk mencegah kerusakan objek-menjadi-string yang tidak disengaja.

• Debug: snapshot status/kesehatan/model + log peristiwa + panggilan RPC manual (status, health, models.list).
• Log peristiwa menyertakan waktu refresh/RPC Control UI, waktu render chat/konfigurasi yang lambat, dan entri responsivitas browser untuk frame animasi panjang atau tugas panjang ketika browser mengekspos jenis entri PerformanceObserver tersebut.
• Log: tail langsung log file gateway dengan filter/ekspor (logs.tail).
• Pembaruan: jalankan pembaruan paket/git + mulai ulang (update.run) dengan laporan mulai ulang, lalu polling update.status setelah tersambung kembali untuk memverifikasi versi gateway yang berjalan.

• Untuk pekerjaan terisolasi, pengiriman defaultnya mengumumkan ringkasan. Anda dapat beralih ke tidak ada jika menginginkan run internal saja.
• Field channel/target muncul saat pengumuman dipilih.
• Mode Webhook menggunakan delivery.mode = "webhook" dengan delivery.to diatur ke URL webhook HTTP(S) yang valid.
• Untuk pekerjaan sesi utama, mode pengiriman webhook dan tidak ada tersedia.
• Kontrol edit lanjutan mencakup hapus-setelah-run, hapus override agent, opsi cron persis/tersebar, override model/thinking agent, dan toggle pengiriman best-effort.
• Validasi formulir bersifat inline dengan error tingkat field; nilai tidak valid menonaktifkan tombol simpan sampai diperbaiki.
• Atur cron.webhookToken untuk mengirim token bearer khusus; jika dihilangkan, webhook dikirim tanpa header auth.
• Fallback usang: jalankan openclaw doctor --fix untuk memigrasikan pekerjaan legacy tersimpan dengan notify: true dari cron.webhook ke webhook per-pekerjaan eksplisit atau pengiriman penyelesaian.

• chat.send bersifat non-blocking: langsung mengirim ack dengan { runId, status: "started" } dan respons mengalir melalui peristiwa chat. Klien Control UI tepercaya juga dapat menerima metadata waktu ACK opsional untuk diagnostik lokal.
• Upload chat menerima gambar plus file non-video. Gambar mempertahankan jalur gambar native; file lain disimpan sebagai media terkelola dan ditampilkan di riwayat sebagai tautan lampiran.
• Mengirim ulang dengan idempotencyKey yang sama mengembalikan { status: "in_flight" } saat berjalan, dan { status: "ok" } setelah selesai.
• Respons chat.history dibatasi ukuran demi keamanan UI. Ketika entri transkrip terlalu besar, Gateway dapat memotong field teks panjang, menghilangkan blok metadata berat, dan mengganti pesan terlalu besar dengan placeholder ([chat.history omitted: message too large]).
• Ketika pesan asisten yang terlihat dipotong di chat.history, pembaca samping dapat mengambil entri transkrip penuh yang dinormalisasi untuk tampilan sesuai permintaan melalui chat.message.get berdasarkan sessionKey, agentId aktif bila diperlukan, dan messageId transkrip. Jika Gateway masih tidak dapat mengembalikan lebih banyak, pembaca menampilkan status tidak tersedia yang eksplisit alih-alih diam-diam mengulangi pratinjau yang dipotong.
• Gambar asisten/tergenerasi dipersistenkan sebagai referensi media terkelola dan disajikan kembali melalui URL media Gateway terautentikasi, sehingga pemuatan ulang tidak bergantung pada payload gambar base64 mentah yang tetap berada dalam respons riwayat chat.
• Saat merender chat.history, Control UI menghapus tag direktif inline khusus tampilan dari teks asisten yang terlihat (misalnya [[reply_to_*]] dan [[audio_as_voice]]), payload XML panggilan tool teks biasa (termasuk <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls>, dan blok panggilan tool yang dipotong), serta token kontrol model ASCII/lebar penuh yang bocor, dan menghilangkan entri asisten yang seluruh teks terlihatnya hanya token senyap persis NO_REPLY / no_reply atau token acknowledgement heartbeat HEARTBEAT_OK.
• Selama pengiriman aktif dan refresh riwayat final, tampilan chat mempertahankan pesan pengguna/asisten optimistis lokal tetap terlihat jika chat.history sebentar mengembalikan snapshot yang lebih lama; transkrip kanonis mengganti pesan lokal tersebut setelah riwayat Gateway menyusul.
• Peristiwa chat langsung adalah status pengiriman, sedangkan chat.history dibangun ulang dari transkrip sesi tahan lama. Setelah peristiwa final-tool, Control UI memuat ulang riwayat dan hanya menggabungkan ekor optimistis kecil; batas transkrip didokumentasikan di WebChat.
• chat.inject menambahkan catatan asisten ke transkrip sesi dan menyiarkan peristiwa chat untuk pembaruan hanya-UI (tanpa run agent, tanpa pengiriman channel).
• Sidebar mencantumkan sesi terbaru dengan tindakan Sesi Baru, tautan Semua Sesi, dan tombol pencarian sesi yang membuka pemilih sesi penuh (dibatasi oleh agent yang dipilih, dengan pencarian dan paginasi). Mengganti agent hanya menampilkan sesi yang terikat ke agent tersebut dan fallback ke sesi utama agent itu ketika belum memiliki sesi dashboard tersimpan.
• Setiap baris pemilih sesi dapat mengganti nama, menyematkan, atau mengarsipkan sesi. Run aktif dan sesi utama agent tidak dapat diarsipkan. Mengarsipkan sesi yang saat ini dipilih mengalihkan Chat kembali ke sesi utama agent tersebut.
• Pada lebar desktop, kontrol chat tetap berada pada satu baris ringkas dan menciut saat menggulir turun transkrip; menggulir naik, kembali ke atas, atau mencapai bawah memulihkan kontrol.
• Pesan teks-saja duplikat berurutan dirender sebagai satu bubble dengan badge jumlah. Pesan yang membawa gambar, lampiran, output tool, atau pratinjau canvas dibiarkan tidak diciutkan.
• Pemilih model dan thinking di header chat segera menambal sesi aktif melalui sessions.patch; keduanya adalah override sesi persisten, bukan opsi kirim hanya satu giliran.
• Jika Anda mengirim pesan saat perubahan pemilih model untuk sesi yang sama masih disimpan, composer menunggu patch sesi tersebut sebelum memanggil chat.send sehingga pengiriman menggunakan model yang dipilih.
• Mengetik /new di Control UI membuat dan beralih ke sesi dashboard baru yang sama seperti Chat Baru, kecuali ketika session.dmScope: "main" dikonfigurasi dan induk saat ini adalah sesi utama agent; dalam kasus itu, perintah tersebut mereset sesi utama di tempat. Mengetik /reset mempertahankan reset di tempat eksplisit Gateway untuk sesi saat ini.
• Pemilih model chat meminta tampilan model yang dikonfigurasi Gateway. Jika agents.defaults.models ada, allowlist itu menggerakkan pemilih, termasuk entri provider/* yang menjaga katalog berskala provider tetap dinamis. Jika tidak, pemilih menampilkan entri eksplisit models.providers.*.models plus provider dengan auth yang dapat digunakan. Katalog penuh tetap tersedia melalui RPC debug models.list dengan view: "all".
• Ketika laporan penggunaan sesi Gateway yang baru menyertakan token konteks saat ini, toolbar composer chat menampilkan ring penggunaan konteks kecil dengan persentase yang digunakan; detail token lengkap ada di tooltip-nya. Ring beralih ke gaya peringatan pada tekanan konteks tinggi dan, pada level Compaction yang direkomendasikan, menampilkan tombol ringkas yang menjalankan jalur Compaction sesi normal. Snapshot token usang disembunyikan sampai Gateway melaporkan penggunaan baru lagi.

Mode bicara menggunakan provider suara realtime terdaftar. Konfigurasikan OpenAI dengan talk.realtime.provider: "openai" plus profil auth kunci API openai, talk.realtime.providers.openai.apiKey, atau OPENAI_API_KEY; profil OAuth OpenAI tidak mengonfigurasi suara Realtime. Konfigurasikan Google dengan talk.realtime.provider: "google" plus talk.realtime.providers.google.apiKey. Browser tidak pernah menerima kunci API provider standar. OpenAI menerima secret klien Realtime sementara untuk WebRTC. Google Live menerima token auth Live API terbatas sekali pakai untuk sesi WebSocket browser, dengan instruksi dan deklarasi tool dikunci ke dalam token oleh Gateway. Provider yang hanya mengekspos bridge realtime backend berjalan melalui transport relay Gateway, sehingga kredensial dan socket vendor tetap berada di sisi server sementara audio browser bergerak melalui RPC Gateway terautentikasi. Prompt sesi Realtime disusun oleh Gateway; talk.client.create tidak menerima override instruksi yang disediakan pemanggil.

Komposer Chat menyertakan tombol opsi Bicara di sebelah tombol mulai/henti Bicara. Opsi berlaku untuk sesi Bicara berikutnya dan dapat menimpa provider, transport, model, voice, reasoning effort, ambang VAD, durasi senyap, dan prefix padding. Ketika sebuah opsi kosong, Gateway menggunakan default yang dikonfigurasi jika tersedia atau default provider. Memilih Gateway relay memaksa jalur relay backend; memilih WebRTC menjaga sesi tetap dimiliki klien dan gagal alih-alih diam-diam beralih ke relay jika provider tidak dapat membuat sesi browser.

Di komposer Chat, kontrol Bicara adalah tombol gelombang di sebelah tombol dikte mikrofon. Ketika Bicara dimulai, baris status komposer menampilkan Connecting Talk..., lalu Talk live saat audio tersambung, atau Asking OpenClaw... saat panggilan alat realtime berkonsultasi dengan model lebih besar yang dikonfigurasi melalui talk.client.toolCall.

Smoke live maintainer: OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts memverifikasi jembatan WebSocket backend OpenAI, pertukaran SDP WebRTC browser OpenAI, penyiapan WebSocket browser token terbatas Google Live, dan adaptor browser relay Gateway dengan media mikrofon palsu. Perintah ini hanya mencetak status provider dan tidak mencatat secret.

• Klik Hentikan (memanggil chat.abort).
• Saat run aktif, tindak lanjut normal akan masuk antrean. Klik Arahkan pada pesan yang diantrekan untuk menyuntikkan tindak lanjut itu ke turn yang sedang berjalan.
• Ketik /stop (atau frasa pembatalan mandiri seperti stop, stop action, stop run, stop openclaw, please stop) untuk membatalkan di luar jalur.
• chat.abort mendukung { sessionKey } (tanpa runId) untuk membatalkan semua run aktif untuk sesi tersebut.

• Ketika run dibatalkan, teks asisten parsial masih dapat ditampilkan di UI.
• Gateway mempertahankan teks asisten parsial yang dibatalkan ke riwayat transkrip ketika ada output yang dibuffer.
• Entri yang dipertahankan menyertakan metadata pembatalan sehingga konsumen transkrip dapat membedakan parsial pembatalan dari output penyelesaian normal.

{  gateway: {    controlUi: { allowInsecureAuth: true },    bind: "tailnet",    auth: { mode: "token", token: "replace-me" },  },}

allowInsecureAuth hanyalah toggle kompatibilitas lokal:

• Ini memungkinkan sesi Control UI localhost berlanjut tanpa identitas perangkat dalam konteks HTTP tidak aman.
• Ini tidak melewati pemeriksaan pairing.
• Ini tidak melonggarkan persyaratan identitas perangkat remote (non-localhost).

• Auth trusted-proxy yang berhasil dapat mengizinkan sesi Control UI operator tanpa identitas perangkat.
• Ini tidak berlaku untuk sesi Control UI node-role.
• Reverse proxy loopback host yang sama tetap tidak memenuhi auth trusted-proxy; lihat Auth trusted proxy.

• gatewayUrl disimpan di localStorage setelah dimuat dan dihapus dari URL.
• Jika Anda meneruskan endpoint ws:// atau wss:// lengkap melalui gatewayUrl, encode URL nilai gatewayUrl agar browser mengurai query string dengan benar.
• token sebaiknya diteruskan melalui fragmen URL (#token=...) bila memungkinkan. Fragmen tidak dikirim ke server, sehingga menghindari kebocoran log permintaan dan Referer. Param query lama ?token= masih diimpor sekali untuk kompatibilitas, tetapi hanya sebagai fallback, dan langsung dihapus setelah bootstrap.
• password hanya disimpan di memori.
• Saat gatewayUrl diatur, UI tidak fallback ke kredensial config atau environment. Berikan token (atau password) secara eksplisit. Kredensial eksplisit yang hilang adalah error.
• Gunakan wss:// saat Gateway berada di belakang TLS (Tailscale Serve, proxy HTTPS, dll.).
• gatewayUrl hanya diterima di jendela level atas (tidak disematkan) untuk mencegah clickjacking.
• Deployment Control UI publik non-loopback harus menetapkan gateway.controlUi.allowedOrigins secara eksplisit (origin lengkap). Muatan LAN/Tailnet privat same-origin dari loopback, RFC1918/link-local, .local, .ts.net, atau host Tailscale CGNAT diterima tanpa mengaktifkan fallback header Host.
• Startup Gateway dapat mengisi origin lokal seperti http://localhost:<port> dan http://127.0.0.1:<port> dari bind dan port runtime efektif, tetapi origin browser jarak jauh tetap memerlukan entri eksplisit.
• Jangan gunakan gateway.controlUi.allowedOrigins: ["*"] kecuali untuk pengujian lokal yang dikontrol ketat. Itu berarti mengizinkan origin browser apa pun, bukan "cocokkan host apa pun yang saya gunakan."
• gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true mengaktifkan mode fallback origin header Host, tetapi ini adalah mode keamanan yang berbahaya.