Integración de OpenClaw con Telegram: guía completa desde la creación del Bot hasta la configuración

¿Quieres preguntarle directamente a un asistente de IA en Telegram, sin abrir el navegador, iniciar sesión en un sitio web ni esperar a que cargue? Con OpenClaw y un Telegram Bot puedes lograrlo en media hora. No necesitas saber desarrollo backend ni preocuparte por la configuración del servidor.

Este artículo te guía paso a paso desde la creación del Bot con BotFather, la obtención del Token, la configuración de OpenClaw y la lista blanca de seguridad, hasta las pruebas finales. Incluye errores que ya hemos cometido y métodos para resolver problemas habituales. En 30 minutos tendrás un asistente de IA personal disponible las 24 horas.

Guía de bajo coste para «criar tu langosta»: ArkClaw democratiza los agentes de IA

OpenClaw (la langosta) es muy útil, pero su configuración puede disuadir. ArkClaw de Volcano Engine de ByteDance baja el listón al mínimo. Sin servidor ni Token que configurar: con un clic tienes un «asistente de IA» en línea 24/7 que controla el navegador, ejecuta scripts y gestiona el calendario.

Lo mejor es el precio: solo 9,9 yuanes al mes; con mi código de invitación ZLKUK54M (regístrate aquí) pagas 8,9 yuanes. Si eres desarrollador, el Coding Plan Pro puede salir gratis.

Preparación: conceptos básicos que debes conocer

Antes de ponerte manos a la obra, aclaremos unos conceptos clave. No es teoría aburrida: entenderlos te ahorrará muchos tropiezos.

Un Telegram Bot no es una cuenta normal. Es más bien una interfaz de robot con respuestas automáticas: recibe mensajes y envía respuestas, pero no puede iniciar conversaciones por su cuenta. Piensa en un bot de atención al cliente: solo responde cuando le preguntas.

¿Quién es BotFather? Es la «fábrica de Bots» oficial de Telegram. Todos los Bots nacen aquí. BotFather es en sí un Bot; hablando con él creas y configuras el tuyo. La primera vez me pareció curioso: un Bot para gestionar otros Bots.

¿Qué papel juega OpenClaw? En pocas palabras, es el puente entre Telegram y los modelos de IA. Telegram recibe el mensaje, OpenClaw lo reenvía a Claude o GPT y devuelve la respuesta a Telegram. Todo el flujo sin escribir código.

Lo que necesitas tener listo:

• Una cuenta de Telegram (supongo que ya la tienes)
• OpenClaw instalado y en ejecución (si aún no lo tienes, consulta la documentación oficial o mi tutorial de instalación)
• API Key de un modelo de IA (Claude, GPT, Gemini; también puedes probar con cuota gratuita)

En la práctica, la preparación no es complicada. OpenClaw admite varias plataformas (Telegram, WhatsApp, WeChat, etc.) y varios modelos de IA; una vez configurado, cambiar de modelo es sencillo.

Paso 1: crea tu Telegram Bot con BotFather

Empecemos. Abre Telegram, busca @BotFather y verifica la marca azul de cuenta oficial. No te equivoques de cuenta: hay imitaciones.

El flujo para crear el Bot es muy simple:

1. Envía a BotFather el comando /newbot
2. Te pedirá el nombre visible del Bot; elige uno que te guste, por ejemplo «Mi asistente de IA»
3. Luego el nombre de usuario: debe terminar en bot y ser único en toda la red. La primera vez probé AIAssistantBot y ya estaba ocupado; tuve que intentarlo tres o cuatro veces

Si aparece «username already taken», prueba con números o tus iniciales, por ejemplo MyAwesomeAI2024Bot.

Obtener el Bot Token es el paso más crítico. Tras crearlo, BotFather te enviará una cadena larga con un formato similar a:

123456789:ABCdefGHIjklMNOpqrsTUVwxyz1234567890

