Skip to main content
Self-hosted AI assistant gateway. Connects to messaging channels and routes conversations to AI backends. Runs on i3.

Access

  • Control UI: openclaw.augustin.ai — new devices require pairing approval via devices list / devices approve
  • Matrix bot: DM the bot user configured in openclaw.json

Services

All run via openclaw/compose.yaml:
ContainerPurpose
openclaw-gatewayGateway process, Control UI, channel connections, agent runtime
openclaw-cliInteractive CLI, shares gateway’s network stack
Built from source with the Matrix extension. The source tree (openclaw-src/) is gitignored.

Configuration

Gateway config lives in data/openclaw/openclaw.json, mounted into the container. Edit on the host and restart, or use the Control UI’s config editor.

Networking

The gateway joins the traefik network for reverse proxy access. It binds to LAN inside the container so Traefik can reach it. Host port mapping remains localhost-only. The Control UI uses WebSocket connections — allowedOrigins in the gateway config must include the public URL.

Matrix

OpenClaw connects outbound to the local Synapse homeserver as a Matrix user. The Matrix plugin is baked into the image at build time. DM access is controlled via allowlist in openclaw.json.