Hoppa till huvudinnehåll

​
Webb (Gateway)

Gatewayn tillhandahåller ett litet kontroll-UI i webbläsaren (Vite + Lit) från samma port som Gateway WebSocket:
  • standard: http://<host>:18789/
  • valfritt prefix: sätt gateway.controlUi.basePath (t.ex. /openclaw)
Egenskaper lever i Control UI. Denna sida fokuserar på binda lägen, säkerhet och webb-vända ytor.

​
Webhooks

När hooks.enabled=true, exponerar Gateway också en liten webhook slutpunkt på samma HTTP-server. Se Gateway konfiguration → hooks för auth + nyttolaster.

​
Konfig (på som standard)

Kontrollgränssnittet är aktiverat som standard när tillgångar finns (dist/control-ui). Du kan styra den via config: 
{
  gateway: {
    controlUi: { enabled: true, basePath: "/openclaw" }, // basePath optional
  },
}

​
Tailscale-åtkomst

​
Integrerad Serve (rekommenderas)

Behåll Gatewayn på local loopback och låt Tailscale Serve proxy den: 
{
  gateway: {
    bind: "loopback",
    tailscale: { mode: "serve" },
  },
}
Starta sedan gatewayn: 
openclaw gateway
Öppna:
  • https://<magicdns>/ (eller din konfigurerade gateway.controlUi.basePath)

​
Tailnet-bindning + token

{
  gateway: {
    bind: "tailnet",
    controlUi: { enabled: true },
    auth: { mode: "token", token: "your-token" },
  },
}
Starta sedan gatewayn (token krävs för bindningar som inte är loopback): 
openclaw gateway
Öppna:
  • http://<tailscale-ip>:18789/ (eller din konfigurerade gateway.controlUi.basePath)

​
Publika internet (Funnel)

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

​
Säkerhetsnoteringar

  • Gateway-autentisering krävs som standard (token/lösenord eller Tailscale-identitetshuvuden).
  • Bindningar som inte är loopback kräver fortfarande en delad token/lösenord (gateway.auth eller env).
  • Guiden genererar som standard en gateway-token (även på loopback).
  • UI:t skickar connect.params.auth.token eller connect.params.auth.password.
  • Kontroll-UI:t skickar anti-clickjacking-huvuden och accepterar endast webbläsarens websocket-anslutningar från samma ursprung om inte gateway.controlUi.allowedOrigins är satt.
  • Med Serve kan Tailscale identitetshuvuden tillfredsställa auth när gateway.auth.allowTailscale är true (ingen token/lösenord krävs). Ange gateway.auth.allowTailscale: false för att kräva explicita referenser. Se Tailscale och Security.
  • gateway.tailscale.mode: "funnel" kräver gateway.auth.mode: "password" (delat lösenord).

​
Bygga UI:t

Gateway serverar statiska filer från dist/control-ui. Bygg dem med: 
pnpm ui:build # auto-installs UI deps on first run