Solução de problemas de canais

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

# Sequência de comandos

Execute estes comandos em ordem primeiro:

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

Linha de base saudável:

• Runtime: running
• Connectivity probe: ok
• Capability: read-only, write-capable ou admin-capable
• A sondagem do canal mostra o transporte conectado e, quando compatível, works ou audit ok

# WhatsApp

# Sinais 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/lista de permissões de DM.
Mensagens de grupo ignoradas	Verifique requireMention + padrões de menção na configuração	Mencione o bot ou flexibilize a política de menções para esse grupo.
Login por QR expira com 408	Verifique as env HTTPS_PROXY / HTTP_PROXY do Gateway	Defina um proxy acessível; use NO_PROXY apenas para exceções.
Loops aleatórios de desconexão/relogin	openclaw channels status --probe + logs	Reconexões recentes são sinalizadas mesmo quando conectado no momento; observe os logs, reinicie o Gateway e revincule se a instabilidade continuar.
Respostas chegam segundos/minutos atrasadas	openclaw doctor --fix	O doctor interrompe clientes TUI locais obsoletos verificados quando eles estão degradando o loop de eventos do Gateway.

Solução de problemas completa: Solução de problemas do WhatsApp

# Telegram

# Sinais 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 pareamento ou altere a política de DM.
Bot online, mas o grupo permanece silencioso	Verifique o requisito 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 para falhas de chamada da API do Telegram	Corrija o roteamento de DNS/IPv6/proxy para api.telegram.org.
Inicialização relata getMe returned 401	Verifique a origem do token configurado	Copie novamente ou regenere o token do BotFather e atualize botToken, tokenFile ou TELEGRAM_BOT_TOKEN da conta padrão.
Polling trava ou reconecta lentamente	openclaw logs --follow para diagnósticos de polling	Atualize; se reinicializações forem falsos positivos, ajuste pollingStallThresholdMs. Travamentos persistentes ainda apontam para proxy/DNS/IPv6.
setMyCommands rejeitado na inicialização	Inspecione os logs para BOT_COMMANDS_TOO_MUCH	Reduza comandos de plugins/Skills/personalizados do Telegram ou desative menus nativos.
Após upgrade, a lista de permissões bloqueia você	openclaw security audit e listas de permissões da configuração	Execute openclaw doctor --fix ou substitua @username por IDs numéricos de remetente.

Solução de problemas completa: Solução de problemas do Telegram

# Discord

# Sinais de falha do Discord

Sintoma	Verificação mais rápida	Correção
Bot online, mas sem respostas em guild	openclaw channels status --probe	Permita a guild/canal e verifique a intent de conteúdo de mensagens.
Mensagens de grupo ignoradas	Verifique nos logs quedas por bloqueio de menção	Mencione o bot ou defina requireMention: false para a guild/canal.
Uso de digitação/token, mas sem mensagem no Discord	O log da sessão mostra texto do assistente com didSendViaMessagingTool: false	O modelo respondeu de forma privada em vez de chamar a ferramenta de mensagens. Use um modelo confiável para chamadas de ferramenta ou defina messages.groupChat.visibleReplies: "automatic" para publicar automaticamente.
Respostas de DM ausentes	openclaw pairing list discord	Aprove o pareamento de DM ou ajuste a política de DM.

Solução de problemas completa: Solução de problemas do Discord

# Slack

# Sinais 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 baseadas em SecretRef.
DMs bloqueadas	openclaw pairing list slack	Aprove o pareamento ou flexibilize a política de DM.
Mensagem de canal ignorada	Verifique groupPolicy e a lista de permissões do canal	Permita o canal ou altere a política para open.

Solução de problemas completa: Solução de problemas do Slack

# iMessage e BlueBubbles

# Sinais de falha do iMessage e BlueBubbles

Sintoma	Verificação mais rápida	Correção
Sem eventos de entrada	Verifique a acessibilidade 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 de 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 lista de permissões.

Solução de problemas completa:

• Solução de problemas do iMessage
• Solução de problemas do BlueBubbles

# Signal

# Sinais 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 de grupo não disparam	Verifique a lista de permissões do grupo e os padrões de menção	Adicione o remetente/grupo ou afrouxe o bloqueio.

Solução de problemas completa: Solução de problemas do Signal

# QQ Bot

# Sinais de falha do QQ Bot

Sintoma	Verificação mais rápida	Correção
Bot responde "foi para Marte"	Verifique appId e clientSecret na configuração	Defina as credenciais ou reinicie o Gateway.
Sem mensagens de entrada	openclaw channels status --probe	Verifique as credenciais na QQ Open Platform.
Voz não transcrita	Verifique a configuração do provedor de STT	Configure channels.qqbot.stt ou tools.media.audio.
Mensagens proativas não chegam	Verifique os requisitos de interação da plataforma QQ	A QQ pode bloquear mensagens iniciadas pelo bot sem interação recente.

Solução de problemas completa: Solução de problemas do QQ Bot

# Matrix

# Sinais 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 lista de permissões da sala e o bloqueio 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 depois confira openclaw matrix verify backup status.
Restauração de backup pendente/quebrada	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 secreto, o cross-signing e o estado do backup em uma única etapa.

Configuração completa: Matrix

# Relacionado

• Pareamento
• Roteamento de canal
• Solução de problemas do Gateway