Cómo conectar FoneClaw a un bot de Telegram en Android
Guía para crear un bot con BotFather, conectar tu cuenta privada a FoneClaw, probar una tarea Android compatible y resolver errores de token, red o webhook.
- Para conectar FoneClaw a Telegram necesitas crear un bot dedicado con BotFather y guardar su token de forma privada.
- La conexión funciona con chats privados: después de guardar el token, abre tu propio bot, envía literalmente hello dentro de los diez minutos y espera la confirmación.
- Que el chat responda no basta; conviene comprobar una acción Android compatible y verificar el resultado guardado en FoneClaw.
- Si algo falla, separa errores de token, bot equivocado, bot ya en uso, red y conflictos de webhook antes de cambiar la configuración.
Crear un bot dedicado en Telegram
Conectar FoneClaw a un bot de Telegram no es lo mismo que controlar la app Telegram por voz. Aquí el bot funciona como una entrada privada de conversación: tú escribes al bot y FoneClaw recibe esa petición para intentar resolver una acción Android compatible. Si lo que buscas es dictar mensajes dentro de Telegram, consulta primero Telegram con control de voz: guía de FoneClaw, porque es un flujo distinto.
Empieza en Telegram con el bot oficial BotFather. Abre @BotFather, envía /newbot y sigue las instrucciones para elegir nombre y usuario del bot. Al final recibirás un token único. Ese token autentica al bot: no es tu contraseña personal de Telegram ni un código de inicio de sesión, pero debe tratarse como una credencial privada. No lo publiques, no lo pegues en chats compartidos y no reutilices un bot que ya esté conectado a otro servicio.
La opción más limpia es crear un bot dedicado solo para FoneClaw. Así evitas conflictos con otros servicios, webhooks o automatizaciones que ya estén usando ese bot. También te resultará más fácil saber qué conversación está vinculada a tu teléfono y qué bot debes abrir cuando llegue el momento de emparejar la cuenta.
Vincular tu cuenta privada
Después de crear el bot, abre FoneClaw y busca Telegram Connections. Pega el token de BotFather en BotFather token y usa Save bot token para guardarlo.
Al guardar el token, el siguiente paso ocurre en Telegram. Abre tu propio bot, no BotFather, y envía literalmente hello dentro de los diez minutos. Espera la confirmación de vinculación antes de empezar a pedir tareas. Si la ventana caduca, toca Connect this chat en el teléfono para abrir una nueva ventana indicada y vuelve a enviar hello a tu propio bot dentro de esos diez minutos. La conexión es para chats privados: no está pensada para grupos ni canales.
El primer usuario que escribe al bot durante el emparejamiento queda vinculado. Por eso conviene hacer el proceso tú mismo, desde la cuenta de Telegram que quieres usar con FoneClaw. Si otra persona escribe primero al bot, la conexión puede quedar asociada a esa cuenta. Si usas varios bots, comprueba el nombre de usuario del bot antes de enviar hello; guardar el token de un bot y escribir a otro es una causa común de confusión.
Comprobar un resultado Android compatible
Una vez vinculada la conversación, prueba algo pequeño. No empieces por acciones sensibles ni por una cadena larga de tareas. Escribe al bot una petición sin fecha, día ni referencia temporal, por ejemplo: “Guarda una tarea personal: revisar presupuesto de viaje”. Esa frase permite comprobar si el mensaje llega, si FoneClaw puede resolver una acción compatible y si la tarea aparece como elemento visible sin inventar una fecha.
El chat de Telegram solo confirma que la petición llegó al bot. La acción real ocurre en FoneClaw en Android y puede requerir permisos o aprobación dentro de la app, según la tarea. Emparejar un bot no concede por sí solo permisos de Android, acceso a todas tus apps ni aprobación remota para cualquier cambio.
Después de pedir la tarea, abre FoneClaw y comprueba el resultado guardado. Si no diste fecha, la tarea debe quedar sin programar, visible como una tarea pendiente sin vencimiento. La guía Tareas de IA en Android sin fecha: guardar y corregir explica cómo revisar y corregir ese tipo de elemento. Si esta es tu primera acción con FoneClaw, Cómo usar FoneClaw gratis en Android: instalación y primera tarea desarrolla el recorrido básico de permisos, aprobación y comprobación.
Diagnosticar el error de conexión concreto
Si la conexión falla, cambia una cosa cada vez. Un error de token no se resuelve escribiendo más mensajes al bot, y un conflicto de webhook no se resuelve pegando el mismo token otra vez. Usa la señal del error para decidir el siguiente paso.
| Señal | Qué suele significar | Qué hacer |
|---|---|---|
| Token rechazado | El token está incompleto, revocado, mal copiado o no pertenece al bot correcto. | Vuelve a BotFather, copia el token completo y guárdalo de nuevo en FoneClaw. |
| No llega la confirmación tras “hello” | Escribiste a BotFather, a otro bot o fuera de la ventana de vinculación. | Toca Connect this chat en el teléfono, envía hello a tu propio bot durante la nueva ventana de diez minutos y espera la confirmación. |
| Bot ya conectado | Ese bot ya está en uso por una conexión existente. | Usa un bot dedicado nuevo o elimina la conexión anterior si corresponde. |
| Telegram no está disponible | Hay un problema de red o de acceso a Telegram. | Comprueba conexión, VPN si aplica y vuelve a intentar cuando Telegram responda. |
| Conflicto con poller o webhook | Otro servicio ya recibe actualizaciones de ese bot. | Usa un bot nuevo. Quita el webhook solo si quieres detener ese otro servicio. |
Eliminar un webhook cambia el comportamiento del bot: las actualizaciones dejan de entregarse al endpoint que estaba usando el otro servicio. Si ese bot ya es importante para otra automatización, es más seguro crear un bot dedicado para FoneClaw en BotFather.
Pausar, reanudar o eliminar la conexión
Cuando la conexión ya funciona, puedes gestionarla sin recrear todo desde cero. El control Pause connection sirve para detener temporalmente la entrada desde Telegram. Mientras esté pausada, tendrás que usar Resume connection antes de volver a enviar tareas desde el bot. Actualizar el token de una conexión existente conserva la vinculación y el historial de chat local.
Eliminar una conexión es una decisión más fuerte. Al quitarla, se borra el token guardado en FoneClaw, las solicitudes en cola y los registros de entrega asociados a esa conexión. El historial local de chat se conserva, pero el bot deja de estar conectado hasta que vuelvas a configurarlo. Si el token quedó expuesto, eliminar la conexión local no revoca por sí solo esa credencial en Telegram; usa un bot dedicado nuevo o gestiona el token desde BotFather.
La conexión de Telegram no convierte FoneClaw en una automatización siempre activa ni abre acceso a todos tus chats personales. Es una entrada privada para enviar solicitudes a FoneClaw. Las acciones Android compatibles siguen dependiendo del modelo configurado, los permisos relevantes y las aprobaciones aplicables. Para revisar qué tipos de tareas admite FoneClaw, consulta las funciones de FoneClaw. Para instalar o actualizar la app desde la fuente actual, usa descargar FoneClaw.
La regla práctica es simple: crea un bot dedicado, protege el token, vincula tu propia cuenta privada y verifica una primera tarea pequeña. Si esa tarea aparece guardada en FoneClaw, ya sabes que el bot no solo responde, sino que la petición llegó hasta una acción Android compatible.