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

FoneClaw no conecta con Discord: conexión, tareas y respuestas

Revisa el bot, el emparejamiento y las tareas de FoneClaw desde Discord. Recupera una respuesta guardada sin repetir acciones en Android.

Ilustración conceptual de mensajes de Discord conectados con una tarea en un teléfono Android y su respuesta, sin mostrar interfaces reales
📋 Puntos clave
  • La conexión de Discord con FoneClaw utiliza mensajes directos de texto a un bot. Distingue un fallo de conexión de una solicitud en cola, una acción pendiente o una respuesta no entregada.
  • Configura el bot con Message Content Intent, instálalo mediante OAuth2 y guarda su token en FoneClaw. Envía hello por mensaje directo en diez minutos desde la cuenta que quieres vincular.
  • Consulta /status y revisa en el teléfono permisos, aprobaciones y resultado de la tarea. Una conexión activa no demuestra que una operación Android haya terminado.
  • /retry vuelve a poner en entrega un resultado guardado, no ejecuta otra vez la tarea. /stop detiene solicitudes actuales y en cola, pero no deshace operaciones completadas.

Identifica en qué paso se interrumpió la conexión

Si FoneClaw no conecta con Discord, no reenvíes todavía la petición. Primero distingue dónde se detuvo: conexión del bot, recepción del mensaje, cola de solicitudes, ejecución en Android o entrega de la respuesta. Una tarea puede haberse completado en el teléfono aunque su resultado no aparezca en Discord.

En FoneClaw, esta entrada utiliza mensajes directos de texto a un bot. No es una conexión para llamadas de voz ni depende de reparar el micrófono o Bluetooth. Si tu problema es el audio de Discord móvil, Cómo probar el micrófono en Discord móvil y arreglar la voz trata ese recorrido distinto.

SíntomaPrimer paso que revisar
No se establece la conexión.Token, Message Content Intent y red.
El saludo no completa el emparejamiento.Mensaje directo, cuenta y plazo de diez minutos.
La petición parece esperar./status y solicitudes en cola.
La tarea necesita intervención.Permiso o aprobación en el teléfono.
El cambio existe, pero falta la respuesta.Entrega del resultado guardado, no nueva ejecución.

Conserva la petición original, su hora y cualquier aviso. Esa referencia permite comparar lo que recibiste en Discord con lo que quedó en el teléfono sin generar otro intento innecesario.

Comprueba el bot, el token y el acceso a mensajes

La configuración comienza en el portal de desarrolladores de Discord. Su documentación de bots explica la aplicación, el usuario bot, las credenciales y la instalación mediante OAuth2. Para nuestra conexión, sigue esta secuencia:

  1. Crea el bot en Discord Developer Portal.
  2. Activa Message Content Intent en la configuración del bot.
  3. Instálalo en un servidor mediante OAuth2, siguiendo la configuración requerida.
  4. Copia su token de bot.
  5. Pega el token en la conexión de Discord de FoneClaw y guarda.
  6. Continúa con el emparejamiento por mensaje directo desde tu cuenta.

La documentación de eventos e intents de Discord identifica Message Content como un intent privilegiado configurado en el portal. FoneClaw lo solicita expresamente. No actives permisos ajenos al procedimiento ni intentes sustituir este requisito por acceso de administrador.

Si el token es inválido: Discord no lo ha aceptado. Comprueba que procede del bot que instalaste y que has guardado la credencial correcta en FoneClaw. Un token de bot no es el identificador de la aplicación ni un enlace de invitación.

Si aparece un error de Message Content Intent: revisa ese ajuste en Discord, guarda el cambio y utiliza la opción de reintento de conexión indicada. No la confundas con /retry, que sirve para la entrega de resultados.

Si la conexión figura como no disponible: revisa red, token e intent antes de cambiar otras capas. No concluyas que un permiso Android de calendario explica un fallo de autenticación del bot.

