Cómo conectar OpenClaw a Telegram

Respuesta corta. Crea un bot con @BotFather en Telegram (/newbot) y copia su token. Dale el token a OpenClaw y permite que solo tu propio ID numérico de usuario de Telegram le escriba. En tu propia máquina eso es openclaw channels add --channel telegram --token <token> más dmPolicy: "allowlist" con tu ID en allowFrom. En PlayNHost pegas el token y tu ID en la página Agente, y reinicias.

Comprobado el 6 de noviembre de 2026, correcto para OpenClaw 2026.11.1.

Esta guía usa la documentación de Telegram de OpenClaw y el panel de PlayNHost tal como funciona hoy. Telegram viene integrado en OpenClaw: no hay ningún plugin que instalar.

Paso 1: crea el bot y copia su token

1. En Telegram, abre un chat con @BotFather. Comprueba que el nombre de usuario sea exactamente @BotFather.
2. Envía /newbot, elige un nombre para mostrar y luego un nombre de usuario que termine en bot.
3. BotFather responde con el token, que se parece a 123456789:AAH.... Mantenlo en privado: cualquiera que lo tenga puede controlar tu bot.

BotFather también tiene una web app (t.me/BotFather?startapp) que hace lo mismo con botones.

Usa un bot en el que no se ejecute nada más. Si un OpenClaw anterior en tu portátil, o cualquier otro programa, sigue usando el mismo token, deténlo primero o crea un bot nuevo.

Paso 2: encuentra tu ID de usuario de Telegram

La lista de permitidos de OpenClaw pide tu ID de usuario numérico, no tu @usuario, ni tu número de teléfono, ni el ID del bot. Las formas que enumera la documentación de OpenClaw:

• Desde el propio bot (sin terceros). Mientras el bot está en modo pairing, envíale cualquier mensaje. Su respuesta de emparejamiento incluye "Your Telegram user id" (tu ID de usuario de Telegram). En PlayNHost esta es la forma que sugerimos, mira más abajo.
• Desde el registro de OpenClaw. Ejecuta openclaw logs --follow, escribe al bot y lee senderUserId en la entrada telegram pairing request.
• La propia API de Telegram. Escribe al bot y luego abre https://api.telegram.org/bot<bot_token>/getUpdates y lee message.from.id.
• Un bot de terceros como @userinfobot o @getidsbot. La documentación de OpenClaw dice que es menos privado.

Paso 3 en PlayNHost: pega el token y tu ID

Necesitas una clave de proveedor de IA en la misma página. Sin ella, Start se detiene con "Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token." (tu agente aún no está configurado: necesita una clave de API de un proveedor de IA y un token de bot de Telegram o Discord).

1. Abre tu servidor en panel.playnhost.com, luego la pestaña Agente.
2. En Proveedor de IA, define una clave si aún no lo has hecho (mira qué clave de proveedor de IA usar).
3. En Apps de chat, pulsa Definir en Token del bot de Telegram, pega el token de BotFather y pulsa Guardar. El panel comprueba su formato; si pegas algo incorrecto aparece "That is not a valid telegram bot token." (ese no es un token de bot de Telegram válido). Una vez guardado, la fila solo muestra los últimos cuatro caracteres, y el token no se vuelve a mostrar.
4. ¿Aún no sabes tu ID? Deja vacío IDs de usuario de Telegram y pulsa Iniciar. Cuando el agente está en marcha, la consola muestra (en inglés):

   [PlayNHost] Your agent is running
   [PlayNHost] Telegram: nobody can message your agent yet. Send your bot any message: it answers with your Telegram user ID. Copy that ID, put it on the Agent page, then restart. Ignore the pairing code in its reply.

   Escríbele a tu bot en Telegram. Responde una vez con un código de emparejamiento y tu ID de usuario de Telegram (OpenClaw envía un código más o menos una vez por hora a cada persona e ignora los mensajes intermedios). Copia el ID e ignora el código: en PlayNHost no hay nada que aprobar. Este paso no deja entrar a nadie.
5. En Quién puede escribirle, escribe tu ID en IDs de usuario de Telegram y pulsa Guardar. Varios IDs van en una sola línea, separados por comas.
6. La página dice "Los cambios se aplican la próxima vez que se inicie tu agente." Pulsa Reiniciar ahora. Entonces la consola lo confirma:

   [PlayNHost] Telegram: only user 123456789 can message your agent.

7. Escríbele a tu bot. Tu agente responde. Los mensajes de cualquier otra cuenta de Telegram se ignoran.

Lo que PlayNHost configura por ti

• Con IDs en el panel Agente, los mensajes directos de Telegram usan dmPolicy: "allowlist" con exactamente esos IDs, que es lo que recomienda la documentación de OpenClaw para un bot con un solo dueño. Sin ningún ID, usan pairing: los desconocidos reciben un código y se les ignora, y nadie puede aprobarlos sin la línea de comandos o el panel de control de OpenClaw, y un servidor de PlayNHost no ofrece ninguno de los dos.
• Los IDs que pones en la lista también pasan a ser los propietarios de comandos de OpenClaw (commands.ownerAllowFrom), así que los comandos solo para el propietario funcionan para ti desde el primer mensaje.
• El token llega a OpenClaw como TELEGRAM_BOT_TOKEN en su entorno. Un token escrito en el archivo de ajustes propio de OpenClaw tendría prioridad sobre ese, así que el arranque lo quita del archivo: el token del panel Agente es el que se usa.
• Los grupos siguen cerrados: OpenClaw no admite ningún grupo hasta que se añade uno a sus ajustes, y un ajuste que deje hablar con el agente a cualquiera se vuelve a poner con tus IDs en el siguiente arranque.

Paso 3 en tu propia máquina

1. Añade el token:

   openclaw channels add --channel telegram --token <bot-token>

   o define TELEGRAM_BOT_TOKEN en el entorno del Gateway. Un token en el archivo de configuración tiene prioridad sobre la variable de entorno.
2. Permite solo a tu usuario en ~/.openclaw/openclaw.json:

   {
     channels: {
       telegram: {
         enabled: true,
         dmPolicy: "allowlist",
         allowFrom: ["123456789"],
       },
     },
     commands: {
       ownerAllowFrom: ["telegram:123456789"],
     },
   }

   La parte commands te convierte en el propietario para los comandos solo para propietarios: OpenClaw no lo hace con una lista de permitidos escrita a mano. Una allowlist con un allowFrom vacío bloquea todos los mensajes directos y la comprobación de configuración de OpenClaw la rechaza.
3. O mantén el modo pairing por defecto y apruébate a ti mismo después de tu primer mensaje:

   openclaw pairing list telegram
   openclaw pairing approve telegram <CODE>

   Los códigos caducan después de una hora. El primer emparejamiento aprobado también te convierte en el propietario de comandos.
4. Comprueba el canal con openclaw channels status --probe.

Cuando no responde

¿Quieres Discord también? Mira conectar OpenClaw a Discord. ¿Aún no lo has configurado? Crea un servidor OpenClaw.

PlayNHost no está afiliada a la OpenClaw Foundation. OpenClaw es software de código abierto bajo la licencia MIT.