Ese Token es como la llave de tu casa. He visto gente subirlo por error a un repositorio público de GitHub y agotar la cuota en poco tiempo, con pérdidas de cientos de yuanes. Cópialo de inmediato a un gestor de contraseñas o a notas cifradas; no lo envíes por chat ni lo guardes en texto plano en la nube.

Configuración opcional pero recomendada:

• Con /setdescription define la descripción que verán al abrir el Bot
• Con /setabouttext el texto «Acerca de»
• Con /setuserpic sube un avatar para darle un aspecto más profesional

¡No olvides obtener tu ID de usuario de Telegram! Lo necesitarás para la lista blanca. Busca @userinfobot en Telegram, envíale /start y te devolverá un ID numérico como 123456789. Anótalo también.

Paso 2: configura el canal Telegram de OpenClaw

Con el Bot Token en mano, toca configurar OpenClaw. Parece técnico, pero en realidad es editar un archivo JSON.

Localiza el archivo de configuración. En 2026, el directorio de estado por defecto de OpenClaw suele ser ~/.openclaw/ y el archivo principal openclaw.json. Los nombres y la jerarquía de Telegram están en la documentación oficial del canal Telegram; rutas antiguas como ~/.clawdbot/config/channels.json corresponden al nombre anterior: si aún las usas, migra según la guía de la serie. En Docker, confirma que montas OPENCLAW_HOME / ~/.openclaw.

Railway - Plataforma de despliegue moderna, sin ops complejas, en producción en minutos

Empezar ahora →Anuncio

A continuación un ejemplo ilustrativo (uso personal, permitir explícitamente tu ID, sin depender solo del pairing). Las claves y valores por defecto (p. ej. DM en pairing) dependen de la documentación oficial y del archivo generado por el asistente; no copies estructuras obsoletas:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN_HERE",
      "dmPolicy": "allowlist",
      "allowFrom": [123456789]
    }
  }
}

Descripción de campos (alineada con lo oficial):

• botToken: Token copiado de BotFather; sin espacios ni saltos de línea
• dmPolicy / allowFrom: controlan quién puede enviar mensajes privados; para uso personal conviene allowlist + tu ID numérico. Con el valor por defecto pairing, el primer mensaje privado requiere openclaw pairing approve telegram <CODE> en el gateway (véase la documentación)
• enabled: activa o desactiva el canal

¿Cómo editar el archivo?

En Linux o Mac:

nano ~/.openclaw/openclaw.json

Con Docker, entra al contenedor y edita el archivo montado (la ruta interna depende de tu compose):

docker exec -it openclaw sh
vi /root/.openclaw/openclaw.json

O edita directamente en el host la ruta montada.

Errores frecuentes:

• JSON estricto: sin coma tras el último par clave-valor
• Al pegar el Token suelen colarse comillas o espacios de más
• allowFrom es un array; aunque haya un solo usuario, debe ir en formato array (consulta el formato de ID en la documentación)

La primera vez añadí una coma de más, OpenClaw no arrancó y tardé un buen rato en encontrarlo en los logs. Herramientas como JSONLint online evitan ese error tonto.

Paso 3: protege tu Bot con lista blanca

La lista blanca es fundamental. Si filtra tu Bot Token, cualquiera puede consumir tu cuota de IA. A un amigo le pasó: agotó un mes de cuota de Claude en tres días.

Por qué debes configurar lista blanca:

• Evitar que desconocidos abusen de tu cuota de IA (cuesta dinero real)
• Reducir fugas de información sensible (tus conversaciones con la IA pueden incluir trabajo)
• Controlar el coste (sobre todo con modelos caros como GPT-4)

¿Cómo configurar la política de acceso? Recuerda el ID que obtuviste con @userinfobot. En la configuración oficial, el campo habitual en mensajes privados es channels.telegram.allowFrom (junto con dmPolicy).

Ejemplo un solo usuario (campos bajo channels.telegram):

"dmPolicy": "allowlist",
"allowFrom": [123456789]

Varios usuarios (equipo):

"dmPolicy": "allowlist",
"allowFrom": [123456789, 987654321, 555555555]

Cómo obtener el ID de Telegram de otras personas:

