Para abrir o dashboard do OpenClaw, execute openclaw dashboard no computador onde o Gateway roda. O painel, chamado Control UI, usa por padrão http://127.0.0.1:18789/. Se o OpenClaw está em uma VPS, acesse por túnel SSH ou Tailscale Serve: não abra a porta administrativa diretamente na internet. Abrir a página e autenticar a conexão são etapas diferentes; um painel carregado ainda pode pedir credencial ou aprovação do navegador.
Este guia cobre o acesso depois da instalação do OpenClaw, com um caminho para uso local e outro para servidor remoto. Os comandos e o comportamento de autenticação foram conferidos na documentação oficial em 6 de outubro de 2026. Versões anteriores podem apresentar telas e fluxos diferentes; confira openclaw --version e a ajuda do comando instalado antes de aplicar instruções de outra versão.
Qual endereço usar em cada instalação?
| Onde o Gateway roda | Onde você abre o navegador | Caminho recomendado |
|---|---|---|
| No seu PC | No mesmo PC | openclaw dashboard e endereço local |
| Em uma VPS | No seu notebook | Túnel SSH para o Gateway remoto |
| Em servidor doméstico | Em outro dispositivo autorizado | Tailscale Serve com HTTPS ou túnel SSH |
| Em Docker | No computador que acessa o host | Verificar a publicação da porta e a rede antes de abrir o painel |
A porta 18789 é o padrão, não uma obrigação. Se você configurou outra porta ou um prefixo em gateway.controlUi.basePath, use esses valores no endereço e no encaminhamento. Com TLS habilitado no Gateway, o protocolo também muda para HTTPS/WSS.
Regra central: localhost e 127.0.0.1 apontam para a máquina que está fazendo o acesso. Digitar http://127.0.0.1:18789/ no notebook não acessa automaticamente o OpenClaw da VPS. O túnel SSH é o que conecta essas duas pontas.
O que é o dashboard do OpenClaw?
O dashboard é a interface web administrativa do Gateway. Ele permite conversar com agentes e acessar recursos de operação, como sessões, configurações e aprovações, conforme as permissões da conexão. Não é apenas uma página de métricas nem uma vitrine pública para clientes.
A interface comunica-se com o Gateway por WebSocket, na mesma porta usada para servir o painel. Por isso, existem dois testes distintos:
- A página abre? O navegador conseguiu alcançar o servidor HTTP e carregar os arquivos da interface.
- O painel conecta? A comunicação WebSocket passou pela autenticação e pelos controles de dispositivo.
Quando a página aparece, mas mostra unauthorized ou pairing required, reinstalar o produto raramente é o primeiro passo correto. A rede já pode estar funcionando; falta resolver a camada de acesso.
Como abrir o painel no próprio PC
No terminal do computador onde o OpenClaw está instalado, verifique o estado e abra o dashboard:
openclaw status
openclaw dashboard
Se o Gateway não estiver em execução, o comando documentado para iniciá-lo em primeiro plano é:
openclaw gateway
Deixe esse terminal aberto enquanto usa o Gateway dessa forma. Se sua instalação já usa um serviço em segundo plano, verifique o serviço existente em vez de iniciar outra instância concorrente.
No fluxo atual documentado, openclaw dashboard abre ou copia um link de pareamento de uso único e curta duração. Esse link concede acesso administrativo ao navegador específico que o resgata. Trate o link como uma credencial enquanto estiver válido: não publique em issue, não envie para grupos e não inclua em capturas de tela.
Você também pode abrir manualmente:
http://127.0.0.1:18789/
O acesso manual pode exigir autenticação. Estar em localhost não elimina a necessidade de token ou senha quando o Gateway usa esses modos. Se a tela pedir Gateway secret, use a credencial configurada para aquele Gateway, não a chave da API do modelo.
Como acessar o dashboard em uma VPS com SSH
O caminho simples é manter o Gateway escutando em loopback no servidor e encaminhar a porta pelo SSH. Você precisa de acesso SSH autorizado à VPS e do Gateway funcionando nela.
1. Verifique o OpenClaw no servidor
Entre na VPS com sua conta habitual e execute:
openclaw status
Confirme a porta configurada. Se o produto ainda não está instalado, siga primeiro o guia de deploy do OpenClaw em VPS. O túnel não instala nem inicia o Gateway.
2. Abra o túnel no notebook
Em um terminal do seu notebook, execute:
ssh -N -L 127.0.0.1:18789:127.0.0.1:18789 usuario@seu-servidor
Substitua usuario@seu-servidor pelo destino SSH real. O primeiro endereço e porta pertencem ao notebook; o segundo par é o destino visto pela VPS. O bind local explícito em 127.0.0.1 evita disponibilizar esse encaminhamento para outros computadores da sua rede.
Mantenha o terminal aberto. O comando usa -N porque só precisa encaminhar tráfego, sem executar um comando remoto. Ao encerrá-lo, o acesso encaminhado deixa de funcionar.
3. Abra o endereço local e autentique
No navegador do notebook, acesse:
http://127.0.0.1:18789/
Se o Gateway remoto usa token ou senha, forneça a credencial correta no campo Gateway secret. Depois, aprove o dispositivo se houver solicitação pendente. O SSH protege o transporte; ele não substitui automaticamente a autenticação do OpenClaw.
Se a porta local já estiver ocupada
Use outra porta no lado do notebook, mantendo o destino remoto:
ssh -N -L 127.0.0.1:18790:127.0.0.1:18789 usuario@seu-servidor
Agora abra http://127.0.0.1:18790/. Se o Gateway remoto estiver em outra porta, altere o último número também. Não mude a configuração do servidor apenas para contornar um conflito local.
Para entender a escolha entre PC e servidor, consulte onde hospedar o OpenClaw.
Token do Gateway não é chave de API do modelo
Há credenciais com funções diferentes na instalação:
| Credencial | Para que serve | Onde não deve ser usada |
|---|---|---|
| Token ou senha do Gateway | Autenticar acesso ao Gateway | Em prompts públicos ou tickets |
| Chave de API de um provedor de IA | Autorizar consumo do modelo | No campo de login do dashboard |
| Código de configuração de dispositivo móvel | Conectar o aplicativo no fluxo próprio | Como substituto do segredo do Gateway no painel web |
| Link de pareamento do dashboard | Autorizar um navegador no fluxo de abertura | Em links compartilhados com terceiros |
Nas versões atuais documentadas, um operador autorizado pode consultar o token no terminal interativo do host do Gateway com:
openclaw gateway auth-token --show
Esse comando mostra um segredo. Use-o apenas em terminal privado, sem gravação de sessão ou transmissão de tela, e não copie a saída para logs de suporte. Se o comando não existir na sua versão, confira openclaw gateway --help e a documentação correspondente, em vez de improvisar comandos que possam alterar credenciais.
Não gere outro token só porque houve erro de pareamento. Rotacionar o segredo pode afetar clientes que já estão funcionando. Primeiro identifique se a falha é de autenticação ou de autorização do dispositivo.
Como resolver pairing required
A mensagem disconnected (1008): pairing required indica que o dispositivo precisa de aprovação. No host do Gateway, liste as solicitações:
openclaw devices list
Confira se a solicitação corresponde ao navegador que você acabou de conectar. Revise identidade, papel e escopos apresentados; não aprove pedidos desconhecidos. Depois execute:
openclaw devices approve <requestId>
Substitua <requestId> pelo identificador exato exibido na listagem. Mantenha a página aberta enquanto a aprovação é processada. Se a tentativa mudou ou expirou, liste novamente: o identificador anterior pode não ser mais o correto.
Cada perfil de navegador possui sua própria identidade. Trocar de navegador, usar janela privada ou apagar dados do site pode exigir um novo pareamento. Isso não significa necessariamente que a sessão do WhatsApp foi perdida ou que o agente esqueceu suas conversas.
Também não confunda pareamento do painel administrativo com autorização de usuários de um canal de mensagens. Os objetos e as permissões são diferentes.
Quando usar Tailscale Serve
Para acesso frequente por dispositivos próprios, Tailscale Serve oferece um endereço HTTPS dentro da sua tailnet. A documentação recomenda manter o Gateway em loopback e usar esse proxy privado.
O comando documentado é:
openclaw gateway --tailscale serve
Ele pressupõe Tailscale instalado, autenticado e com Serve disponível no host. Não o execute como uma segunda instância se já houver um Gateway usando a mesma porta; adapte a configuração do serviço existente conforme a documentação oficial.
A autenticação por identidade Tailscale depende da configuração e da verificação dessa identidade pelo Gateway. Não presuma que qualquer URL .ts.net dispensa token, aprovação ou políticas de acesso. Restrinja os usuários e dispositivos que podem alcançar o serviço.
Serve não é Funnel: Funnel publica um serviço para acesso externo. Este guia recomenda acesso privado ao painel administrativo, não sua publicação na internet. Para um acesso ocasional, o túnel SSH costuma exigir menos mudanças na instalação.
Diagnóstico: o painel não abre ou não conecta
| Sintoma | O que verificar primeiro | O que evitar |
|---|---|---|
Connection refused | Gateway ativo, porta correta e túnel aberto | Reinstalar antes de verificar o processo |
SSH informa Address already in use | Porta local ocupada; escolher 18790, por exemplo | Encerrar processos desconhecidos |
Página abre, mas aparece unauthorized | Credencial e modo de autenticação do Gateway | Usar chave de API do Claude/OpenAI |
pairing required | Pedido pendente em openclaw devices list | Aprovar todos os dispositivos |
| Link de pareamento inválido | Gerar um novo com openclaw dashboard | Rotacionar token sem evidência |
Página em branco ou Protocol mismatch | Atualizar página, testar extensões e cache | Apagar todo o estado do OpenClaw |
| Funciona no servidor, mas não no notebook | Túnel, endereço local e caminho do painel | Abrir a porta no firewall público |
Se o painel ficou incompatível logo após uma atualização, reabra-o e faça uma atualização completa da página. Um perfil limpo ajuda a distinguir falha de extensão ou cache de falha no Gateway. Apagar dados do site é um teste posterior, pois também pode apagar a identidade do navegador e exigir novo pareamento.
Em Docker, confirme se a porta do container está acessível pelo host na interface pretendida. Um túnel até a VPS não resolve uma porta que nunca foi disponibilizada ao host. Consulte o guia de OpenClaw com Docker antes de alterar redes ou publicar portas.
Se o painel conecta normalmente, mas o agente não responde, siga o diagnóstico de OpenClaw sem resposta: canal, modelo e ferramenta passam a ser os próximos suspeitos.
Checklist antes de encerrar
- O endereço aponta para o Gateway certo, não para outra instalação local.
- O painel não está exposto diretamente na internet.
- Token, senha e links temporários ficaram fora de prints e logs públicos.
- Apenas solicitações de dispositivos conhecidos foram aprovadas.
- A conexão funciona no perfil de navegador que você pretende manter.
- O túnel ou acesso privado está documentado para a próxima utilização.
Leia também as boas práticas de segurança do OpenClaw. O dashboard deve ser tratado como acesso de operador: quem consegue administrá-lo pode ter poderes muito além de enviar uma pergunta ao modelo.
Perguntas frequentes
Qual é a URL do dashboard do OpenClaw?
Por padrão, é http://127.0.0.1:18789/ no host do Gateway. Porta, prefixo e protocolo podem mudar conforme a configuração. Para uma VPS, use túnel SSH ou acesso privado apropriado; o localhost do notebook não é o localhost do servidor.
Posso abrir o painel sem conectar WhatsApp ou Telegram?
Sim. O dashboard é uma interface do Gateway, não uma página servida pelo canal de mensagens. A disponibilidade das ferramentas e dos modelos depende da sua configuração, mas conectar um desses canais não é requisito para abrir a interface.
O erro 1008 sempre significa token errado?
Não. O código isolado não determina a causa. Leia a mensagem associada: unauthorized aponta para autenticação, enquanto pairing required pede aprovação do dispositivo. Investigue o texto do erro antes de trocar credenciais.
Preciso liberar a porta 18789 no firewall da VPS?
Não para o caminho com SSH descrito aqui. Você precisa alcançar o serviço SSH; o túnel encaminha o acesso ao Gateway em loopback. Publicar a porta administrativa não é necessário para esse fluxo.
Por que preciso parear novamente em uma janela privada?
A identidade e o token por dispositivo dependem dos dados daquele perfil de navegador. Janelas privadas ou perfis que descartam esses dados podem aparecer como um dispositivo novo. Use um perfil persistente para manter o pareamento.
O link criado por openclaw dashboard pode ser compartilhado?
Não deve ser compartilhado. No fluxo atual documentado, ele é um mecanismo temporário de autorização de navegador e pode conceder acesso administrativo. Para outra pessoa operar o Gateway, configure e aprove o acesso dela deliberadamente.
Fontes oficiais
- Dashboard: acesso e autenticação.
- Control UI: interface web do Gateway.
- Conectar e parear navegadores.
- Acesso remoto por SSH e tailnet.
As instruções acima seguem a documentação consultada em 6 de outubro de 2026. Se a ajuda da versão instalada divergir, use o fluxo documentado para essa versão e preserve autenticação, aprovação explícita e acesso privado.