Modelo principal
A maioria das operações passa pelo Gateway (openclaw gateway), um único processo de longa duração responsável pelas conexões dos canais e pelo plano de controle WebSocket.
- Local loopback primeiro: o WS do Gateway usa
ws://127.0.0.1:18789por padrão. Vinculações fora do local loopback se recusam a iniciar sem um caminho válido de autenticação do Gateway: autenticação por token/senha de segredo compartilhado ou uma implantaçãotrusted-proxyfora do local loopback configurada corretamente. - Recomenda-se um Gateway por host. Para obter isolamento, execute vários gateways com perfis e portas isolados (Vários Gateways).
- O host do Canvas é servido na mesma porta do Gateway (
/__openclaw__/canvas/,/__openclaw__/a2ui/) e protegido pela autenticação do Gateway quando vinculado além do local loopback. - O acesso remoto normalmente é feito por um túnel SSH ou uma VPN Tailscale (Acesso remoto).
- Arquitetura do Gateway
- Protocolo do Gateway
- Guia operacional do Gateway
- Superfícies web e modos de vinculação
Emparelhamento e identidade
- Visão geral do emparelhamento (MD + nós)
- Emparelhamento de nós gerenciado pelo Gateway
- CLI de dispositivos (emparelhamento + rotação de token)
- CLI de emparelhamento (aprovações de MD)
- Conexões diretas pelo local loopback (sem cabeçalhos encaminhados/de proxy) podem ser aprovadas automaticamente para emparelhamento, mantendo uma experiência fluida no mesmo host.
- O OpenClaw também tem um caminho restrito de autoconexão local ao backend/contêiner para fluxos confiáveis de auxiliares com segredo compartilhado.
- Clientes da tailnet e da LAN, incluindo vinculações à tailnet no mesmo host, ainda exigem aprovação explícita de emparelhamento.
Descoberta e transportes
Nós e transportes
- Visão geral dos nós
- Protocolo de ponte (nós legados, histórico)
- Guia operacional de nós: iOS
- Guia operacional de nós: Android