​

Web (Gateway)

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

​

Webhooks

​

Cấu hình (mặc định bật)

{
  gateway: {
    controlUi: { enabled: true, basePath: "/openclaw" }, // basePath tùy chọn
  },
}

​

Truy cập Tailscale

​

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

{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "serve" },
  },
}

openclaw gateway

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

​

Bind Tailnet + token

{
  gateway: {
    bind: "tailnet",
    controlUi: { enabled: true },
    auth: { mode: "token", token: "your-token" },
  },
}

openclaw gateway

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

​

Internet công cộng (Funnel)

{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "funnel" },
    auth: { mode: "password" }, // hoặc OPENCLAW_GATEWAY_PASSWORD
  },
}

​

Ghi chú bảo mật

• Xác thực Gateway là bắt buộc theo mặc định (token/mật khẩu hoặc Tailscale identity headers).
• Các bind không phải loopback vẫn cần một token/mật khẩu chia sẻ (gateway.auth hoặc môi trường).
• Wizard tạo token gateway theo mặc định (ngay cả trên loopback).
• UI gửi connect.params.auth.token hoặc connect.params.auth.password.
• Đối với các triển khai Control UI không phải loopback, thiết lập gateway.controlUi.allowedOrigins rõ ràng (đầy đủ nguồn gốc). Nếu không, khởi động gateway sẽ bị từ chối theo mặc định.
• gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback=true kích hoạt chế độ fallback Host-header origin, nhưng là một hạ cấp bảo mật nguy hiểm.
• Với Serve, Tailscale identity headers có thể đáp ứng xác thực Control UI/WebSocket khi gateway.auth.allowTailscale là true (không cần token/mật khẩu). Các endpoint API HTTP vẫn yêu cầu token/mật khẩu. Thiết lập gateway.auth.allowTailscale: false để yêu cầu thông tin xác thực rõ ràng. Xem Tailscale và Bảo mật. Luồng không cần token này giả định máy chủ gateway được tin cậy.
• gateway.tailscale.mode: "funnel" yêu cầu gateway.auth.mode: "password" (mật khẩu chia sẻ).

​

Xây dựng UI

pnpm ui:build # tự động cài đặt các phụ thuộc UI lần đầu chạy