109 lines
2.4 KiB
Markdown
109 lines
2.4 KiB
Markdown
---
|
|
summary: "Gateway web surfaces: Control UI, bind modes, and security"
|
|
read_when:
|
|
- You want to access the Gateway over Tailscale
|
|
- You want the browser Control UI and config editing
|
|
---
|
|
# Web (Gateway)
|
|
|
|
The Gateway serves a small **browser Control UI** (Vite + Lit) from the same port as the Gateway WebSocket:
|
|
|
|
- `http://<host>:18789/ui/`
|
|
|
|
The UI talks directly to the Gateway WS and supports:
|
|
- Chat (`chat.history`, `chat.send`, `chat.abort`)
|
|
- Connections (provider status, WhatsApp QR, Telegram config)
|
|
- Instances (`system-presence`)
|
|
- Sessions (`sessions.list`, `sessions.patch`)
|
|
- Cron (`cron.*`)
|
|
- Skills (`skills.status`, `skills.update`, `skills.install`)
|
|
- Nodes (`node.list`, `node.describe`, `node.invoke`)
|
|
- Config (`config.get`, `config.set`) for `~/.clawdis/clawdis.json`
|
|
- Debug (status/health/models snapshots + manual calls)
|
|
|
|
## Config (default-on)
|
|
|
|
The Control UI is **enabled by default** when assets are present (`dist/control-ui`).
|
|
You can control it via config:
|
|
|
|
```json5
|
|
{
|
|
gateway: {
|
|
controlUi: { enabled: true } // set false to disable /ui/
|
|
}
|
|
}
|
|
```
|
|
|
|
## Tailscale access
|
|
|
|
### Integrated Serve (recommended)
|
|
|
|
Keep the Gateway on loopback and let Tailscale Serve proxy it:
|
|
|
|
```json5
|
|
{
|
|
gateway: {
|
|
bind: "loopback",
|
|
tailscale: { mode: "serve" }
|
|
}
|
|
}
|
|
```
|
|
|
|
Then start the gateway:
|
|
|
|
```bash
|
|
clawdis gateway
|
|
```
|
|
|
|
Open:
|
|
- `https://<magicdns>/ui/`
|
|
|
|
### Tailnet bind + token (legacy)
|
|
|
|
```json5
|
|
{
|
|
gateway: {
|
|
bind: "tailnet",
|
|
controlUi: { enabled: true }
|
|
}
|
|
}
|
|
```
|
|
|
|
Then start the gateway (token required for non-loopback binds):
|
|
|
|
```bash
|
|
export CLAWDIS_GATEWAY_TOKEN="…your token…"
|
|
clawdis gateway
|
|
```
|
|
|
|
Open:
|
|
- `http://<tailscale-ip>:18789/ui/`
|
|
|
|
### Public internet (Funnel)
|
|
|
|
```json5
|
|
{
|
|
gateway: {
|
|
bind: "loopback",
|
|
tailscale: { mode: "funnel" },
|
|
auth: { mode: "system" } // or "password" with CLAWDIS_GATEWAY_PASSWORD
|
|
}
|
|
}
|
|
```
|
|
|
|
## Security notes
|
|
|
|
- Binding the Gateway to a non-loopback address **requires** auth (`CLAWDIS_GATEWAY_TOKEN` or `gateway.auth`).
|
|
- `gateway.auth.mode: "system"` uses PAM to verify your OS password.
|
|
- The UI sends `connect.params.auth.token` or `connect.params.auth.password`.
|
|
- Use `gateway.auth.allowTailscale: false` to require explicit credentials even in Serve mode.
|
|
|
|
## Building the UI
|
|
|
|
The Gateway serves static files from `dist/control-ui`. Build them with:
|
|
|
|
```bash
|
|
pnpm ui:install
|
|
pnpm ui:build
|
|
```
|