El token es secreto. No lo envíes a soporte ni lo incluyas en capturas, conversaciones o registros públicos. Si quedó expuesto, rótalo desde el portal oficial y actualiza la credencial guardada. No necesitas rotarlo indiscriminadamente para investigar una tarea en cola.

Empareja la cuenta correcta por mensaje directo

Después de guardar la configuración, envía hello al bot por mensaje directo dentro de los diez minutos del emparejamiento. La conexión se vincula a la primera cuenta de Discord que envía un mensaje durante ese proceso. Utiliza desde el principio la cuenta que quieres emplear.

Antes de mandar el saludo, comprueba tu cuenta activa y el perfil del bot. Instalarlo en un servidor facilita localizarlo, pero escribir en un canal del servidor no completa esta entrada: la conexión admitida funciona únicamente mediante mensajes directos.

  1. Abre el perfil del bot que configuraste.
  2. Entra en su conversación de mensajes directos.
  3. Comprueba que estás usando tu cuenta prevista.
  4. Envía el saludo dentro del plazo.
  5. Revisa el estado de emparejamiento en FoneClaw antes de pedir una acción.

Si el plazo caducó, inicia de nuevo el emparejamiento desde FoneClaw y repite el saludo en la conversación correcta. No continúes enviando mensajes a un intento vencido esperando que el plazo se renueve por sí solo.

Si estabas en el canal equivocado, vuelve al mensaje directo. Si sospechas que otra cuenta llegó primero, revisa la vinculación antes de ejecutar tareas y vuelve a iniciar el proceso desde FoneClaw según sus controles disponibles. No presupongas que cambiar el nombre del bot cambia la cuenta vinculada.

El criterio de avance es la vinculación correcta, no simplemente que Discord muestre tu mensaje como enviado. Mantén esta comprobación separada de los permisos y las acciones del teléfono.

Revisa la cola y las decisiones pendientes en Android

Con el emparejamiento completado, envía /status en el mensaje directo. El comando muestra los recuentos de solicitudes en ejecución y en cola. Sirve para entender si hay trabajo pendiente, no para demostrar el resultado de cada acción.

Una solicitud recibida puede esperar a otras. Si aparece un aviso de cola llena, deja de añadir peticiones: espera o utiliza /stop si quieres detener las solicitudes actuales y en cola. Si la cola está deteniéndose, inténtalo más tarde, después de revisar el estado.

No respondas a una espera enviando la misma instrucción varias veces. Cada nueva petición puede convertirse en otro trabajo. Conserva el primer intento mientras determinas si está esperando, ejecutándose o pendiente de una decisión.

Abre FoneClaw en el teléfono y revisa el estado de la tarea. Una acción compatible puede necesitar un permiso Android o una aprobación según la configuración. Lee qué operación se propone y decide si corresponde a tu petición; no concedas accesos adicionales solo para eliminar un aviso.

El modelo configurado interpreta y planifica. Las herramientas compatibles habilitadas actúan con permisos Android y la política global y por herramienta. No todas las acciones solicitan confirmación de la misma forma. Cambiar un proveedor o sus controles de herramientas tampoco concede permisos del teléfono.

Las funciones de FoneClaw describen ese alcance, y nuestra documentación de seguridad explica los límites de autorización y de los efectos externos.

Comprueba además el destino: una tarea personal debe aparecer con el texto previsto; un evento requiere revisar fecha, horas y calendario. Si la conversación solo contiene una propuesta o una aprobación pendiente, todavía no tienes una operación completada. No desactives todas las restricciones de batería ni restablezcas la app como respuesta genérica a esa espera.

Recupera la respuesta sin duplicar la acción

/retry vuelve a poner en cola la entrega de un resultado guardado. No ejecuta de nuevo la tarea del teléfono. Esta diferencia es esencial cuando la operación terminó, pero la respuesta no llegó al mensaje directo.

