Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Use esta página quando um canal se conecta, mas o comportamento está incorreto.
Sequência de comandos
Execute estes primeiro, na ordem:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Runtime: runningConnectivity probe: okCapability: read-only, write-capable ou admin-capable- A sondagem do canal mostra o transporte conectado e, quando houver suporte,
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/lista de permissões de DM. |
| Mensagens de grupo ignoradas | Verifique requireMention + padrões de menção na configuração | Mencione o bot ou relaxe a política de menção para esse grupo. |
| Login por QR expira com 408 | Verifique as envs HTTPS_PROXY / HTTP_PROXY do Gateway | Defina um proxy acessível; use NO_PROXY apenas para bypasses. |
| Loops aleatórios de desconexão/relogin | 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. |
| 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. |
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 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 em busca de falhas de chamadas à 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 configurada | Copie novamente ou gere outra vez 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 em busca de BOT_COMMANDS_TOO_MUCH | Reduza comandos de plugins/Skills/personalizados do Telegram ou desative menus nativos. |
| Após 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 remetente. |
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 quedas por bloqueio de menção | Mencione o bot ou defina requireMention: false para servidor/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 em privado em vez de chamar a ferramenta de mensagem. 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. |
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 baseadas em SecretRef. |
| DMs bloqueadas | openclaw pairing list slack | Aprove o pareamento ou relaxe a política de DM. |
| Mensagem de canal ignorada | Verifique groupPolicy e a lista de permissões de canais | Permita o canal ou altere a política para open. |
iMessage
Assinaturas 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 do Messages 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 Messages | Conceda novamente permissões TCC e reinicie o processo do canal. |
| Remetente de DM bloqueado | openclaw pairing list imessage | Aprove o pareamento ou atualize a lista de permissões. |
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 de grupo não disparam | Verifique a lista de permissões do grupo e padrões de menção | Adicione remetente/grupo ou afrouxe o bloqueio. |
QQ Bot
Assinaturas 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. |
| Nenhuma mensagem recebida | openclaw channels status --probe | Verifique as credenciais na QQ Open Platform. |
| Voz não transcrita | Verifique a configuração do provedor 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. |
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 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 passada. |
Relacionado
