OpenClaw não responde: como descobrir o motivo

Você envia uma mensagem e nada volta. Um assistente auto-hospedado tem quatro pontos onde uma resposta pode se perder, e todos eles parecem idênticos na janela do chat. Testá-los em ordem leva cerca de cinco minutos e transforma um bot silencioso em uma falha específica e corrigível.

As quatro camadas

Antes de mudar qualquer coisa, saiba o que você está testando. Uma mensagem passa por todas essas quatro camadas, e qualquer uma delas pode engoli-la sem que nenhum erro chegue até você:

1. A instância. O OpenClaw está de fato rodando no seu servidor?
2. O provedor do modelo. O modelo de linguagem está aceitando suas requisições?
3. A integração de chat. A mensagem está chegando ao OpenClaw?
4. O caminho de rede. Você e a plataforma conseguem alcançar a instância?

Há um teste que divide o problema ao meio imediatamente: envie uma mensagem na interface web do OpenClaw. Se você receber uma resposta ali, as camadas um e dois estão bem e o problema é a integração. Se não receber, pare de olhar para o bot por completo.

Camada 1: a instância está rodando?

Abra seu painel da Flux e confira se a instância está no ar e não reiniciando em loop. Um contêiner que morre e volta sem parar é a versão menos óbvia disso, porque o serviço parece presente entre as reinicializações.

A causa comum de um loop de reinicialização é a memória. Se você apontou o OpenClaw para um modelo local em vez de uma API hospedada, os pesos do modelo precisam caber na mesma RAM que todo o resto. Um modelo de 7B quantizado em 4 bits tem cerca de 4 GB só de pesos, antes de qualquer contexto de conversa e antes do processo do assistente. No nível de 4 GB isso não funciona, e o nível de 8 GB é o mínimo realista para inferência local. Ou você sobe de nível, ou aponta o assistente para um modelo hospedado, onde o trabalho pesado acontece no hardware do provedor e sua instância só precisa segurar a conversa.

Se você não consegue acessar a interface web de jeito nenhum, anote esse fato e vá para a camada quatro antes de presumir que a instância está quebrada.

Camada 2: o provedor do modelo está recusando você?

O OpenClaw é agnóstico de modelo e você traz sua própria chave, o que significa que o silêncio mais comum não tem nada a ver com o OpenClaw. Quatro falhas do lado do provedor produzem um assistente que para de responder, e na janela do chat elas são indistinguíveis:

• A chave é inválida ou foi trocada. Chaves são revogadas, regeneradas e coladas com um espaço no final. Cole de novo em vez de ler e decidir que parece correta.
• O saldo de créditos está zerado. Contas pré-pagas param de atender requisições no momento em que o saldo acaba, sem nenhum aviso dentro do seu assistente.
• Você está sendo limitado por taxa. Contas novas em todos os grandes provedores ficam em níveis baixos de requisições por minuto. Uma rajada de mensagens, ou um loop de agente que chama o modelo repetidamente, vai bater nesse teto, e cada requisição recusada não devolve nada útil para o chat.
• O nome do modelo não existe mais. Provedores aposentam identificadores de modelo, e uma configuração escrita meses atrás pode estar apontando para algo que já foi retirado. A requisição falha como modelo inválido, e não como chave inválida, o que é fácil de interpretar errado.

Verifique o painel do próprio provedor: as páginas de uso, cobrança e limite de taxa dizem em segundos qual das quatro você tem, e todas são corrigidas ali, e não no OpenClaw.

Camada 3: a integração de chat

Se a interface web responde e o bot não, a mensagem nunca chega. Cada plataforma tem uma causa dominante, e vale conhecê-las pelo nome.

Telegram: Privacy Mode

Bots criados pelo BotFather têm o Privacy Mode ativado por padrão. Em um grupo, um bot nesse estado só recebe mensagens que começam com um comando de barra, ou que respondem ou mencionam o bot diretamente. Todo o resto nunca é entregue ao seu servidor, então seu assistente não está ignorando ninguém: ele realmente nunca ouviu. Por isso o mesmo bot responde perfeitamente às mensagens diretas e parece morto em um grupo.

