Agente de IA
📅 2026-10-07 ⏱️ 10 min Dean Dean

FoneClaw Discord não conecta: como recuperar a conexão no Android

Corrija a conexão do agente de IA FoneClaw ao Discord: confira bot, pareamento, fila e entrega do resultado sem repetir ações no Android.

Ilustração conceitual de mensagens do Discord chegando a um celular Android, com etapas de conexão, tarefa e entrega do resultado
📋 Pontos-chave
  • A conexão usa mensagens diretas de texto com um bot; verifique token, Message Content Intent e pareamento antes de investigar a execução no telefone.
  • Após salvar a configuração, envie uma mensagem direta em até dez minutos pela conta desejada: a primeira conta que enviar uma mensagem fica vinculada.
  • Use /status para distinguir tarefas em execução e na fila; confira no Android qualquer aprovação ou permissão pendente.
  • /retry tenta entregar um resultado salvo, sem executar novamente a tarefa; /stop interrompe solicitações atuais e enfileiradas, mas não desfaz operações concluídas.

Descubra em qual etapa ocorreu a falha

Se a FoneClaw não conecta ao Discord, comece separando conexão, recebimento do pedido, fila, execução no Android e entrega da resposta. Nossa integração usa um bot por mensagens diretas de texto. Ela não é uma conexão de chamada de voz: ajustes de microfone ou Bluetooth não corrigem esse fluxo.

A ausência de uma resposta no Discord também não prova que a tarefa deixou de acontecer. Preserve o pedido original e confira seu estado no telefone antes de enviá-lo novamente, principalmente se ele podia criar uma tarefa ou um evento.

SintomaEtapa a conferirPróxima verificação
Token rejeitado ou conexão indisponívelConexão do botToken, rede e Message Content Intent.
Mensagem enviada, mas sem pareamentoEntrada por mensagem diretaConversa, conta remetente e prazo de dez minutos.
Pedido recebido, mas ainda não executadoFila ou tarefa/status e estado no telefone.
Execução aguardando decisãoAprovação ou permissãoSolicitação pendente na FoneClaw ou no Android.
Resultado no telefone, mas não no DiscordEntregaResultado salvo e possibilidade de /retry.

Uma resposta a /status ajuda a verificar o caminho de mensagens, mas não comprova que uma ação Android específica esteja autorizada. Use cada evidência apenas para a etapa que ela demonstra. A configuração e as capacidades disponíveis estão descritas nos recursos da FoneClaw.

Confira o bot, o token e o acesso às mensagens

Revise a configuração na ordem abaixo. O guia oficial de bots do Discord explica o uso do portal de desenvolvedores, da credencial do bot e da instalação por OAuth2. Para a conexão da FoneClaw, siga os requisitos nomeados, sem adicionar permissões administrativas como tentativa genérica de correção.

  1. Crie o bot no portal de desenvolvedores do Discord. Confira se está trabalhando no aplicativo e no bot que pretende conectar.
  2. Ative Message Content Intent. Essa é a configuração solicitada para o fluxo de mensagens da FoneClaw.
  3. Instale o bot em um servidor por OAuth2. Essa etapa de instalação não transforma canais do servidor em entradas suportadas para os pedidos.
  4. Copie o token do bot. Não use outra credencial do aplicativo no lugar dele.
  5. Cole o token na configuração do Discord na FoneClaw e salve. Em seguida, faça o pareamento por mensagem direta.

Se aparecer um erro de token inválido, o Discord não aceitou a credencial fornecida. Confira se ela pertence ao bot correto e foi transferida integralmente para a configuração. Não regenere o token apenas para testar uma hipótese de fila ou aprovação: trocar a credencial não resolve essas etapas.

Se o erro mencionar Message Content Intent, ative essa opção no portal e use a tentativa de reconexão indicada pela FoneClaw. A documentação de eventos e intents do Discord identifica o acesso ao conteúdo de mensagens como um intent privilegiado. Respeite eventuais exigências da plataforma, sem tentar contorná-las.

