Resolução de problemas de canais

Use esta página quando um canal conecta mas o comportamento está incorreto.

Sequência de comandos

Execute estes na ordem primeiro:

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Base saudável:

Sintoma	Verificação mais rápida	Correção
Conectado mas sem respostas em DM	`openclaw pairing list whatsapp`	Aprove o remetente ou altere a política/allowlist de DM.
Mensagens de grupo ignoradas	Verifique `requireMention` + padrões de menção	Mencione o bot ou relaxe a política de menção do grupo.
Desconexão aleatória/loops de relogin	`openclaw channels status --probe` + logs	Faça re-login e verifique se o diretório de credenciais está íntegro.

Sintoma	Verificação mais rápida	Correção
`/start` mas sem fluxo de resposta útil	`openclaw pairing list telegram`	Aprove o pareamento ou altere a política de DM.
Bot online mas grupo silencioso	Verifique requisito de menção e modo de privacidade	Desabilite modo de privacidade para visibilidade em grupo ou mencione o bot.
Falhas de envio com erros de rede	Inspecione logs para falhas de chamada da API	Corrija roteamento DNS/IPv6/proxy para `api.telegram.org`.
`setMyCommands` rejeitado na inicialização	Inspecione logs para `BOT_COMMANDS_TOO_MUCH`	Reduza comandos de plugin/skill/customizados ou desabilite menus nativos.
Upgrade e allowlist te bloqueia	`openclaw security audit` e allowlists do config	Execute `openclaw doctor --fix` ou substitua `@username` por IDs numéricos.

Sintoma	Verificação mais rápida	Correção
Bot online mas sem respostas no guild	`openclaw channels status --probe`	Permita guild/canal e verifique intent de conteúdo de mensagem.
Mensagens de grupo ignoradas	Verifique logs para bloqueios por menção	Mencione o bot ou defina `requireMention: false` no guild/canal.
Respostas de DM ausentes	`openclaw pairing list discord`	Aprove o pareamento de DM ou ajuste a política de DM.

Sintoma	Verificação mais rápida	Correção
Socket mode conectado mas sem respostas	`openclaw channels status --probe`	Verifique app token + bot token e escopos necessários.
DMs bloqueadas	`openclaw pairing list slack`	Aprove o pareamento ou relaxe a política de DM.
Mensagem de canal ignorada	Verifique `groupPolicy` e allowlist do canal	Permita o canal ou mude a política para `open`.

Sintoma	Verificação mais rápida	Correção
Sem eventos de entrada	Verifique acessibilidade do webhook/servidor e permissões do app	Corrija URL do webhook ou estado do servidor BlueBubbles.
Consegue enviar mas não receber	Verifique permissões de privacidade do macOS para automação do Messages	Re-conceda permissões TCC e reinicie o processo do canal.
Remetente de DM bloqueado	`openclaw pairing list imessage` ou `openclaw pairing list bluebubbles`	Aprove o pareamento ou atualize a allowlist.

Resolução completa:

Sintoma	Verificação mais rápida	Correção
Daemon acessível mas bot silencioso	`openclaw channels status --probe`	Verifique URL/conta do daemon `signal-cli` e modo de recepção.
DM bloqueada	`openclaw pairing list signal`	Aprove o remetente ou ajuste a política de DM.
Respostas de grupo não disparam	Verifique allowlist de grupo e padrões de menção	Adicione remetente/grupo ou relaxe o gating.

Sintoma	Verificação mais rápida	Correção
Logado mas ignora mensagens de sala	`openclaw channels status --probe`	Verifique `groupPolicy` e allowlist de salas.
DMs não processam	`openclaw pairing list matrix`	Aprove o remetente ou ajuste a política de DM.
Salas criptografadas falham	Verifique módulo crypto e config de criptografia	Habilite suporte a criptografia e re-entre na sala.