Para corrigir, envie uma mensagem ao BotFather, abra as Bot Settings do seu bot e desative o Group Privacy. Depois remova o bot do grupo e adicione-o de novo, porque a configuração é aplicada quando o bot entra.

Discord: o Message Content Intent

Desde 2022 o Discord trata o texto das mensagens como dado privilegiado. Um bot sem o Message Content Intent ativado ainda se conecta, ainda aparece como online e recebe eventos de mensagem com o campo de conteúdo vazio. O resultado é um bot claramente em execução que não reage a absolutamente nada.

Ative no Portal do Desenvolvedor do Discord, em sua aplicação, Bot, Privileged Gateway Intents, e depois reinicie a integração. Já que está lá, confira se o bot tem permissão para ler e enviar mensagens no canal específico: as permissões de canal sobrepõem silenciosamente os cargos do servidor, e um bot com permissão de servidor pode continuar mudo em uma sala.

WhatsApp: a sessão

As conexões do WhatsApp são ligadas a uma sessão vinculada, e não a um token permanente, e as sessões expiram, são desconectadas pelo celular ou quebram quando o dispositivo fica offline por muito tempo. Uma integração silenciosa do WhatsApp é, na maioria das vezes, uma sessão que precisa ser vinculada de novo. Escaneie o código novamente e teste antes de procurar em qualquer outro lugar.

Todas as plataformas: o próprio token

Seja qual for a plataforma, confirme que o token no seu painel é o atual. Regenerar o token de um bot no console da própria plataforma invalida o antigo instantaneamente, e é muito fácil regenerar um token enquanto investiga outra coisa e esquecer de colar o novo de volta.

Camada 4: o caminho de rede

Se você acessa o OpenClaw pelo Tailscale, o assistente pode estar perfeitamente saudável enquanto você simplesmente não consegue chegar até ele. Chaves de autenticação expiram, e chaves de dispositivo também, então uma instância que fica rodando sem supervisão por meses pode sair da sua tailnet sem que nada tenha falhado. Verifique o console de administração do Tailscale e confirme que o dispositivo ainda está listado e autorizado. Se não estiver, gere uma nova chave de autenticação e reimplante ou reconecte.

Esta camada explica um padrão que confunde: o bot continua respondendo no chat enquanto a interface web está inacessível para você. A instância está bem e rodando; só a sua rota até ela sumiu.

Responde, mas mal

Uma resposta lenta ou truncada é um problema diferente do silêncio e normalmente se resume a duas coisas. Conversas longas eventualmente excedem a janela de contexto do modelo, e aí as requisições começam a falhar ou o assistente perde a parte anterior da conversa. Começar uma conversa nova é a correção imediata. Além disso, um modelo local grande em hardware modesto é simplesmente lento, e uma resposta que leva um minuto pode expirar em algum ponto da cadeia antes de ser entregue. Se você precisa de velocidade em uma instância pequena, um modelo hospedado vai superar um local em todos os casos.

O checklist de cinco minutos

1. Envie uma mensagem na interface web do OpenClaw. Uma resposta ali significa que o problema é a integração; sem resposta significa que é a instância, o provedor ou o seu caminho até ela.
2. Verifique a instância no seu painel da Flux em busca de loop de reinicialização, e verifique a RAM se estiver rodando um modelo local.
3. Verifique o painel do provedor do modelo em busca de chave inválida, saldo zerado, limite de taxa ou nome de modelo aposentado.
4. No Telegram, desative o Privacy Mode no BotFather e adicione o bot ao grupo de novo.
5. No Discord, ative o Message Content Intent e confirme as permissões no nível do canal.
6. No WhatsApp, vincule a sessão de novo.
7. Se a interface web estiver inacessível mas o chat ainda funcionar, verifique no Tailscale se há um dispositivo ou chave de autenticação expirada.

Quase todos os casos terminam no passo um, três ou quatro. O padrão que vale internalizar é que um assistente auto-hospedado tem mais partes móveis do que um SaaS justamente porque você as possui, e possuí-las significa que a falha sempre pode ser localizada.

Leitura relacionada

Novo em rodar um desses? Comece pelo guia para auto-hospedar o OpenClaw, ou leia sobre como escolher um modelo de IA se estiver avaliando um provedor hospedado contra um local. Para as próprias integrações, veja Telegram, Discord e WhatsApp.