mi bot no inicia, que debo hacer ?
Conectar OpenClaw con Telegram es la forma más sencilla y segura de comunicarte con tu agente de IA desde el celular o desde donde quieras. En esta guía aprenderás a generar un bot, obtener el token, configurar las políticas de acceso y vivir el primer ritual donde tu agente literalmente nace. Es ideal para quien apenas empieza a construir su propio asistente personal.
Por qué usar Telegram y no WhatsApp o Slack
La elección del canal no es casual. Telegram gana porque WhatsApp te obligaría a tener un número de celular dedicado solo para el agente, y Slack es una opción mucho más pública. Telegram queda justo en el punto medio: simple y seguro.
¿Qué necesito para conectar OpenClaw a Telegram? Solo dos cosas: un bot creado con BotFather y su token único. Con eso configuras el canal desde la terminal en minutos.
Esa combinación de bot mas token es la llave que abre la comunicación entre tu agente y tu celular.
Cómo crear un bot en Telegram con BotFather
Todo arranca con BotFather, el bot oficial de Telegram (reconocible por su palomita de verificación). Ábrelo desde la barra de búsqueda arriba de tu lista de contactos [00:37].
El proceso es corto y directo:
/newbot y presiona Enter [00:52]._bot.En la clase, moneta_bot ya estaba tomado, así que la solución fue usar moneta_oc_bot, donde oc viene de OpenClaw [01:20].
Una vez creado, BotFather entrega la pieza clave: el token, un número seguido de dos puntos y una cadena de caracteres. Cópialo y guárdalo en un lugar seguro, porque es lo que conecta todo [01:38].
Cómo configurar el canal de Telegram en OpenClaw
Con el token en mano, abre una terminal y ejecuta openclaw configure. Esto lanza el asistente de configuración [01:53].
Desde ahí el camino es claro:
Después de dar Enter y seleccionar Finished, el asistente te pregunta si quieres configurar las políticas de acceso a mensajes directos. Aquí es donde tomas una decisión importante de seguridad.
Qué políticas de acceso a DM existen en OpenClaw
OpenClaw ofrece cuatro políticas, y no todas son buena idea:
La recomendada para este proyecto es Pairing, porque te da control total sobre quién habla con tu agente. Tras elegirla, haz clic en Done [03:30].
Cómo aprobar tu usuario para hablar con el agente
Regresa a Telegram, a la conversación con BotFather, y busca la liga que empieza con t.me/. Esa liga te lleva directo al chat con tu bot [03:40].
Al presionar el botón Start, recibes un aviso de que el acceso aún no está configurado, junto con tu ID de Telegram (tu identificador único en la plataforma) y un código de autorización.
¿Cómo autorizo mi usuario en OpenClaw? Copia el comando que el propio bot te entrega, del tipo
openclaw pairing approve telegram, pégalo en la terminal y presiona Enter. Verás un mensaje confirmando que tu usuario ya está aprobado.
Este paso de pairing es lo que traduce el permiso desde Telegram hacia tu configuración local [04:20].
Cómo resolver el error más común al conectar el agente
Si mandas tu primer mensaje y el agente no responde, tranquilo: es un error muy frecuente y se arregla fácil. En la clase pasó porque se había cambiado varias veces el modelo predefinido sin reiniciar el gateway [04:50].
La solución es un solo comando:
bash openclaw gateway restart
Espera a que el gateway arranque de nuevo, vuelve a Telegram y manda otro mensaje. Ahora sí verás al agente empezar a teclear [05:15].
Qué pasa cuando tu agente nace por primera vez
Aquí viene lo interesante. En la primera conversación aparece la instrucción Read from bootstrap.md, un archivo que le dice al agente cómo guiar ese primer intercambio y que desaparece una vez terminado el proceso de nacimiento o hatching [05:40].
Tu agente empieza literalmente sin nombre y sin saber quién es. Puede deducir datos de tu usuario de Telegram, como tu nombre y tu zona horaria, pero necesita que tú le des una identidad: un nombre, una naturaleza, una vibra y un emoji [06:30].
En el ejemplo, el agente recibió el nombre Moneta y la misión de construir juntos un sistema de second brain para llevar control de proyectos, tareas e intereses [07:10].
Un detalle que vale la pena notar: el agente respondió en inglés porque usaba un modelo gratuito, que no tiene la sutileza de detectar el idioma. Si le pides que hable en español, lo respeta sin problema.
Por qué todo lo que no está apuntado no existe para tu agente
Cuando Moneta dice "déjame, lo apunto", está revelando algo esencial de cualquier asistente de IA: todo lo que no vive escrito en un archivo prácticamente no existe y el agente no puede recordarlo [07:40].
Durante el nacimiento, el agente escribe archivos clave como el soul.md, tomando nota de las instrucciones que le das sobre tono, estilo y qué tan proactivo debe ser. En el ejemplo se le pidió:
Al terminar, el agente anuncia Bootstrap completo y entrega la lista de archivos que actualizó. Ese bootstrap es justo el proceso inicial de crear su identidad y entender quién eres tú [09:00].
Con esto acabas de darle vida a tu agente y cerrar el primer módulo. En el siguiente paso le darás herramientas para construir el proyecto completo. ¿Ya elegiste el nombre y la personalidad de tu agente? Cuéntame en los comentarios y comparte el screenshot de tu primera conversación.
Conectar OpenClaw con Telegram es la forma más sencilla y segura de comunicarte con tu agente de IA desde el celular o desde donde quieras. En esta guía aprenderás a generar un bot, obtener el token, configurar las políticas de acceso y vivir el primer ritual donde tu agente literalmente nace. Es ideal para quien apenas empieza a construir su propio asistente personal.
La elección del canal no es casual. Telegram gana porque WhatsApp te obligaría a tener un número de celular dedicado solo para el agente, y Slack es una opción mucho más pública. Telegram queda justo en el punto medio: simple y seguro.
¿Qué necesito para conectar OpenClaw a Telegram? Solo dos cosas: un bot creado con BotFather y su token único. Con eso configuras el canal desde la terminal en minutos.
Esa combinación de bot mas token es la llave que abre la comunicación entre tu agente y tu celular.
Todo arranca con BotFather, el bot oficial de Telegram (reconocible por su palomita de verificación). Ábrelo desde la barra de búsqueda arriba de tu lista de contactos [00:37].
El proceso es corto y directo:
/newbot y presiona Enter [00:52]._bot.En la clase, moneta_bot ya estaba tomado, así que la solución fue usar moneta_oc_bot, donde oc viene de OpenClaw [01:20].
Una vez creado, BotFather entrega la pieza clave: el token, un número seguido de dos puntos y una cadena de caracteres. Cópialo y guárdalo en un lugar seguro, porque es lo que conecta todo [01:38].
Con el token en mano, abre una terminal y ejecuta openclaw configure. Esto lanza el asistente de configuración [01:53].
Desde ahí el camino es claro:
Después de dar Enter y seleccionar Finished, el asistente te pregunta si quieres configurar las políticas de acceso a mensajes directos. Aquí es donde tomas una decisión importante de seguridad.
OpenClaw ofrece cuatro políticas, y no todas son buena idea:
La recomendada para este proyecto es Pairing, porque te da control total sobre quién habla con tu agente. Tras elegirla, haz clic en Done [03:30].
Regresa a Telegram, a la conversación con BotFather, y busca la liga que empieza con t.me/. Esa liga te lleva directo al chat con tu bot [03:40].
Al presionar el botón Start, recibes un aviso de que el acceso aún no está configurado, junto con tu ID de Telegram (tu identificador único en la plataforma) y un código de autorización.
¿Cómo autorizo mi usuario en OpenClaw? Copia el comando que el propio bot te entrega, del tipo
openclaw pairing approve telegram, pégalo en la terminal y presiona Enter. Verás un mensaje confirmando que tu usuario ya está aprobado.
Este paso de pairing es lo que traduce el permiso desde Telegram hacia tu configuración local [04:20].
Si mandas tu primer mensaje y el agente no responde, tranquilo: es un error muy frecuente y se arregla fácil. En la clase pasó porque se había cambiado varias veces el modelo predefinido sin reiniciar el gateway [04:50].
La solución es un solo comando:
bash openclaw gateway restart
Espera a que el gateway arranque de nuevo, vuelve a Telegram y manda otro mensaje. Ahora sí verás al agente empezar a teclear [05:15].
Aquí viene lo interesante. En la primera conversación aparece la instrucción Read from bootstrap.md, un archivo que le dice al agente cómo guiar ese primer intercambio y que desaparece una vez terminado el proceso de nacimiento o hatching [05:40].
Tu agente empieza literalmente sin nombre y sin saber quién es. Puede deducir datos de tu usuario de Telegram, como tu nombre y tu zona horaria, pero necesita que tú le des una identidad: un nombre, una naturaleza, una vibra y un emoji [06:30].
En el ejemplo, el agente recibió el nombre Moneta y la misión de construir juntos un sistema de second brain para llevar control de proyectos, tareas e intereses [07:10].
Un detalle que vale la pena notar: el agente respondió en inglés porque usaba un modelo gratuito, que no tiene la sutileza de detectar el idioma. Si le pides que hable en español, lo respeta sin problema.
Cuando Moneta dice "déjame, lo apunto", está revelando algo esencial de cualquier asistente de IA: todo lo que no vive escrito en un archivo prácticamente no existe y el agente no puede recordarlo [07:40].
Durante el nacimiento, el agente escribe archivos clave como el soul.md, tomando nota de las instrucciones que le das sobre tono, estilo y qué tan proactivo debe ser. En el ejemplo se le pidió:
Al terminar, el agente anuncia Bootstrap completo y entrega la lista de archivos que actualizó. Ese bootstrap es justo el proceso inicial de crear su identidad y entender quién eres tú [09:00].
Con esto acabas de darle vida a tu agente y cerrar el primer módulo. En el siguiente paso le darás herramientas para construir el proyecto completo. ¿Ya elegiste el nombre y la personalidad de tu agente? Cuéntame en los comentarios y comparte el screenshot de tu primera conversación.
mi bot no inicia, que debo hacer ?


