​

Control UI (trình duyệt)

• mặc định: http://<host>:18789/
• tiền tố tùy chọn: đặt gateway.controlUi.basePath (ví dụ: /openclaw)

​

Mở nhanh (local)

• http://127.0.0.1:18789/ (hoặc http://localhost:18789/)

• connect.params.auth.token
• 48. connect.params.auth.password Bảng cài đặt dashboard cho phép bạn lưu một token; mật khẩu không được lưu trữ. Trình hướng dẫn onboarding tạo token gateway theo mặc định, vì vậy hãy dán nó vào đây khi kết nối lần đầu.

​

Ghép cặp thiết bị (kết nối lần đầu)

# List pending requests
openclaw devices list

# Approve by request ID
openclaw devices approve <requestId>

• Kết nối local (127.0.0.1) được tự động phê duyệt.
• Kết nối từ xa (LAN, Tailnet, v.v.) 50. yêu cầu phê duyệt rõ ràng.
• Mỗi hồ sơ trình duyệt tạo một ID thiết bị duy nhất, vì vậy việc đổi trình duyệt hoặc xóa dữ liệu trình duyệt sẽ yêu cầu ghép cặp lại.

​

Những gì có thể làm (hiện tại)

• Chat với mô hình qua Gateway WS (chat.history, chat.send, chat.abort, chat.inject)
• Stream các lời gọi công cụ + thẻ đầu ra công cụ trực tiếp trong Chat (sự kiện tác tử)
• Kênh: WhatsApp/Telegram/Discord/Slack + các kênh plugin (Mattermost, v.v.) trạng thái + đăng nhập QR + cấu hình theo kênh (channels.status, web.login.*, config.patch)
• Instances: danh sách hiện diện + làm mới (system-presence)
• Sessions: danh sách + ghi đè thinking/verbose theo từng phiên (sessions.list, sessions.patch)
• Cron jobs: liệt kê/thêm/chạy/bật/tắt + lịch sử chạy (cron.*)
• Skills: trạng thái, bật/tắt, cài đặt, cập nhật khóa API (skills.*)
• Nodes: danh sách + caps (node.list)
• Phê duyệt exec: chỉnh sửa allowlist của gateway hoặc node + chính sách hỏi cho exec host=gateway/node (exec.approvals.*)
• Config: xem/chỉnh sửa ~/.openclaw/openclaw.json (config.get, config.set)
• Config: áp dụng + khởi động lại với xác thực (config.apply) và đánh thức phiên hoạt động gần nhất
• Ghi cấu hình bao gồm cơ chế bảo vệ base-hash để tránh ghi đè các chỉnh sửa đồng thời
• Schema cấu hình + render biểu mẫu (config.schema, bao gồm schema plugin + kênh); trình chỉnh sửa JSON thô vẫn khả dụng
• Debug: snapshot trạng thái/sức khỏe/mô hình + nhật ký sự kiện + gọi RPC thủ công (status, health, models.list)
• Logs: theo dõi trực tiếp log file gateway với lọc/xuất (logs.tail)
• Update: chạy cập nhật gói/git + khởi động lại (update.run) kèm báo cáo khởi động lại

• Đối với các tác vụ cô lập, phương thức gửi mặc định là thông báo tóm tắt. Bạn có thể chuyển sang none nếu muốn chạy chỉ nội bộ.
• Trường kênh/đích sẽ xuất hiện khi chọn announce.

​

Hành vi chat

• chat.send là không chặn: nó xác nhận ngay bằng { runId, status: "started" } và phản hồi được stream qua các sự kiện chat.
• Gửi lại với cùng idempotencyKey sẽ trả về { status: "in_flight" } khi đang chạy, và { status: "ok" } sau khi hoàn tất.
• chat.inject thêm một ghi chú trợ lý vào bản ghi phiên và phát sự kiện chat để cập nhật UI (chỉ UI, không chạy tác tử, không gửi kênh).
• Dừng:
  • Nhấp Stop (gọi chat.abort)
  • Gõ /stop (hoặc stop|esc|abort|wait|exit|interrupt) để hủy ngoài luồng
  • chat.abort hỗ trợ { sessionKey } (không cần runId) để hủy tất cả các lần chạy đang hoạt động cho phiên đó

​

Truy cập Tailnet (khuyến nghị)

​

Tailscale Serve tích hợp (ưu tiên)

openclaw gateway --tailscale serve

• https://<magicdns>/ (hoặc gateway.controlUi.basePath đã cấu hình của bạn)

​

Bind vào tailnet + token

openclaw gateway --bind tailnet --token "$(openssl rand -hex 32)"

• http://<tailscale-ip>:18789/ (hoặc gateway.controlUi.basePath đã cấu hình của bạn)

​

HTTP không an toàn

• https://<magicdns>/ (Serve)
• http://127.0.0.1:18789/ (trên máy chủ gateway)

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

26. Điều này vô hiệu hóa định danh thiết bị + ghép cặp cho Control UI (kể cả trên HTTPS). Use only if you trust the network.

​

Build UI

pnpm ui:build # auto-installs UI deps on first run

OPENCLAW_CONTROL_UI_BASE_PATH=/openclaw/ pnpm ui:build

pnpm ui:dev # auto-installs UI deps on first run

​

Gỡ lỗi/kiểm thử: dev server + Gateway từ xa

27. Control UI là các tệp tĩnh; đích WebSocket có thể cấu hình và có thể khác với nguồn gốc HTTP. Điều này hữu ích khi bạn muốn chạy máy chủ dev Vite cục bộ nhưng Gateway chạy ở nơi khác.
28. Khởi động UI dev server: pnpm ui:dev
29. Mở một URL như:

http://localhost:5173/?gatewayUrl=ws://<gateway-host>:18789

http://localhost:5173/?gatewayUrl=wss://<gateway-host>:18789&token=<gateway-token>

• gatewayUrl được lưu trong localStorage sau khi tải và bị xóa khỏi URL.
• token được lưu trong localStorage; password chỉ được giữ trong bộ nhớ.
• 28. Khi gatewayUrl được đặt, UI sẽ không quay về sử dụng thông tin xác thực từ cấu hình hoặc môi trường. Provide token (or password) explicitly. 29. Thiếu thông tin xác thực rõ ràng là một lỗi.
• Dùng wss:// khi Gateway nằm sau TLS (Tailscale Serve, proxy HTTPS, v.v.).
• gatewayUrl chỉ được chấp nhận trong cửa sổ cấp cao nhất (không nhúng) để ngăn clickjacking.
• Với các thiết lập dev khác origin (ví dụ: pnpm ui:dev tới một Gateway từ xa), hãy thêm origin của UI vào gateway.controlUi.allowedOrigins.

{
  gateway: {
    controlUi: {
      allowedOrigins: ["http://localhost:5173"],
    },
  },
}