--- title: "OpenClaw Dashboard: Como Acessar no PC e na VPS" url: "https://openclaw.ia.br/blog/openclaw-dashboard-acesso-seguro/" markdown_url: "https://openclaw.ia.br/blog/openclaw-dashboard-acesso-seguro.MD" description: "Abra o dashboard do OpenClaw no PC ou na VPS com túnel SSH. Entenda autenticação, pairing required e como diagnosticar o painel sem expor a porta à internet." date: "2026-10-06" author: "OpenClaw Brasil" --- # OpenClaw Dashboard: Como Acessar no PC e na VPS Abra o dashboard do OpenClaw no PC ou na VPS com túnel SSH. Entenda autenticação, pairing required e como diagnosticar o painel sem expor a porta à internet. **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](/instalacao/), 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: 1. **A página abre?** O navegador conseguiu alcançar o servidor HTTP e carregar os arquivos da interface. 2. **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: ```bash openclaw status openclaw dashboard ``` Se o Gateway não estiver em execução, o comando documentado para iniciá-lo em primeiro plano é: ```bash 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: ```text 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: ```bash openclaw status ``` Confirme a porta configurada. Se o produto ainda não está instalado, siga primeiro o [guia de deploy do OpenClaw em VPS](/blog/deploy-openclaw-vps-servidor-guia/). O túnel não instala nem inicia o Gateway. ### 2. Abra o túnel no notebook Em um terminal do **seu notebook**, execute: ```bash 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: ```text 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: ```bash 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](/blog/onde-hospedar-openclaw-pc-vps-proxmox-raspberry-pi/). ## 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: ```bash 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: ```bash 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: ```bash openclaw devices approve ``` Substitua `` 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 é: ```bash 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](/blog/como-rodar-openclaw-docker-guia-completo/) 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](/blog/openclaw-nao-responde-guia-diagnostico/): 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](/seguranca/boas-praticas/). 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](https://docs.openclaw.ai/web/dashboard). - [Control UI: interface web do Gateway](https://docs.openclaw.ai/web/control-ui). - [Conectar e parear navegadores](https://docs.openclaw.ai/web/control-ui/connect-and-pair). - [Acesso remoto por SSH e tailnet](https://docs.openclaw.ai/gateway/remote). 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.