---
read_when:
    - O transporte do canal diz conectado, mas as respostas falham
    - Você precisa de verificações específicas do canal antes de consultar a documentação aprofundada do provider
summary: Solução rápida de problemas no nível do canal com assinaturas de falha e correções por canal
title: Solução de problemas de canal
x-i18n:
    generated_at: "2026-04-05T12:36:36Z"
    model: gpt-5.4
    provider: openai
    source_hash: d45d8220505ea420d970b20bc66e65216c2d7024b5736db1936421ffc0676e1f
    source_path: channels/troubleshooting.md
    workflow: 15
---

# 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:

```bash
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 probe do canal mostra o transporte conectado e, quando compatível, `works` ou `audit ok`

## WhatsApp

### 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. |

Solução de problemas completa: [/channels/whatsapp#troubleshooting](/channels/whatsapp#troubleshooting)

## 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. |

Solução de problemas completa: [/channels/telegram#troubleshooting](/channels/telegram#troubleshooting)

## 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.        |

Solução de problemas completa: [/channels/discord#troubleshooting](/channels/discord#troubleshooting)

## 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`.                                                                                                 |

Solução de problemas completa: [/channels/slack#troubleshooting](/channels/slack#troubleshooting)

## 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.            |

Solução de problemas completa:

- [/channels/imessage#troubleshooting](/channels/imessage#troubleshooting)
- [/channels/bluebubbles#troubleshooting](/channels/bluebubbles#troubleshooting)

## 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.     |

Solução de problemas completa: [/channels/signal#troubleshooting](/channels/signal#troubleshooting)

## 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. |

Solução de problemas completa: [/channels/qqbot#troubleshooting](/channels/qqbot#troubleshooting)

## 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. |

Configuração e instalação completas: [Matrix](/channels/matrix)
