OpenClaw sem responder

Um agente OpenClaw que fica parado é a reclamação mais comum depois do custo, e o diagnóstico quase sempre é uma entre oito coisas. O projeto agora inclui um fluxo de triagem que leva você a um diagnóstico em cerca de dois minutos. Aqui está ele em linguagem simples, seguido das causas que lotam os fóruns e do que muda quando outra pessoa opera o Gateway para você.

Os primeiros sessenta segundos

Execute a escada em ordem: triage, status, gateway probe, gateway status, doctor, channels probe e, depois, acompanhe os logs. Um estado saudável se lê assim: acessível, runtime em execução, sonda de conectividade ok, nenhum erro bloqueante do doctor e todos os canais informando um transporte ativo. O comando triage grava um diagnóstico sanitizado que você pode entregar a um agente, a um fórum ou ao suporte.

Os suspeitos de sempre

• Pareamento pendente: um remetente desconhecido mandou mensagem e ninguém aprovou a solicitação, então o agente ignora essa pessoa, por design. A versão disso em produção é um Gateway preso em um loop de reconexão que exige pareamento.
• Filtro por menção em um grupo: ele descarta as mensagens do grupo até ser mencionado, e diz isso nos logs.
• Uma divergência na lista de permissões: o remetente, o canal ou o modelo é filtrado pela política. Um modelo que não está na lista de permissões faz com que tarefas cron e subagentes falhem silenciosamente.
• O perfil de ferramentas: um perfil minimal quase não permite nada, então ele responde, mas não consegue agir.
• O provedor: um limite de taxa, uma credencial expirada, como um token de teste do Google OAuth, ou uma recusa, visíveis nos logs como um 429 ou um 403.
• Uma falha de entrega que parece uma falha da tarefa: uma tarefa cron marcada como falha com um 401 do lado do Telegram ou do gateway, enquanto o trabalho em si deu certo.
• Um plugin ou canal desativado após uma atualização: o assistente está rodando, e a porta pela qual ele respondia está fechada.
• O próprio Gateway: fora do ar, reiniciando ou encerrado por falta de memória em um host pequeno.

Ele simplesmente ficou parado por 2 horas sem fazer nada.

Lento não é o mesmo que travado

Uma resposta que chega com minutos de atraso geralmente é um modelo ocupado, um contexto longo sendo relido ou um turno de heartbeat ocupando a sessão. O heartbeat do OpenClaw explica esse último caso e por que ele também é o motivo de um agente ocioso nunca estar totalmente ocioso.

O que muda em uma hospedagem gerenciada

A escada acima pressupõe um shell na máquina. Na Diali, não há máquina: o feed de atividade mostra o provisionamento, as atualizações e os eventos de canal, o painel tem pausar, reiniciar e reinstalar, e o Gateway é monitorado para você. Pareamento, listas de permissões e o perfil de ferramentas continuam por sua conta, porque são política, e não encanamento. O OpenClaw hospedado na Diali descreve o resto.

Antes de postar em um fórum

• Rode o triage e anexe a saída dele; é a primeira coisa que qualquer pessoa disposta a ajudar vai pedir.
• Verifique o pareamento e o filtro por menção antes de reconectar qualquer coisa.
• Procure nos logs as três assinaturas: mention required, pairing request, blocked.
• Se ele estiver lento, e não mudo, olhe primeiro o provedor e o heartbeat.

E se a palavra Gateway, em tudo isso, é a parte que você nunca entendeu, este guia sobre o Gateway do OpenClaw traz a explicação.