Solução de problemas de canais

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

Sequência de comandos

Primeiro, execute estes comandos na ordem indicada:

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

Referência de funcionamento saudável:

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

Após uma atualização

Use esta seção quando o Telegram, iMessage, configurações da era do BlueBubbles ou outro canal de Plugin desaparecer após uma atualização.

openclaw status --all
openclaw doctor --fix
openclaw gateway restart
openclaw status --all

Procure por plugin load failed: dependency tree corrupted; run openclaw doctor --fix em openclaw status --all. Isso significa que o canal está configurado, mas a configuração ou o carregamento do Plugin encontrou uma árvore de dependências corrompida em vez de registrar o canal. openclaw doctor --fix remove links simbólicos obsoletos de dependências do runtime do Plugin e sobreposições de autenticação obsoletas; em seguida, openclaw gateway restart recarrega um estado limpo.

Indícios de falha do WhatsApp

Sintoma	Verificação mais rápida	Correção
Conectado, mas sem respostas em MD	`openclaw pairing list whatsapp`	Aprove o remetente ou altere a política/lista de permissões de MD.
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 variáveis `HTTPS_PROXY` / `HTTP_PROXY` do Gateway	Configure um proxy acessível; use `NO_PROXY` somente para exceções.
Ciclos aleatórios de desconexão e novo login	`openclaw channels status --probe` + logs	Reconexões recentes são sinalizadas mesmo quando o canal está conectado no momento; acompanhe os logs, reinicie o Gateway e refaça o vínculo se a instabilidade continuar.
Ciclo de `status=408 Request Time-out`	Sondagem, logs, doctor e, depois, status do Gateway	Primeiro, corrija a conectividade ou a temporização do host; faça backup da autenticação e vincule novamente a conta se o ciclo persistir.
Respostas chegam segundos/minutos atrasadas	`openclaw doctor --fix`	O doctor encerra clientes TUI locais comprovadamente obsoletos quando eles estão prejudicando o loop de eventos do Gateway.

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

Indícios de falha do Telegram

Sintoma	Verificação mais rápida	Correção
`/start`, mas sem fluxo de respostas utilizável	`openclaw pairing list telegram`	Aprove o emparelhamento ou altere a política de MD.
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 dar visibilidade ao grupo ou mencione o bot.
Falhas de envio com erros de rede	Inspecione os logs em busca de falhas nas chamadas à API do Telegram	Corrija o roteamento de DNS/IPv6/proxy para `api.telegram.org`.
A inicialização informa `getMe returned 401`	Verifique a origem configurada do token	Copie novamente ou gere outra vez o token do BotFather e atualize `botToken`, `tokenFile` ou `TELEGRAM_BOT_TOKEN` da conta padrão.
A consulta fica paralisada ou demora para reconectar	Use `openclaw logs --follow` para obter diagnósticos da consulta	Atualize; se as reinicializações forem falsos positivos, ajuste `pollingStallThresholdMs`. Paralisações persistentes ainda indicam problemas de proxy/DNS/IPv6.
`setMyCommands` rejeitado na inicialização	Inspecione os logs em busca de `BOT_COMMANDS_TOO_MUCH`	Reduza os comandos do Telegram provenientes de plugins/Skills/personalizações ou desative os menus nativos.
Após a atualização, 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 remetentes.

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

Discord

Indícios 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 intenção de conteúdo das mensagens.
Mensagens de grupo ignoradas	Verifique nos logs os descartes causados pelo bloqueio por menção	Mencione o bot ou defina `requireMention: false` para o servidor/canal.
Indicação de digitação/uso de tokens, mas sem mensagem no Discord	Verifique se este é um evento de sala ambiente ou uma sala `message_tool` habilitada na qual o modelo não executou `message(action=send)`	Inspecione o log detalhado do Gateway em busca de metadados de payload final suprimido, verifique `messages.groupChat.unmentionedInbound`, leia Eventos de sala ambiente ou mantenha `messages.groupChat.visibleReplies: "automatic"` para solicitações normais de grupo.
Respostas de MD ausentes	`openclaw pairing list discord`	Aprove o emparelhamento de MD ou ajuste a política de MD.

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

Slack

Indícios de falha do Slack