Para uma conexão indisponível, confira rede, token e intent. Registre qual erro aparece depois de cada ajuste, em vez de mudar tudo ao mesmo tempo. O sinal esperado é conseguir prosseguir com a conexão e o pareamento, não apenas ver o bot instalado no servidor.

Mantenha o token fora de capturas, conversas e registros enviados a terceiros. Se ele tiver sido exposto, substitua-o no portal oficial e atualize a configuração na FoneClaw. A credencial é necessária para autenticar o bot, não para compartilhar um diagnóstico.

Faça o pareamento com a conta correta

Depois de salvar a configuração, abra o Discord na conta que você deseja vincular. Acesse o perfil do bot instalado e abra uma mensagem direta com ele. Envie uma saudação curta dentro do prazo de dez minutos. O pareamento fica associado à primeira conta do Discord que enviar uma mensagem.

Essa primeira mensagem tem uma consequência importante: ela seleciona a conta vinculada. Se você usa contas diferentes para trabalho e uso pessoal, confira qual está ativa antes de enviar. Não peça a outra pessoa que mande a primeira mensagem apenas para verificar se o bot responde.

Escrever em um canal do servidor não substitui a mensagem direta. Mesmo que o bot apareça na lista de membros, o fluxo suportado pela FoneClaw é a conversa privada com ele. Compare o destinatário da conversa com o bot configurado, sobretudo se houver bots com nomes parecidos.

Se o prazo expirar, inicie o pareamento novamente pela FoneClaw e envie a mensagem na conversa correta dentro da nova janela. Se você escreveu no lugar errado, volte à configuração e confira se ainda há um pareamento válido ou se é necessário reiniciá-lo. Repetir saudações em vários canais não corrige o vínculo.

Quando houver dúvida sobre a conta utilizada, resolva essa etapa antes de enviar pedidos que alterem o telefone. Não presuma que uma mensagem de outra conta substituirá automaticamente o vínculo anterior. Confira a configuração apresentada pela FoneClaw e use a conta pretendida no novo procedimento.

Após o pareamento, uma consulta de estado é um próximo passo limitado. Se ela funcionar, você pode investigar a fila e a tarefa separadamente, sem recriar o bot.

Separe fila, aprovação e execução no Android

Envie /status na mensagem direta vinculada. O comando mostra as quantidades de solicitações em execução e enfileiradas. Use essas informações para distinguir um pedido aguardando sua vez de uma tarefa que já começou. Não trate o silêncio momentâneo como motivo suficiente para reenviar a instrução.

Uma resposta de fila cheia pede que você espere ou, se quiser interromper o trabalho pendente, use /stop. Se a fila estiver sendo interrompida, tente mais tarde. Enviar várias cópias do mesmo pedido não aumenta a capacidade da fila e torna mais difícil relacionar cada resultado à solicitação original.

Depois, abra a FoneClaw no telefone e confira o estado da tarefa. Um pedido recebido pelo Discord ainda pode aguardar aprovação ou uma permissão do Android. Revise a ação apresentada e conceda apenas o acesso necessário caso queira prosseguir. A autorização efetiva depende da política global e dos ajustes por ferramenta; nem toda ação tem o mesmo comportamento de aprovação.

O modelo configurado interpreta e planeja, enquanto as ferramentas habilitadas realizam ações suportadas. A credencial do bot não concede acesso ao calendário, e mudar a configuração do modelo não substitui uma permissão Android ausente. Procure o bloqueio no ponto em que a tarefa parou.

Confira também o resultado no destino. Para um ToDo, abra o item e compare o texto e a data; sem prazo inequívoco, ele deve permanecer em Sem data definida. Para calendário, revise conta, calendário, dia e horários. Uma tarefa concluída no telefone e uma resposta entregue no Discord são evidências diferentes.

Evite desativar todas as restrições do aparelho ou redefinir dados como primeira tentativa. Se a falha ocorre na execução, e não na conexão, o guia Como depurar e recuperar falhas de agentes de IA no celular Android aprofunda essa investigação. Preserve as informações da solicitação enquanto identifica o bloqueio.

Recupere a entrega sem duplicar a ação

Use /retry para colocar um resultado salvo novamente na fila de entrega. Esse comando não executa outra vez a tarefa no telefone. A distinção é essencial quando a operação terminou, mas a resposta não chegou à conversa do Discord.

