Tutorial de OpenClaw - Capítulo 4: Conectar Telegram: tu asistente en el bolsillo

Indice Tutorial >>

Ya a la venta: OpenClaw, Tu Asistente Personal con IA (el libro)
Tutorial de OpenClaw - Capítulo 1: ¿Qué es OpenClaw y por qué necesitas un asistente IA propio?
Tutorial de OpenClaw - Capítulo 2: Instalación paso a paso
Tutorial de OpenClaw - Capítulo 3: Primeros pasos: tu primera conversación con OpenClaw
Tutorial de OpenClaw - Capítulo 4: Conectar Telegram: tu asistente en el bolsillo
4 ajustes de OpenRouter que abaratan tu agente de IA sin cambiar de modelo
Tutorial de OpenClaw - Capítulo 5: Conectar WhatsApp, Discord y otras plataformas

Ha llegado el momento de hacer algo muy satisfactorio: hablar con tu asistente de IA desde el móvil, como si fuera un contacto más. En este capítulo vamos a conectar Telegram, que es la forma más sencilla y gratuita de hacerlo. No necesitas comprar nada, ni contratar ningún número nuevo. Solo una cuenta de Telegram (que probablemente ya tienes) y 5 minutos.

La bandeja de entrada única

Antes de empezar, es importante entender un concepto clave: OpenClaw tiene una bandeja de entrada única. Esto significa que todos los mensajes que llegan desde cualquier plataforma (Telegram, Discord, WhatsApp, la interfaz web…) van al mismo agente. Es como si tuvieras un único asistente que atiende todas las líneas de teléfono a la vez.

Puedes empezar una conversación por Telegram desde el autobús y continuarla desde la interfaz web cuando llegues a casa. Tu asistente mantiene el contexto independientemente del canal.

Por qué Telegram

OpenClaw soporta más de 22 plataformas de mensajería, pero empezamos con Telegram por varias razones:

No necesitas un número de teléfono extra — Creas un «bot» que funciona de forma independiente a tu cuenta personal
Es completamente gratuito — Crear un bot en Telegram no cuesta nada
Se configura en 5 minutos — No hay procesos de verificación ni aprobaciones
Puedes enviar de todo — Fotos, PDFs, audios, vídeos… archivos de hasta 100 MB
No interfiere con tu Telegram personal — El bot tiene su propio usuario, tú le escribes cuando quieras

Paso 1: Crear un bot en Telegram

Telegram tiene un bot oficial llamado @BotFather que se encarga de crear y gestionar bots. Vamos a usarlo:

Abre Telegram en tu móvil o en la versión web (web.telegram.org)
En el buscador, escribe @BotFather y abre la conversación con él
Escríbele: /newbot
Te pedirá un nombre para tu bot. Este es el nombre que verás en la conversación, por ejemplo: Mi Asistente IA
Te pedirá un nombre de usuario que debe terminar obligatoriamente en «bot», por ejemplo: mi_asistente_ia_bot
BotFather te responderá con un mensaje que incluye un token parecido a esto: 7123456789:AAF1234567890abcdefghijklmnop
Copia y guarda ese token. Es la «contraseña» que permite a OpenClaw controlar tu bot. No lo compartas con nadie.

Paso 2: Editar el archivo de configuración de OpenClaw

Ahora necesitamos decirle a OpenClaw que use ese bot de Telegram. Para ello hay que editar el archivo de configuración openclaw.json. Pero antes, vamos a encontrarlo.

Dónde está el archivo de configuración

El archivo de configuración de OpenClaw se guarda en una carpeta oculta dentro de tu carpeta de usuario. Las carpetas ocultas son las que empiezan por un punto (.) y por defecto no aparecen en el explorador de archivos.

La ruta completa según tu sistema operativo:

Linux: /home/tu-usuario/.openclaw/openclaw.json
Mac: /Users/tu-usuario/.openclaw/openclaw.json
Windows: C:\Users\tu-usuario\.openclaw\openclaw.json

Para ver carpetas ocultas en el explorador de archivos:

Linux: Pulsa Ctrl+H en el explorador de archivos
Mac: Pulsa Cmd+Shift+. (punto) en Finder
Windows: En el Explorador de archivos, haz clic en «Vista» y marca «Elementos ocultos»

Cómo editar el archivo

Puedes abrir el archivo con cualquier editor de texto. Desde la terminal es lo más rápido:

En Linux o Mac, abre una terminal y escribe:

nano ~/.openclaw/openclaw.json

(Si prefieres otro editor, puedes usar code para Visual Studio Code, gedit en Ubuntu/Linux Mint, o cualquier editor que tengas instalado.)

En Windows, abre PowerShell y escribe:

notepad $env:USERPROFILE\.openclaw\openclaw.json

Qué añadir

Dentro del archivo verás un JSON con varias secciones. Busca la sección "channels" (si ya existe) o créala. Necesitas que quede algo así:

"channels": {
  "telegram": {
    "enabled": true,
    "botToken": "7123456789:AAF1234567890abcdefghijklmnop",
    "dmPolicy": "pairing",
    "historyLimit": 50
  }
}

Sustituye el valor de botToken por el token que te dio BotFather en el paso anterior.

Veamos qué significa cada opción:

"enabled": true — Activa el canal de Telegram
"botToken" — El token de tu bot (el que te dio BotFather)
"dmPolicy": "pairing" — Solo responde a personas que se hayan emparejado con un código. Esto evita que desconocidos usen tu asistente.
"historyLimit": 50 — Cuántos mensajes anteriores recuerda en cada conversación