Sintoma	Verificação mais rápida	Correção
Modo de socket conectado, mas sem respostas	`openclaw channels status --probe`	Verifique o token do aplicativo + o token do bot e os escopos necessários; procure por `botTokenStatus` / `appTokenStatus = configured_unavailable` em configurações baseadas em SecretRef.
MDs bloqueadas	`openclaw pairing list slack`	Aprove o emparelhamento ou flexibilize a política de MD.
Mensagem do 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

Indícios de falha do iMessage

Sintoma	Verificação mais rápida	Correção
`imsg` ausente ou falha fora do macOS	`openclaw channels status --probe --channel imessage`	Execute o OpenClaw no Mac com o Mensagens ou use um wrapper SSH para `cliPath`.
Consegue enviar, mas não receber no macOS	Verifique as permissões de privacidade do macOS para automação do Mensagens	Conceda novamente as permissões TCC e reinicie o processo do canal.
Remetente de MD bloqueado	`openclaw pairing list imessage`	Aprove o emparelhamento ou atualize a lista de permissões.

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

Signal

Indícios de falha do Signal

Sintoma	Verificação mais rápida	Correção
Daemon acessível, mas o bot está silencioso	`openclaw channels status --probe`	Verifique a URL/conta do daemon `signal-cli` e o modo de recebimento.
MD bloqueada	`openclaw pairing list signal`	Aprove o remetente ou ajuste a política de MD.
Respostas de grupo não são acionadas	Verifique a lista de permissões do grupo e os padrões de menção	Adicione o remetente/grupo ou flexibilize o bloqueio.

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

QQ Bot

Indícios de falha do QQ Bot

Sintoma	Verificação mais rápida	Correção
O bot responde que “foi para Marte”	Verifique `appId` e `clientSecret` na configuração	Defina as credenciais ou reinicie o Gateway.
Sem mensagens recebidas	`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 uma interação recente.

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

Matrix

Assinaturas de falha do Matrix

Sintoma	Verificação mais rápida	Correção
Está conectado, mas ignora mensagens da sala	`openclaw channels status --probe`	Verifique `groupPolicy`, a lista de permissões da sala e a exigência de menção.
As mensagens diretas não são processadas	`openclaw pairing list matrix`	Aprove o remetente ou ajuste a política de mensagens diretas.
As salas criptografadas falham	`openclaw matrix verify status`	Verifique o dispositivo novamente e consulte `openclaw matrix verify backup status`.
A restauração do backup está pendente/com falha	`openclaw matrix verify backup status`	Execute `openclaw matrix verify backup restore` ou repita usando uma chave de recuperação.
A assinatura cruzada/inicialização parece errada	`openclaw matrix verify bootstrap`	Corrija de uma só vez o armazenamento de segredos, a assinatura cruzada e o estado do backup.

Configuração completa: Matrix

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

Solução de problemas de canais

Sequência de comandos

Após uma atualização

WhatsApp

Indícios de falha do WhatsApp

Telegram

Indícios de falha do Telegram

Discord

Indícios de falha do Discord

Slack

Indícios de falha do Slack

iMessage

Indícios de falha do iMessage

Signal

Indícios de falha do Signal

QQ Bot

Indícios de falha do QQ Bot

Matrix

Assinaturas de falha do Matrix

Relacionados

​Sequência de comandos

​Após uma atualização

​WhatsApp

​Indícios de falha do WhatsApp

​Telegram

​Indícios de falha do Telegram

​Discord

​Indícios de falha do Discord

​Slack

​Indícios de falha do Slack

​iMessage

​Indícios de falha do iMessage

​Signal

​Indícios de falha do Signal

​QQ Bot

​Indícios de falha do QQ Bot

​Matrix

​Assinaturas de falha do Matrix

​Relacionados

Sequência de comandos

Após uma atualização

WhatsApp

Indícios de falha do WhatsApp

Telegram

Indícios de falha do Telegram

Discord

Indícios de falha do Discord

Slack

Indícios de falha do Slack

iMessage

Indícios de falha do iMessage

Signal

Indícios de falha do Signal

QQ Bot

Indícios de falha do QQ Bot

Matrix

Assinaturas de falha do Matrix

Relacionados