O que fazer quando o OpenClaw mostra versão do Node.js incompatível?

O OpenClaw requer Node.js 22 ou superior. Execute nvm install 22 && nvm use 22 para atualizar a versão do Node.js.

Como corrigir 'auth not configured' no openclaw health?

Execute openclaw onboard para reconfigurar a autenticação. Se estiver usando setup-token, certifique-se de executar claude setup-token para gerar um novo token.

O que fazer quando a leitura do código QR do WhatsApp falha?

Primeiro execute openclaw channels logout whatsapp para sair, depois execute openclaw channels login whatsapp para fazer login novamente e escanear um novo código QR.

Como corrigir o bot do Telegram que não responde às mensagens?

Você precisa aprovar o código de pareamento primeiro. Execute openclaw pairing list telegram para ver pareamentos pendentes, depois execute openclaw pairing approve telegram [CODE] para aprovar.

Como visualizar os logs do OpenClaw para diagnosticar problemas?

Execute openclaw logs --follow para ver logs em tempo real, ou use openclaw gateway em primeiro plano para ver a saída completa. Os arquivos de log são armazenados no diretório ~/.openclaw/logs/.

Como redefinir toda a configuração do OpenClaw?

Faça backup primeiro, depois exclua o diretório ~/.openclaw e execute openclaw onboard novamente para a configuração inicial. Nota: Isso excluirá todas as informações de autenticação e histórico de chat.

O que fazer quando a porta 18789 do gateway OpenClaw está ocupada?

Execute lsof -i :18789 para verificar qual processo está usando a porta, use openclaw gateway --port 18790 para especificar outra porta, ou modifique a porta padrão no arquivo de configuração.

Como verificar a versão atual do OpenClaw?

Execute openclaw --version para verificar a versão atualmente instalada, execute openclaw status --all para obter um relatório completo do status do sistema.

Solução de Problemas

Solução de Problemas OpenClaw

Está com problemas? Encontre diagnóstico rápido e soluções para problemas comuns aqui

Diagnóstico Rápido

Use estes comandos para diagnosticar problemas rapidamente

openclaw status --all

Melhor relatório de diagnóstico com um clique com todas as informações de status

openclaw gateway status

Verificar status do daemon e conectividade RPC

openclaw doctor

Reparar automaticamente problemas comuns de configuração

Recomenda-se executar openclaw status --all primeiro para obter um relatório de diagnóstico completo, depois localizar o problema com base na saída.

Problemas de Inicialização e Instalação

Resolver falhas de inicialização do OpenClaw, dependências ausentes e mais

Problemas de Autenticação e Modelo

Resolver problemas de OAuth, Chave API, acesso ao modelo e outros problemas de autenticação

Problemas de Conexão de Canal

Resolver falhas de conexão do WhatsApp, Telegram, Discord e outros canais

Problemas de Mensagem e Sessão

Resolver timeout de sessão, variáveis de ambiente e outros problemas de configuração

Depuração e Logs

Aprenda como visualizar logs, gerar relatórios de depuração e obter ajuda

Visualizar Logs

Visualize informações detalhadas de execução e erros através dos logs

Visualizar logs em tempo real

$ openclaw logs --follow

Iniciar em primeiro plano para ver saída completa

$ openclaw gateway

Gerar Relatório de Depuração

Gere um relatório de depuração completo para ajudar a resolver problemas ou buscar assistência

$ openclaw status --all

O relatório de depuração contém status do sistema, informações de configuração, e é a informação mais útil ao buscar ajuda.

Obter Ajuda

Se os métodos acima não conseguirem resolver seu problema, você pode obter ajuda através destes canais

Documentação FAQ Oficial GitHub Discussions (Fazer perguntas) Comunidade Discord

Problema Resolvido?

Se seu problema foi resolvido, você pode continuar explorando outros recursos do OpenClaw.