Si usas nano, para guardar pulsa Ctrl+O (guardar), luego Enter, y después Ctrl+X (salir). En notepad de Windows, simplemente Ctrl+S para guardar.

Paso 3: Reiniciar OpenClaw

Para que OpenClaw cargue la nueva configuración, necesitas reiniciar el Gateway:

openclaw gateway restart

Si todo ha ido bien, verás un mensaje como este:

🦞 OpenClaw 2026.4.1
Restarted systemd service: openclaw-gateway.service

Paso 4: Emparejamiento

Si configuraste dmPolicy: "pairing" (recomendado), la primera vez que le escribas al bot necesitarás emparejarte:

Abre Telegram y busca tu bot por el nombre de usuario que elegiste (por ejemplo, @mi_asistente_ia_bot)
Pulsa «Iniciar» (o «Start») y escríbele cualquier mensaje
El bot te responderá con un código de emparejamiento de 6 dígitos que caduca en 1 hora
Ahora ve a la terminal donde tienes OpenClaw y ejecuta: openclaw devices list
Verás la solicitud pendiente. Apruébala con: openclaw devices approve
Vuelve a Telegram y envía el código de 6 dígitos como respuesta al bot
A partir de ahora el bot te responderá normalmente

Este sistema de emparejamiento es una medida de seguridad: aunque alguien descubra el nombre de tu bot, no podrá usarlo sin que tú lo apruebes desde la terminal.

Paso 5: Probarlo

Ya tienes tu asistente funcionando en Telegram. Prueba a escribirle cosas:

«Hola, ¿qué puedes hacer?» — Para ver sus capacidades
«Traduce esto al inglés: Tengo una reunión a las 3»
«Dame 5 ideas para cenar esta noche»
«Crea una lista de las cosas que tengo que hacer esta semana»

Enviar fotos, PDFs y audios

Una de las grandes ventajas de conectar Telegram es que puedes enviarle archivos a tu asistente para que los analice:

Envía una foto con el texto «¿Qué ves en esta imagen?» y OpenClaw la analizará usando la capacidad de visión del modelo de IA
Envía un PDF con el texto «Resume este documento» y te hará un resumen
Envía un audio y OpenClaw lo transcribirá a texto
Envía una captura de pantalla con «¿Qué error hay aquí?» si necesitas ayuda con algo

Telegram permite archivos de hasta 100 MB, así que puedes enviar documentos bastante grandes sin problema.

Configuración avanzada de Telegram

Si quieres ajustar más opciones, aquí tienes la configuración completa:

"channels": {
  "telegram": {
    "enabled": true,
    "botToken": "tu-token",
    "dmPolicy": "pairing",
    "allowFrom": [],
    "historyLimit": 50,
    "streaming": "off",
    "mediaMaxMb": 100,
    "linkPreview": true
  }
}

"allowFrom": [] — Si cambias dmPolicy a «allowlist», aquí pones los IDs de usuario de Telegram que pueden hablar con el bot
"streaming": "off" — Las respuestas se envían completas. Si quieres ver cómo escribe en tiempo real, cámbialo a «partial»
"mediaMaxMb": 100 — Tamaño máximo de archivos que acepta (en megabytes)
"linkPreview": true — Muestra vista previa de los enlaces en las respuestas

Usar el bot en grupos de Telegram

También puedes añadir tu bot a un grupo de Telegram para que esté disponible para varias personas. Por ejemplo, un grupo de trabajo o de familia.

Para que el bot funcione en grupos, necesitas configurar dos cosas:

Añade esta sección dentro de la configuración de Telegram:

"groups": {
  "*": {
    "requireMention": true
  }
}

Añade el bot al grupo de Telegram
Para hablar con él en el grupo, escribe mencionándolo: @mi_asistente_ia_bot ¿qué tiempo hará mañana?

Con "requireMention": true, el bot solo responderá cuando lo menciones, así no interrumpe las conversaciones normales del grupo.

Solución de problemas

«El bot no responde»

Comprueba que OpenClaw está corriendo: openclaw status
Verifica que el token del bot es correcto en openclaw.json
Asegúrate de haber completado el emparejamiento (paso 4)
Reinicia el gateway: openclaw gateway restart

«Error de token inválido»

Copia el token de nuevo desde BotFather (a veces se copia mal un carácter)
Asegúrate de que el token está entre comillas en el archivo de configuración
Si regeneraste el token en BotFather, el anterior deja de funcionar

«No encuentro el archivo openclaw.json»

Recuerda que la carpeta .openclaw está oculta (empieza por punto)
En Linux pulsa Ctrl+H en el explorador de archivos para ver carpetas ocultas
En Mac pulsa Cmd+Shift+. en Finder
En Windows marca «Elementos ocultos» en la pestaña Vista del Explorador
Desde la terminal siempre puedes acceder directamente con nano ~/.openclaw/openclaw.json (Linux/Mac) o notepad $env:USERPROFILE\.openclaw\openclaw.json (Windows)

Resumen

En este capítulo has:

Creado un bot de Telegram con @BotFather
Aprendido a encontrar y editar el archivo de configuración de OpenClaw
Conectado Telegram como canal de mensajería
Completado el proceso de emparejamiento
Probado tu asistente con mensajes de texto, fotos y archivos
Configurado el bot para funcionar en grupos

Ahora ya tienes tu asistente de IA en el bolsillo. Puedes escribirle desde cualquier lugar, enviarle fotos para que las analice o documentos para que los resuma.

En el próximo capítulo veremos cómo conectar WhatsApp, Discord, Slack y otras plataformas. Si solo te interesa Telegram, puedes saltar directamente al Capítulo 6 donde aprenderás a elegir y configurar el modelo de IA.