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

Execute estes primeiro, na ordem:

bash

OmeniaClaw statusOmeniaClaw gateway statusOmeniaClaw logs --followOmeniaClaw doctorOmeniaClaw channels status --probe

Linha de base saudável:

Runtime: running
Connectivity probe: ok
Capability: read-only, write-capable ou admin-capable
A sondagem do canal mostra o transporte conectado e, quando houver suporte, works ou audit ok

Assinaturas de falha do WhatsApp

Sintoma	Verificação mais rápida	Correção
Conectado, mas sem respostas em DM	`OmeniaClaw 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	`OmeniaClaw 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	`OmeniaClaw doctor --fix`	O doctor interrompe clientes TUI locais obsoletos verificados quando eles estão degradando o loop de eventos do Gateway.

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

Assinaturas de falha do Telegram

Sintoma	Verificação mais rápida	Correção
`/start`, mas sem fluxo de resposta utilizável	`OmeniaClaw 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	`OmeniaClaw 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ê	`OmeniaClaw security audit` e listas de permissões da configuração	Execute `OmeniaClaw doctor --fix` ou substitua `@username` por IDs numéricos de remetente.

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

Discord

Assinaturas de falha do Discord

Sintoma	Verificação mais rápida	Correção
Bot online, mas sem respostas no servidor	`OmeniaClaw 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	`OmeniaClaw pairing list discord`	Aprove o pareamento de DM ou ajuste a política de DM.

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

Slack

Assinaturas de falha do Slack

Sintoma	Verificação mais rápida	Correção
Socket mode conectado, mas sem respostas	`OmeniaClaw 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	`OmeniaClaw 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`.

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

iMessage

Assinaturas de falha do iMessage

Sintoma	Verificação mais rápida	Correção
`imsg` ausente ou falha fora do macOS	`OmeniaClaw channels status --probe --channel imessage`	Execute o OmeniaClaw 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	`OmeniaClaw pairing list imessage`	Aprove o pareamento ou atualize a lista de permissões.

Solução de problemas completa:

Solução de problemas do iMessage

Signal

Assinaturas de falha do Signal

Sintoma	Verificação mais rápida	Correção
Daemon acessível, mas bot silencioso	`OmeniaClaw channels status --probe`	Verifique a URL/conta do daemon `signal-cli` e o modo de recebimento.
DM bloqueada	`OmeniaClaw 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.

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

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

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
Logado, mas ignora mensagens da sala	`OmeniaClaw channels status --probe`	Verifique `groupPolicy`, a lista de permissões da sala e o bloqueio por menção.
DMs não são processadas	`OmeniaClaw pairing list matrix`	Aprove o remetente ou ajuste a política de DM.
Salas criptografadas falham	`OmeniaClaw matrix verify status`	Verifique novamente o dispositivo e depois confira `OmeniaClaw matrix verify backup status`.
Restauração de backup pendente/quebrada	`OmeniaClaw matrix verify backup status`	Execute `OmeniaClaw matrix verify backup restore` ou rode novamente com uma chave de recuperação.
Cross-signing/bootstrap parece incorreto	`OmeniaClaw matrix verify bootstrap`	Repare o armazenamento secreto, o cross-signing e o estado do backup em uma única passada.

Configuração e setup completos: Matrix

Relacionado

Was this useful?