Configuration

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:

bash

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw 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.

bash

openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw 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

Relacionados

Was this useful?