Skip to main content
Gateway menyajikan UI Kontrol peramban kecil (Vite + Lit) dari port yang sama dengan WebSocket Gateway:
  • bawaan: http://<host>:18789/
  • dengan gateway.tls.enabled: true: https://<host>:18789/
  • prefiks opsional: atur gateway.controlUi.basePath (misalnya /openclaw)
Kapabilitas dijelaskan di UI Kontrol. Halaman ini membahas mode pengikatan, keamanan, dan permukaan lain yang dapat diakses melalui web.

​
Konfigurasi (aktif secara bawaan)

UI Kontrol diaktifkan secara bawaan saat aset tersedia (dist/control-ui):

​
Webhook

Saat hooks.enabled=true, Gateway juga mengekspos titik akhir webhook pada server HTTP yang sama. Lihat hooks di referensi konfigurasi Gateway untuk autentikasi dan muatan.

​
RPC HTTP admin

POST /api/v1/admin/rpc mengekspos metode bidang kontrol Gateway tertentu melalui HTTP. Dinonaktifkan secara bawaan; hanya didaftarkan saat plugin admin-http-rpc diaktifkan. Lihat RPC HTTP Admin untuk model autentikasi, metode yang diizinkan, dan perbandingannya dengan API WebSocket.

​
Akses Tailscale

Pertahankan Gateway pada local loopback dan biarkan Tailscale Serve memproksikannya:
Mulai Gateway:
Buka https://<magicdns>/ (atau gateway.controlUi.basePath yang telah Anda konfigurasikan).

​
Catatan keamanan

  • Autentikasi Gateway diwajibkan secara bawaan: token, kata sandi, proksi tepercaya, atau header identitas Tailscale Serve saat diaktifkan.
  • Pengikatan non-loopback tetap memerlukan autentikasi Gateway: autentikasi token/kata sandi atau proksi balik sadar identitas dengan gateway.auth.mode: "trusted-proxy".
  • Wisaya orientasi awal membuat autentikasi rahasia bersama secara bawaan dan biasanya menghasilkan token Gateway, bahkan pada local loopback.
  • Dalam mode rahasia bersama, UI mengirimkan connect.params.auth.token atau connect.params.auth.password selama jabat tangan WebSocket.
  • Dengan gateway.tls.enabled: true, pembantu dasbor/status lokal merender URL https:// dan URL WebSocket wss://.
  • Dalam mode yang membawa identitas (Tailscale Serve, trusted-proxy), pemeriksaan autentikasi WebSocket dipenuhi dari header permintaan, bukan dari rahasia bersama.
  • Untuk penerapan UI Kontrol non-loopback publik, atur gateway.controlUi.allowedOrigins secara eksplisit (origin lengkap). Pemuatan privat dengan origin yang sama diterima tanpa pengaturan tersebut untuk local loopback, RFC1918/link-local, .local, .ts.net, dan host CGNAT Tailscale.
  • gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback: true mengaktifkan fallback origin header Host; ini merupakan penurunan tingkat keamanan yang berbahaya.
  • Dengan Serve, header identitas Tailscale memenuhi autentikasi UI Kontrol/WebSocket saat gateway.auth.allowTailscale: true (token/kata sandi tidak diperlukan). Titik akhir API HTTP tidak menggunakan header identitas Tailscale; titik akhir tersebut selalu mengikuti mode autentikasi HTTP normal Gateway. Atur gateway.auth.allowTailscale: false untuk mewajibkan kredensial eksplisit bahkan melalui Serve. Alur tanpa token ini mengasumsikan host Gateway itu sendiri tepercaya. Lihat Tailscale dan Keamanan.

​
Membangun UI

Gateway menyajikan berkas statis dari dist/control-ui: