Dashboard (Control UI)

Gateway dashboard là giao diện Control UI chạy trên trình duyệt, mặc định được phục vụ tại / (có thể thay đổi bằng gateway.controlUi.basePath).

Mở nhanh (Gateway local):

Tài liệu tham khảo:

  • Control UI để xem cách sử dụng và các tính năng giao diện.
  • Tailscale để tự động hóa Serve/Funnel.
  • Web surfaces để xem các chế độ bind và lưu ý bảo mật.

Xác thực được thực thi tại bước bắt tay WebSocket thông qua connect.params.auth (token hoặc password). Xem gateway.auth trong cấu hình Gateway.

Lưu ý bảo mật: Control UI là giao diện quản trị (chat, config, phê duyệt exec). Không nên expose công khai. Giao diện sẽ lưu token vào localStorage sau lần tải đầu tiên. Nên dùng localhost, Tailscale Serve, hoặc SSH tunnel.

Cách nhanh nhất (khuyên dùng)

  • Sau khi onboarding, CLI sẽ tự động mở dashboard với token của các bạn và in ra link có token.
  • Mở lại bất cứ lúc nào: openclaw dashboard (copy link, mở trình duyệt nếu có thể, hiện gợi ý SSH nếu chạy headless).
  • Token chỉ ở local (query param); giao diện sẽ xóa nó sau lần tải đầu và lưu vào localStorage.

Token cơ bản (local vs remote)

  • Localhost: mở http://127.0.0.1:18789/. Nếu thấy “unauthorized”, chạy openclaw dashboard và dùng link có token (?token=...).
  • Nguồn token: gateway.auth.token (hoặc OPENCLAW_GATEWAY_TOKEN); giao diện sẽ lưu nó sau lần tải đầu.
  • Không phải localhost: dùng Tailscale Serve (không cần token nếu gateway.auth.allowTailscale: true), tailnet bind với token, hoặc SSH tunnel. Xem Web surfaces.

Nếu thấy “unauthorized” / 1008

  • Chạy openclaw dashboard để lấy link có token mới.
  • Đảm bảo gateway có thể truy cập được (local: openclaw status; remote: SSH tunnel ssh -N -L 18789:127.0.0.1:18789 user@host rồi mở http://127.0.0.1:18789/?token=...).
  • Trong dashboard settings, paste token giống với token các bạn đã cấu hình trong gateway.auth.token (hoặc OPENCLAW_GATEWAY_TOKEN).