Cómo conectar tu agente de IA a Telegram (guía completa de configuración)

¿Por qué Telegram?

Telegram es el canal recomendado para tu agente OpenClaw por varias razones. Tiene una API de bots madura y bien documentada, funciona en todas las plataformas (iOS, Android, escritorio, web), admite formato de mensajes, compartir archivos y teclados inline, y la creación de bots es completamente gratuita sin proceso de aprobación.

Lo más importante: los mensajes de Telegram entre tú y tu bot son privados. OpenClaw se comunica con los servidores de Telegram para entregar tus mensajes, pero el modelo de IA solo procesa lo que envías — tu historial de conversaciones permanece en tu VPS.

Paso 1: crear tu bot de Telegram

Abre Telegram y busca @BotFather — el servicio oficial de creación de bots de Telegram. Inicia una conversación y envía:

/newbot

BotFather te pedirá:

1. Un nombre para tu bot — este es el nombre que la gente ve (ej. "Mi Asistente IA")
2. Un nombre de usuario — debe terminar en "bot" (ej. "miasistente_bot")

Tras confirmar ambos, BotFather te envía un token de bot — una cadena larga como 1234567890:ABCdefGHIjklMNOpqrSTUvwxYZ. Cópialo y guárdalo inmediatamente.

Paso 2: configurar la privacidad del bot

Por defecto, los bots en grupos reciben todos los mensajes. Para un agente personal, conviene mantenerlo enfocado. En BotFather:

/setprivacy

Selecciona tu bot y elige Enable. Esto significa que tu bot solo recibirá mensajes dirigidos a él (que comiencen con / o que lo mencionen). Para uso personal en mensajes directos, esta configuración no afecta a nada, pero es una buena práctica.

También considera establecer una descripción y una foto de perfil:

/setdescription
/setuserpic

Paso 3: obtener tu ID de usuario de Telegram

OpenClaw necesita saber qué cuenta de Telegram está autorizada a interactuar con tu agente — no querrás que cualquiera pueda enviarle mensajes a tu IA personal. Para obtener tu ID de usuario, abre un chat con @userinfobot y envía /start. Responde con tu ID numérico de usuario.

Anótalo. Durante la instalación de k-claw, proporcionarás este ID como usuario autorizado.

Paso 4: instalar OpenClaw mediante k-claw

Con tu token de bot y tu ID de usuario listos, ejecuta el instalador de k-claw en tu VPS:

curl -fsSL https://claw.krokanti.com/install | bash

Cuando el instalador pregunte por tu canal de mensajería, selecciona Telegram. Te pedirá:

• Tu token de bot (de BotFather)
• Tu ID de usuario de Telegram (de @userinfobot)
• Tu clave de API de IA
• El modelo de IA que quieres usar

El instalador configura OpenClaw, establece el servicio systemd y arranca tu agente automáticamente.

Paso 5: empieza a chatear

Abre Telegram y busca tu bot por su nombre de usuario. Envía /start para iniciarlo y luego pregunta lo que quieras:

¿Cuál es la capital de Australia?
Resume los puntos clave del último correo que te compartí.
Recuérdame mañana a las 9:00 revisar la propuesta del proyecto.

Tu agente responde directamente en el chat, con el modelo de IA procesando cada mensaje vía API y el historial de conversaciones almacenado de forma privada en tu VPS.

Comandos útiles del bot

OpenClaw incluye varios comandos integrados que puedes configurar en BotFather para mejorar la experiencia de usuario:

/setcommands

Luego pega:

start - Inicializar el agente
help - Mostrar los comandos disponibles
memory - Mostrar lo que recuerda el agente
clear - Borrar el contexto de la conversación
status - Comprobar el estado del agente

Solución de problemas

Problemas comunes tras la configuración:

• El bot no responde: Comprueba el servicio systemd — systemctl status kclaw-agent. Busca errores en los registros con journalctl -u kclaw-agent -n 50.
• Error de token inválido: Asegúrate de haber copiado el token completo de BotFather sin espacios adicionales.
• Error de usuario no autorizado: Verifica que tu ID de usuario de Telegram coincida con el que proporcionaste durante la instalación. Los IDs son solo números.
• Límites de velocidad de la API: Si envías muchos mensajes rápidamente, la API de IA puede limitar las solicitudes. OpenClaw gestiona los reintentos automáticamente, pero los tiempos de respuesta pueden ralentizarse temporalmente.

El panel de k-claw muestra el estado de tu instalación y los registros en tiempo real, lo que facilita diagnosticar cualquier problema sin necesidad de acceder al servidor por SSH.