1. Erros de Digitação e Caracteres Invisíveis no .env

A causa mais comum para o erro de mismatch é a mais simples de todas: um espaço em branco no final da string do token no seu arquivo .env. Quando você copia e cola o token do servidor para o cliente, caracteres invisíveis de formatação podem se infiltrar e quebrar a validação matemática da chave de segurança.

Sempre verifique se o GATEWAY_TOKEN no seu servidor corresponde exatamente ao que você está inserindo no campo de login do client. Use editores de texto puro (como Notepad, Vim ou VSCode) para garantir que nenhuma formatação de “texto rico” seja adicionada acidentalmente ao arquivo de configuração do sistema.

2. Cache do Navegador e Sessões Antigas

Muitas vezes, você atualizou o token no servidor com sucesso, mas o seu navegador ainda está tentando usar a credencial antiga que ficou salva no LocalStorage. Isso cria um conflito imediato onde o cliente envia uma informação que o servidor já não reconhece mais como válida no banco de dados.

O remédio é simples e eficaz: faça o logout completo da sessão e limpe o cache do site nas configurações do seu navegador (F12 > Application > Clear Site Data). Como teste final, tente abrir uma aba anônima; se lá funcionar, você terá a certeza de que o problema era apenas lixo digital guardado localmente.

3. Conflitos de Variáveis entre Instâncias

Se você tem várias instâncias do OpenClaw rodando na mesma VPS, uma pode estar tentando ler as variáveis de ambiente da outra por engano. Isso acontece com frequência quando não utilizamos ambientes virtuais isolados (venv) ou contêineres Docker para separar cada projeto de automação.

Sempre inicie o Gateway garantindo que ele está lendo o arquivo de configuração correto da sua pasta de trabalho atual. Use comandos explícitos para carregar o ambiente, garantindo que o token ativo na memória RAM seja exatamente aquele que você definiu para aquela instância específica do sistema.

4. Checklist de Diagnóstico e Resolução Rápida

• Validar o .env: Abra o arquivo no servidor e confirme que o token não possui espaços, aspas desnecessárias ou quebras de linha que possam corromper a leitura da variável pelo motor do Gateway.
• Reiniciar o Gateway: Sempre que você alterar o token no arquivo de configuração, é obrigatório reiniciar o processo do OpenClaw. Sem o restart, o sistema continuará validando as conexões com a chave antiga que ainda está carregada na memória.
• Sincronização de Relógio: Verifique se o relógio da sua VPS está sincronizado via NTP. Diferenças de tempo superiores a alguns segundos entre o servidor e o cliente podem invalidar tokens temporários e causar erros de mismatch intermitentes e difíceis de rastrear.