Saltar para o conteúdo principal

Solução de problemas de canal

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

Escada de comandos

Execute estes na ordem primeiro:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Linha de base saudável:
  • Runtime: running
  • RPC probe: ok
  • A sondagem do canal mostra conectado/pronto

WhatsApp

Assinaturas de falha do WhatsApp

SintomaVerificação mais rápidaCorreção
Conectado, mas sem respostas em DMopenclaw pairing list whatsappAprovar remetente ou trocar a política de DM/lista de permissões.
Mensagens de grupo ignoradasVerifique requireMention + padrões de menção na configuraçãoMencione o bot ou relaxe a política de menção para esse grupo.
Desconexões aleatórias/loops de reloginopenclaw channels status --probe + logsFaça login novamente e verifique se o diretório de credenciais está saudável.
Solução completa: /channels/whatsapp#troubleshooting-quick

Telegram

Assinaturas de falha do Telegram

SintomaVerificação mais rápidaCorreção
/start mas sem fluxo de resposta utilizávelopenclaw pairing list telegramAprovar pareamento ou alterar a política de DM.
Bot online, mas o grupo permanece silenciosoVerifique o requisito de menção e o modo de privacidade do botDesative o modo de privacidade para visibilidade no grupo ou mencione o bot.
Falhas de envio com erros de redeInspecione os logs para falhas de chamada da API do TelegramCorrija DNS/IPv6/roteamento de proxy para api.telegram.org.
Atualizado e a allowlist está bloqueando vocêopenclaw security audit e allowlists de configuraçãoExecute openclaw doctor --fix ou substitua @username por IDs numéricos de remetente.
Solução completa: /channels/telegram#troubleshooting

Discord

Assinaturas de falha do Discord

SintomaVerificação mais rápidaCorreção
Bot online, mas sem respostas no servidoropenclaw channels status --probePermita o servidor/canal e verifique a intent de conteúdo de mensagens.
Mensagens de grupo ignoradasVerifique os logs por bloqueios de mençãoMencione o bot ou defina o servidor/canal requireMention: false.
Respostas em DM ausentesopenclaw pairing list discordAprovar pareamento de DM ou ajustar a política de DM.
Solução completa: /channels/discord#troubleshooting

Slack

Assinaturas de falha do Slack

SintomaVerificação mais rápidaCorreção
Modo socket conectado, mas sem respostasopenclaw channels status --probeVerifique o token do app + token do bot e os escopos necessários.
DMs bloqueadasopenclaw pairing list slackAprovar pareamento ou relaxar a política de DM.
Mensagem de canal ignoradaVerifique groupPolicy e a lista de permissões do canalPermita o canal ou troque a política para open.
Solução completa: /channels/slack#troubleshooting

iMessage e BlueBubbles

Assinaturas de falha do iMessage e BlueBubbles

SintomaVerificação mais rápidaCorreção
Nenhum evento de entradaVerifique a alcançabilidade do webhook/servidor e as permissões do appCorrija a URL do webhook ou o estado do servidor BlueBubbles.
Consegue enviar, mas não receber no macOSVerifique as permissões de privacidade do macOS para automação do MessagesReautorize as permissões TCC e reinicie o processo do canal.
Remetente de DM bloqueadoopenclaw pairing list imessage ou openclaw pairing list bluebubblesAprovar pareamento ou atualizar a lista de permissões.
Solução completa:

Signal

Assinaturas de falha do Signal

SintomaVerificação mais rápidaCorreção
Daemon acessível, mas bot silenciosoopenclaw channels status --probeVerifique a URL/conta do daemon signal-cli e o modo de recebimento.
DM bloqueadaopenclaw pairing list signalAprovar remetente ou ajustar a política de DM.
Respostas em grupo não disparamVerifique a lista de permissões do grupo e os padrões de mençãoAdicione remetente/grupo ou afrouxe o bloqueio.
Solução completa: /channels/signal#troubleshooting

Matrix

Assinaturas de falha do Matrix

SintomaVerificação mais rápidaCorreção
Logado, mas ignora mensagens da salaopenclaw channels status --probeVerifique groupPolicy e a lista de permissões da sala.
DMs não são processadasopenclaw pairing list matrixAprovar remetente ou ajustar a política de DM.
Salas criptografadas falhamVerifique o módulo de criptografia e as configurações de criptografiaAtive o suporte à criptografia e reentre/sincronize a sala.
Solução completa: /channels/matrix#troubleshooting