Considere um exemplo: você pediu um evento de calendário com data e horários definidos. A FoneClaw realizou a criação, porém a entrega da resposta falhou. Se você enviar novamente “crie o evento”, estará fazendo uma nova solicitação de execução e poderá gerar uma duplicata. Recuperar a resposta existente é outro trabalho.

  1. Abra o destino no telefone. Procure o evento ou item que a primeira tentativa poderia ter criado.
  2. Compare os dados. Confira título, data, horários, conta e calendário, sem assumir que um item parecido é o resultado certo.
  3. Examine o estado da tarefa. Diferencie conclusão, falha e situação ainda incerta.
  4. Use /retry para a entrega recuperável. A resposta de que o resultado foi enfileirado não significa que a mensagem já chegou ao Discord; confira a conversa depois.

Se a resposta indicar que não existe entrega com falha recuperável, não há um resultado salvo nessa condição para reenviar. Isso não prova, sozinho, que a operação no telefone falhou ou que nenhum item foi criado. A inspeção do destino continua necessária.

Uma indicação de solicitação expirada ou conexão alterada também exige revisar o telefone e a conexão antes de fazer outro pedido. Não conte com a entrega de um resultado antigo em qualquer novo vínculo. Preserve o que já foi confirmado e decida se falta apenas comunicação ou uma ação realmente não executada.

Quando não há item no destino e você confirmou que a solicitação anterior não continua em execução nem na fila, avalie um novo pedido delimitado. Se o estado ainda for incerto, interrompa a sequência de tentativas e investigue. A falta de uma mensagem final não é motivo suficiente para repetir uma escrita.

/stop interrompe solicitações atuais e enfileiradas, mas não desfaz operações concluídas. Um evento já criado precisa ser revisado no destino. Essa fronteira também consta na documentação de segurança da FoneClaw. Para conferir o que permaneceu após uma interrupção, consulte Como parar um agente de IA no Android e verificar o que continuou.

Verifique a recuperação e reúna o diagnóstico

O procedimento abaixo é uma proposta de verificação na sua configuração, não um relato de testes de conexão realizados por nós. Comece com uma consulta que não altera o telefone: após revisar bot e pareamento, envie /status uma vez na conversa vinculada e confira a resposta.

Se precisar avaliar o caminho de uma solicitação comum, peça apenas um texto curto, por exemplo uma proposta de tarefa pessoal sem salvamento, envio ou criação de evento. Confira na FoneClaw se o pedido apareceu e qual estado assumiu. Assim, você separa o recebimento e a entrega de uma operação que mudaria dados.

Antes de pedir ajuda, reúna um diagnóstico pequeno e útil:

  • Etapa: conexão, pareamento, recebimento, fila, aprovação, execução ou entrega.
  • Erro exato: copie a mensagem apresentada, removendo credenciais e conteúdo privado.
  • Horário: anote quando enviou o pedido e quando observou a falha.
  • Estado: registre as quantidades mostradas por /status e qualquer decisão pendente no telefone.
  • Destino: informe se o item esperado existe, não existe ou ainda não pôde ser confirmado.
  • Tentativa anterior: indique se usou /retry, /stop ou enviou um novo pedido.

O token do bot e credenciais de provedores nunca devem acompanhar essas informações. Oculte também mensagens pessoais, dados de calendário e outros detalhes desnecessários em capturas. Um diagnóstico deve mostrar o ponto da falha, não expor o conteúdo inteiro da tarefa.

Se o problema real for áudio em chamadas, siga Como testar o microfone no Discord móvel e corrigir áudio no Android; esse é um fluxo separado. Para configurar outro canal de mensagens, use Como conectar a FoneClaw a um bot do Telegram, sem transferir para ele os requisitos específicos do Discord.

Considere a recuperação confirmada quando conseguir identificar a conta vinculada, observar o estado do pedido e verificar o resultado correspondente. Se apenas a entrega falhou, recupere a entrega; se a execução está bloqueada, resolva o bloqueio no telefone. Essa separação evita transformar uma falha de comunicação em ações duplicadas.