Vamos avanzando en el curso!!!
OpenClaw en Telegram no contesta.. estoy atorado en este paso. Estoy consultando con Gemini y no logramos activarlo.
De las cuatro políticas de acceso a mensajes directos, la clase descarta una sin matices: Open, que deja escribirle al bot a cualquier persona de Telegram. Pairing y Allowlist siguen una lógica de mínimo acceso, como en una base de datos: primero se decide quién puede hablar con el agente y solo después qué puede hacer. En Pairing el bot no responde hasta que alguien aprueba al usuario desde la terminal. Para un analista que conecte un agente a archivos de su equipo, esa decisión pesa, en mi opinión, más que el modelo elegido. Un ejercicio plausible: escribir quiénes serán los únicos autorizados antes de aprobar al primero.
📚 CLASE: Cómo conectar tu agente OpenClaw con Telegram
━━━━━━━━━━━━━━━━━━
🎯 IDEA PRINCIPAL
🔵 Telegram convierte a OpenClaw en un agente accesible desde un canal de comunicación cotidiano.
🟡 La ventaja no es “tener un chatbot en Telegram”, sino poder interactuar con tu agente desde cualquier lugar.
━━━━━━━━━━━━━━━━━━
⚡ RESUMEN ULTRA RÁPIDO
🔵 Telegram funciona como interfaz; OpenClaw permanece como el agente que procesa las instrucciones.
🟡 La conexión normalmente requiere crear un bot y configurar sus credenciales en OpenClaw.
🟡 Separar interfaz y agente permite cambiar el canal sin reconstruir la lógica principal.
🔴 Una credencial expuesta puede permitir que terceros controlen o utilicen tu bot.
🟣 Telegram puede convertirse en una interfaz práctica para automatizaciones, notificaciones y consultas rápidas.
━━━━━━━━━━━━━━━━━━
🔑 LO IMPORTANTE
🔵 Un bot de Telegram es una cuenta automatizada que permite recibir y enviar mensajes mediante la API.
🔵 El BotFather es la herramienta oficial de Telegram utilizada para crear y administrar bots.
🟡 La API Token conecta tu bot de Telegram con la aplicación que lo controla.
🔴 No publiques el token del bot en GitHub, capturas, documentación pública o mensajes compartidos.
🔴 Conectar un agente con herramientas aumenta las consecuencias potenciales de instrucciones maliciosas.
🟣 Usa Telegram como capa de entrada/salida, manteniendo separadas las reglas, memoria y herramientas del agente.
━━━━━━━━━━━━━━━━━━
🧩 MODELO MENTAL
🔵 USUARIO → TELEGRAM → BOT → OPENCLAW → MODELO IA → HERRAMIENTA → RESPUESTA
🟡 Telegram transporta el mensaje; OpenClaw decide qué hacer con él.
🟣 Cuanto más poder tenga el agente detrás del bot, más importante resulta controlar quién puede interactuar con él.
━━━━━━━━━━━━━━━━━━
🚀 ACCIONES PARA HOY
🟢 Crea un bot mediante BotFather y conserva su token de forma privada.
🟢 Configura el bot como canal de comunicación dentro de OpenClaw.
🟢 Envía un mensaje de prueba desde Telegram y verifica que OpenClaw lo recibe.
🟢 Comprueba que OpenClaw puede responder correctamente a través del bot.
🟢 Restringe el acceso del bot a usuarios autorizados antes de conectarlo con herramientas sensibles.
🟢 Prueba primero preguntas simples antes de permitir acciones automáticas.
━━━━━━━━━━━━━━━━━━
🟣 VENTAJA PROFESIONAL
🟣 Un agente útil necesita una interfaz de acceso conveniente, no necesariamente una aplicación propia.
🟣 Hack: usa Telegram para notificaciones que requieran atención humana y respuestas rápidas.
🟣 Hack: separa identidad, autenticación y permisos; saber quién escribe no debería implicar acceso ilimitado.
🟣 Si el agente puede ejecutar acciones externas, añade confirmación para operaciones destructivas, financieras o irreversibles.
━━━━━━━━━━━━━━━━━━
📝 CIERRE
🟡 El salto importante ocurre cuando tu agente deja de vivir únicamente en la terminal y entra en tus canales cotidianos.
🟢 Conecta Telegram, prueba un flujo sencillo y luego aumenta gradualmente las capacidades del agente.
se demora una eternidad en responder, cuáles son los requisitos de memoria porque lo hice con ollama y un modelo de google.(mientras escribo este mensaje no ha terminado y lleva 10min)
Después de restaurar el gateway, me sale esto:
The configured model is unavailable from the provider — it may have been renamed, retired, or is not offered on this account. This needs a config update (agents.defaults.model); retrying or starting a new session won't fix it
Cuando Whatsapp habilite los usernames podria ser mas facil sin necesidad de nuemros ?
Yo tengo el sigueinte mensaje, ¿Alguién sabeque pueda ser?
