Chuyển đến nội dung chính

​
Web (Gateway)

Gateway cung cấp một Control UI trên trình duyệt nhỏ (Vite + Lit) từ cùng một cổng với Gateway WebSocket:
  • mặc định: http://<host>:18789/
  • tiền tố tùy chọn: đặt gateway.controlUi.basePath (ví dụ: /openclaw)
Các khả năng nằm trong Control UI. Trang này tập trung vào các chế độ bind, bảo mật và các bề mặt hướng web.

​
Webhooks

When hooks.enabled=true, the Gateway also exposes a small webhook endpoint on the same HTTP server. See Gateway configuration → hooks for auth + payloads.

​
Config (bật mặc định)

The Control UI is enabled by default when assets are present (dist/control-ui). Bạn có thể điều khiển nó qua cấu hình: 
{
  gateway: {
    controlUi: { enabled: true, basePath: "/openclaw" }, // basePath optional
  },
}

​
Truy cập Tailscale

​
Serve tích hợp (khuyến nghị)

Giữ Gateway trên loopback và để Tailscale Serve proxy nó: 
{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "serve" },
  },
}
Sau đó khởi động gateway: 
openclaw gateway
Mở:
  • https://<magicdns>/ (hoặc gateway.controlUi.basePath đã cấu hình của bạn)

​
Bind tailnet + token

{
  gateway: {
    bind: "tailnet",
    controlUi: { enabled: true },
    auth: { mode: "token", token: "your-token" },
  },
}
Sau đó khởi động gateway (cần token cho các bind không phải loopback): 
openclaw gateway
Mở:
  • http://<tailscale-ip>:18789/ (hoặc gateway.controlUi.basePath đã cấu hình của bạn)

​
Internet công cộng (Funnel)

{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "funnel" },
    auth: { mode: "password" }, // or OPENCLAW_GATEWAY_PASSWORD
  },
}

​
Ghi chú bảo mật

  • Xác thực Gateway được yêu cầu theo mặc định (token/mật khẩu hoặc header định danh Tailscale).
  • Các bind không phải loopback vẫn bắt buộc dùng token/mật khẩu dùng chung (gateway.auth hoặc env).
  • Trình hướng dẫn tạo token gateway theo mặc định (kể cả trên loopback).
  • UI gửi connect.params.auth.token hoặc connect.params.auth.password.
  • Control UI gửi các header chống clickjacking và chỉ chấp nhận kết nối websocket từ trình duyệt cùng nguồn trừ khi đặt gateway.controlUi.allowedOrigins.
  • Với Serve, các header danh tính Tailscale có thể đáp ứng xác thực khi gateway.auth.allowTailscale là true (không cần token/mật khẩu). 36. Đặt gateway.auth.allowTailscale: false để yêu cầu thông tin xác thực rõ ràng. See Tailscale and Security.
  • gateway.tailscale.mode: "funnel" yêu cầu gateway.auth.mode: "password" (mật khẩu dùng chung).

​
Xây dựng UI

Gateway phục vụ các tệp tĩnh từ dist/control-ui. Xây dựng chúng bằng: 
pnpm ui:build # auto-installs UI deps on first run