Considera este ejemplo propuesto: pediste crear un evento llamado «Revisión de compra» con fecha, inicio, fin y calendario explícitos. No aparece la respuesta en Discord, pero al abrir el calendario encuentras el evento correcto. La acción ya produjo un efecto; falta comunicar su resultado.

  1. Localiza el evento en el teléfono y comprueba título, fecha, horas y destino.
  2. Relaciona ese elemento con la petición original y su estado en FoneClaw.
  3. Si hay una entrega fallida recuperable, utiliza /retry para entregar el resultado guardado.
  4. Comprueba si la respuesta llega al mensaje directo y conserva la verificación del evento.
  5. No vuelvas a enviar la orden de creación como sustituto del reintento de entrega.

Una nueva orden podría crear un segundo evento. Recibir por fin una respuesta tampoco implica que debas repetir la operación para «confirmarla»: la evidencia sigue siendo el elemento que has inspeccionado.

Si el comando indica que no hay una entrega fallida recuperable, significa que no existe un resultado fallido guardado disponible para ese reintento. No demuestra por sí solo que la tarea nunca se ejecutara. Revisa el estado en FoneClaw y el destino antes de decidir si hace falta una nueva petición.

Si aparece una solicitud caducada o un cambio de conexión, inspecciona primero el teléfono y la conexión actual. No presupongas que el nuevo emparejamiento recuperará automáticamente un resultado anterior. Una acción pendiente, una operación completada y una entrega no disponible necesitan decisiones diferentes.

/stop detiene solicitudes actuales y en cola, pero no borra un evento ni revierte una operación ya completada. Si necesitas corregir un efecto, identifica el elemento y haz la corrección correspondiente en su destino. Para una interrupción más amplia, Cómo detener un agente de IA en Android sin dejar tareas activas desarrolla la comprobación de lo que sigue activo.

Comprueba la recuperación y prepara un diagnóstico seguro

Después de corregir la capa identificada, realiza una comprobación acotada. Es una propuesta de diagnóstico, no una prueba de conexión realizada por nosotros. Empieza con /status: no crea un evento ni envía una comunicación externa.

Si responde, has observado la ida y vuelta de ese comando. Eso no demuestra que todas las herramientas Android funcionen. Si necesitas comprobar una solicitud ordinaria, pide solo «Propón un texto breve para recordar revisar la lista de compra; no lo guardes ni lo envíes». Revisa el texto recibido sin añadir efectos externos.

  • Confirma el bot y la cuenta emparejada.
  • Comprueba que utilizas mensajes directos, no un canal.
  • Revisa ejecución y cola antes de añadir trabajo.
  • Resuelve únicamente el permiso o la aprobación necesarios.
  • Inspecciona el destino de cualquier operación anterior.
  • Separa el reintento de entrega de una petición nueva.

Si el fallo persiste, anota la hora con zona horaria, el mensaje exacto, el paso afectado y el estado observado en el teléfono. Incluye si el emparejamiento caducó, si la cola estaba llena o deteniéndose, si había una aprobación pendiente y si el resultado existía en su destino. Identifica cada observación como comprobada o pendiente.

Retira tokens, credenciales, nombres privados y contenido de cuentas de las capturas que compartas. El modelo en línea puede procesar el contexto aportado a una tarea; no necesitas suministrar secretos para describir un error.

Para fallos de ejecución más allá de esta conexión, Cómo depurar y recuperar fallos de un agente móvil Android sin repetir acciones peligrosas amplía la revisión. Si prefieres otra entrada de mensajería, Cómo conectar FoneClaw a un bot de Telegram en Android explica su configuración independiente; no reutilices sus pasos como ajustes de Discord.

La recuperación queda verificada cuando sabes qué petición entró, qué estado tuvo, qué acción ocurrió y si su resultado se entregó. Mantén separados esos cuatro hechos antes de volver a ejecutar.