Solução de problemas de canal
Use esta página quando um canal se conectar, mas o comportamento estiver incorreto.Escada de comandos
Execute estes comandos nesta ordem primeiro:Runtime: runningRPC probe: ok- A probe do canal mostra o transporte conectado e, quando compatível,
worksouaudit ok
Assinaturas de falha do WhatsApp
| 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 de DM/allowlist. |
| Mensagens de grupo ignoradas | Verifique requireMention + padrões de menção na configuração | Mencione o bot ou flexibilize a política de menção para esse grupo. |
| Desconexões aleatórias/loops de novo login | openclaw channels status --probe + logs | Faça login novamente e verifique se o diretório de credenciais está íntegro. |
Telegram
Assinaturas de falha do Telegram
| Sintoma | Verificação mais rápida | Correção |
|---|---|---|
/start, mas sem fluxo de resposta utilizável | openclaw pairing list telegram | Aprove o pairing ou altere a política de DM. |
| Bot online, mas o grupo permanece silencioso | Verifique a exigência de menção e o modo de privacidade do bot | Desative o modo de privacidade para visibilidade no grupo ou mencione o bot. |
| Falhas de envio com erros de rede | Inspecione os logs em busca de falhas de chamada da API do Telegram | Corrija o roteamento de DNS/IPv6/proxy para api.telegram.org. |
setMyCommands rejeitado na inicialização | Inspecione os logs em busca de BOT_COMMANDS_TOO_MUCH | Reduza comandos de plugin/Skills/personalizados do Telegram ou desative menus nativos. |
| Atualizou e a allowlist está bloqueando você | openclaw security audit e allowlists na configuração | Execute openclaw doctor --fix ou substitua @username por IDs numéricos de remetente. |
Discord
Assinaturas de falha do Discord
| Sintoma | Verificação mais rápida | Correção |
|---|---|---|
| Bot online, mas sem respostas no servidor | openclaw channels status --probe | Permita o servidor/canal e verifique a intent de conteúdo de mensagem. |
| Mensagens de grupo ignoradas | Verifique os logs em busca de descartes por gating de menção | Mencione o bot ou defina requireMention: false para o servidor/canal. |
| Respostas em DM ausentes | openclaw pairing list discord | Aprove o pairing de DM ou ajuste a política de DM. |
Slack
Assinaturas de falha do Slack
| Sintoma | Verificação mais rápida | Correção |
|---|---|---|
| Socket mode conectado, mas sem respostas | openclaw channels status --probe | Verifique o token do app + token do bot e os escopos necessários; observe botTokenStatus / appTokenStatus = configured_unavailable em configurações com suporte a SecretRef. |
| DMs bloqueadas | openclaw pairing list slack | Aprove o pairing ou flexibilize a política de DM. |
| Mensagem de canal ignorada | Verifique groupPolicy e a allowlist do canal | Permita o canal ou altere a política para open. |
iMessage e BlueBubbles
Assinaturas de falha do iMessage e BlueBubbles
| Sintoma | Verificação mais rápida | Correção |
|---|---|---|
| Nenhum evento de entrada | Verifique o alcance do webhook/servidor e as permissões do app | Corrija a URL do webhook ou o estado do servidor BlueBubbles. |
| Consegue enviar, mas não receber no macOS | Verifique as permissões de privacidade do macOS para automação do Messages | Conceda novamente as permissões TCC e reinicie o processo do canal. |
| Remetente de DM bloqueado | openclaw pairing list imessage ou openclaw pairing list bluebubbles | Aprove o pairing ou atualize a allowlist. |
Signal
Assinaturas de falha do Signal
| Sintoma | Verificação mais rápida | Correção |
|---|---|---|
| Daemon acessível, mas bot silencioso | openclaw channels status --probe | Verifique a URL/conta do daemon signal-cli e o modo de recebimento. |
| DM bloqueada | openclaw pairing list signal | Aprove o remetente ou ajuste a política de DM. |
| Respostas em grupo não disparam | Verifique a allowlist do grupo e os padrões de menção | Adicione remetente/grupo ou flexibilize o gating. |
QQ Bot
Assinaturas de falha do QQ Bot
| Sintoma | Verificação mais rápida | Correção |
|---|---|---|
| Bot responde “gone to Mars” | Verifique appId e clientSecret na configuração | Defina as credenciais ou reinicie o gateway. |
| Nenhuma mensagem de entrada | openclaw channels status --probe | Verifique as credenciais na QQ Open Platform. |
| Voz não transcrita | Verifique a configuração do provider de STT | Configure channels.qqbot.stt ou tools.media.audio. |
| Mensagens proativas não chegam | Verifique os requisitos de interação da plataforma QQ | O QQ pode bloquear mensagens iniciadas pelo bot sem interação recente. |
Matrix
Assinaturas de falha do Matrix
| Sintoma | Verificação mais rápida | Correção |
|---|---|---|
| Logado, mas ignora mensagens da sala | openclaw channels status --probe | Verifique groupPolicy, a allowlist da sala e o gating por menção. |
| DMs não são processadas | openclaw pairing list matrix | Aprove o remetente ou ajuste a política de DM. |
| Salas criptografadas falham | openclaw matrix verify status | Verifique novamente o dispositivo e então confira openclaw matrix verify backup status. |
| A restauração do backup está pendente/com problema | openclaw matrix verify backup status | Execute openclaw matrix verify backup restore ou rode novamente com uma chave de recuperação. |
| Cross-signing/bootstrap parece incorreto | openclaw matrix verify bootstrap | Repare o armazenamento de segredos, o cross-signing e o estado do backup em uma única etapa. |