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