1. Que busquen @userinfobot en Telegram (alternativa recomendada por la documentación: enviar primero un mensaje privado a tu Bot y leer from.id con openclaw logs --follow)
2. Enviar /start
3. Anotar el ID numérico que devuelve
4. Añadirlo al array allowFrom

Si configuras un equipo, conviene un documento con ID y nombre de cada usuario autorizado. Cuando alguien se vaya, quítalo del allowlist: es higiene básica de seguridad.

Sobre el modo Pairing (emparejamiento):

El valor por defecto de DM en Telegram suele ser pairing: el primer mensaje privado exige openclaw pairing approve telegram <CODE> en la máquina del gateway. Si prefieres acceso solo por ID de usuario, como en este tutorial, usa dmPolicy: "allowlist" y rellena allowFrom (véase la documentación oficial).

Paso 4: inicia OpenClaw y prueba la conexión

Configuración lista: toca arrancar OpenClaw y comprobar que el Bot funciona.

Iniciar el Gateway:

Instalación local (si ejecutaste openclaw onboard --install-daemon, puedes comprobar antes con openclaw gateway status):

openclaw gateway
# o el servicio del sistema:
openclaw gateway start

Arrancar desde código fuente es un caso minoritario; el uso habitual pasa por la CLI del Gateway; no sustituyas por un npm start inventado.

Con Docker:

docker compose up -d

Comprobar el estado del servicio:

Tras el arranque, revisa los logs para ver si el canal Telegram se cargó bien. Con Docker:

docker compose logs openclaw -f

Deberías ver algo como:

[INFO] Loading Telegram channel: telegram-main
[INFO] Telegram bot connected successfully
[INFO] Listening for messages...

Si hay errores, anótalos; más abajo tienes una lista de diagnóstico.

Alibaba Cloud - Opción preferida para desarrolladores, 15 % de descuento exclusivo en Lighthouse

Obtener 15% dto. →Anuncio

Primera prueba de conversación (el momento emocionante):

1. Busca en Telegram el nombre de usuario de tu Bot (el que termina en bot)
2. Pulsa el botón Start en la ventana de chat
3. Envía un mensaje de prueba, por ejemplo «Hola» o «Hi there»
4. Si todo va bien, en unos segundos el Bot responderá con contenido generado por la IA

La primera vez que vi la respuesta me emocioné un poco: había montado un robot que realmente conversaba conmigo.

Si no responde, no reinstales aún; consulta la lista de problemas más abajo: el 90 % se resuelve rápido.

Lista de resolución de problemas habituales

¿El Bot no responde? ¿La configuración no aplica? Tranquilo, revisemos paso a paso. He recopilado los problemas que más he visto en forma de checklist.

Problema 1: el Bot no responde a ningún mensaje

Es lo más frecuente. Revisa en este orden:

• ¿Está en ejecución OpenClaw? Confirma con docker ps o ps aux | grep openclaw
• ¿El Bot Token está bien? Revisa channels.telegram.botToken en ~/.openclaw/openclaw.json, sin espacios ni comillas de más
• ¿Tu ID está en allowFrom (allowlist) o completaste pairing (pairing)? Confirma con @userinfobot o leyendo los logs como indica la documentación
• ¿El JSON es válido? Pásalo por JSONLint online
• ¿La API Key del modelo de IA es válida y con saldo? Revisa en el panel del proveedor

Comandos de diagnóstico:

# Ver logs de OpenClaw
docker compose logs openclaw -f

# Comprobar formato del archivo de configuración
cat ~/.openclaw/openclaw.json | jq .

Problema 2: error «Unauthorized» o «Forbidden»

Casi siempre es la lista blanca. Comprueba:

• Con dmPolicy: "allowlist", que tu ID de Telegram esté en allowFrom (la documentación también admite cadenas con prefijo)
• Con pairing, que hayas ejecutado openclaw pairing approve telegram <CODE> en el gateway
• Tras cambiar la configuración, reinicia OpenClaw

Problema 3: el Bot responde muy lento

Si tarda mucho, puede deberse a:

• Latencia de la API del modelo (sobre todo en horas punta)
• Problemas de red (servidor hacia el proveedor de IA)
• Recursos insuficientes en el servidor (CPU y memoria)

Mejoras posibles:

• Prueba un modelo más rápido
• Si usas GPT-4, prueba GPT-3.5 o Claude 3 Haiku
• Mejora el servidor o la red

Problema 4: los cambios en la configuración no surten efecto

Me pasó: edité la config y no servía de nada. Causa: olvidé reiniciar.

Solución:

docker compose restart
# o
systemctl restart openclaw

Problema 5: cómo ver el historial de conversaciones del Bot

OpenClaw guarda las conversaciones en local. Puedes:

• Revisar archivos de log (ruta por defecto)
• Usar Control UI de OpenClaw (si está activada)
• Consultar la base de datos directamente (SQLite u otra según configuración)

Problema 6: filtración del Bot Token

Si lo subiste a un repo público o se filtró:

1. Revoca de inmediato con /revoke en BotFather
2. Genera uno nuevo con /token
3. Actualiza la configuración de OpenClaw
4. Reinicia el servicio
5. Revisa el uso en el proveedor de IA por posible abuso

Configuración avanzada (opcional)

Lo básico basta para la mayoría, pero OpenClaw permite ir más allá.

Mensaje de bienvenida y menú de comandos:

En BotFather, con /setcommands puedes definir un menú, por ejemplo:

start - Iniciar conversación
help - Ver ayuda
clear - Borrar historial

Al escribir /, el usuario verá estas opciones.

KiloClaw - OpenClaw gestionado para empresas: orquestación de agentes IA y enrutamiento inteligente

Empezar →Anuncio

Modo de emparejamiento DM:

Si quieres que varias personas usen el Bot sin gestionar manualmente la lista blanca, prueba el modo de código:

"enableDmPairing": true

OpenClaw generará un código; el usuario lo introduce la primera vez. Útil si ofreces el servicio a terceros.

Distintos modelos de IA por usuario:

OpenClaw permite asignar modelos por usuario: administradores con GPT-4, usuarios normales con GPT-3.5. Consulta la sección Multi-Model de la documentación oficial.

Integrar OpenClaw Skills:

Skills es una función potente: el asistente puede ejecutar acciones reales, por ejemplo:

• Gestión de archivos (crear, leer, editar)
• Ejecución de comandos Shell
• Búsqueda web
• Escritura y depuración de código

Activa Skills con cuidado, sobre todo Shell: el riesgo de seguridad es alto.

Memoria de conversación y respuestas personalizadas:

OpenClaw guarda el historial; puedes ajustar la longitud de memoria, prompts personalizados, etc., para adaptarlo a tu forma de trabajar.

No profundizo más aquí; la documentación oficial de OpenClaw tiene el detalle.

Conclusión

En retrospectiva, el flujo no es tan complejo. Desde BotFather hasta la prueba final —Token, OpenClaw, lista blanca— media hora suele bastar.

Repaso de los puntos donde más se falla:

• Guarda bien el Bot Token; no lo subas a repos públicos
• La lista blanca es clave para la seguridad; no la omitas por pereza
• El JSON debe ser estricto: una coma de más rompe la configuración
• Tras cambiar la config, reinicia el servicio

Si seguiste este tutorial, ya deberías tener un asistente de IA en Telegram operativo. Pregúntale cuando quieras sin abrir el navegador: la experiencia mejora mucho.

Qué puedes hacer ahora:

• Probar distintos modelos de IA según tu caso de uso
• Explorar Skills para que el asistente ejecute acciones reales
• Si te convence, configurarlo también para tu equipo

OpenClaw no solo admite Telegram: WhatsApp, WeCom empresarial y más. Con este método, el resto de plataformas es muy similar.

Si surge un problema, vuelve a la lista de diagnóstico o pregunta en la comunidad de OpenClaw. Parte de la diversión está en resolver cada obstáculo y aprender algo nuevo.

Ahora ve a charlar con tu asistente de IA.