Configurar Telegram en OpenClaw

Un bot de Telegram es el canal más rápido de poner en marcha, porque toda la configuración consiste en un token de BotFather y un comando que lo guarda. Aquí tienes la configuración rápida paso a paso, las reglas de precedencia de los tokens, los ajustes que viven en el lado de Telegram y no en la configuración, y la elección de transporte entre el sondeo largo y un webhook.

Configuración rápida

• Los dos flujos de BotFather terminan con un token que pegas en OpenClaw: el flujo por chat, en el que hablas con la cuenta BotFather, confirmas que el nombre de usuario es exacto, ejecutas el comando para crear un bot nuevo y guardas el token, o el flujo web en la aplicación web de BotFather, que funciona en todos los clientes de Telegram y te permite crear el bot desde una interfaz y copiar su token.
• La forma más rápida de configurarlo es el comando channels add con el canal de Telegram y el token, que escribe el token en la configuración por ti; editar a mano, en cambio, implica un bloque de Telegram con el canal activado, el token del bot, la política de mensajes directos en modo emparejamiento y una entrada de grupo comodín que exige una mención, y la variable de entorno del token del bot es un respaldo solo para la cuenta predeterminada, ya que las cuentas con nombre deben usar la clave del token o un archivo de token.
• Con la recarga en caliente predeterminada, el gateway en ejecución aplica la nueva configuración del canal, y la comprobación de estado de los canales verifica que Telegram esté listo; si el gateway está desconectado, lo inicias como servicio gestionado o en la terminal, y un entorno de servicio modificado necesita un reinicio para cargarse.
• Enviar cualquier mensaje al bot crea la solicitud de emparejamiento que muestra el comando de lista de emparejamientos y que acepta el comando de aprobación, con códigos que caducan al cabo de una hora; después, añadir el bot a un grupo requiere tu ID de usuario numérico para las listas de permitidos y el ID del chat del grupo como clave en el mapa de grupos, que se obtiene de los registros, de un bot de ID reenviados o de las actualizaciones de la Bot API y se confirma con el comando whoami una vez que el grupo está permitido; los ID negativos de supergrupo van en el mapa de grupos, nunca en la lista de remitentes del grupo.

Telegram no usa openclaw channels login telegram.

Los tokens y el lado de Telegram

La resolución del token tiene en cuenta la cuenta: un archivo de token prevalece sobre la clave del token del bot, esa clave prevalece sobre el entorno, la configuración siempre gana a la variable de entorno, que solo se resuelve para la cuenta predeterminada, y tras un arranque correcto OpenClaw guarda en caché la identidad del bot durante un máximo de 24 horas para que los reinicios se ahorren una llamada getMe adicional; un token cambiado o eliminado vacía esa caché. En el lado de Telegram, los bots tienen activado por defecto el modo de privacidad, que limita qué mensajes de grupo reciben; para ver todos los mensajes del grupo, o desactivas el modo de privacidad con el comando para configurar la privacidad o haces al bot administrador del grupo, y después de cambiar el modo de privacidad quitas el bot de cada grupo y lo vuelves a añadir para que Telegram aplique el cambio. El estado de administrador se controla en los ajustes del grupo, y los bots administradores reciben todos los mensajes del grupo, lo que conviene para un comportamiento de grupo siempre activo. Los ajustes útiles de BotFather son el de unirse a grupos, que permite o impide que se añada el bot a grupos, y el de privacidad, para la visibilidad en los grupos; ambos están también disponibles en la aplicación web de BotFather.

Sondeo largo o webhook

• El sondeo largo (long polling) es el predeterminado; el modo webhook necesita una URL de webhook y un secreto de webhook, con una ruta opcional que por defecto es la ruta telegram-webhook, un host que por defecto es loopback, un puerto que por defecto es 8787 y una ruta de certificado para un PEM autofirmado en configuraciones con IP directa o sin dominio; el listener reserva la ruta de salud para las comprobaciones de salud, así que la ruta del webhook debe usar otra distinta, y una configuración existente en esa ruta debe cambiar de ruta, actualizar la URL y la asignación del proxy inverso, y verificar el cambio del listener con la comprobación de estado.
• En modo de sondeo largo, OpenClaw guarda su posición de reinicio después de que una actualización se confirma en la cola de entrada duradera, así que un manejador que falla sigue pudiendo reintentarse desde esa cola; el listener local se enlaza por defecto a loopback en el puerto 8787, y la entrada pública implica un proxy inverso delante o un host comodín configurado intencionadamente.
• El modo webhook valida las protecciones de la petición, el token secreto de Telegram y el cuerpo JSON, confirma la actualización en la cola duradera antes de devolver un 200 vacío, y marca la adopción duradera correcta con una cabecera de entrega aceptada que omiten las respuestas de salud, enrutamiento, autenticación, validación y error de almacenamiento, de modo que un proxy inverso puede exigirla en lugar de deducir la aceptación a partir de los tiempos; tras la escritura duradera, las actualizaciones se reclaman y se procesan a través del drenaje de entrada del núcleo con carriles por chat y por tema, y los turnos lentos del agente nunca retienen la confirmación de entrega de Telegram.

OpenClaw en Telegram es el artículo del canal al que pertenece esta configuración, y el control de acceso de Telegram en OpenClaw, lo que conviene decidir después sobre quién puede llegar al bot.

Dónde fallan las configuraciones

Casi todas las configuraciones fallidas de Telegram se deben a una de tres cosas: un token pegado para una cuenta con nombre a través de la variable de entorno que solo sirve a la cuenta predeterminada, un ID de grupo puesto en la lista de remitentes en lugar de en el mapa de grupos, o el modo de privacidad activado con el requisito de mención desactivado. Solucionar problemas de Telegram en OpenClaw repasa esos síntomas en orden, y conecta tu primer canal en cinco minutos es la guía de cinco minutos para un primer canal.

En Diali

En Diali, el canal de Telegram se conecta desde el panel y la configuración de ejecución se genera a partir de ahí y se reemplaza en cada versión, así que los pasos de BotFather del principio de este artículo son la parte que queda de tu lado. Telegram en Diali describe el canal en Diali, y la seguridad en Diali, el perímetro que comparten todos los canales conectados.

• Un token de BotFather; la CLI lo escribe por ti.
• Los códigos de emparejamiento caducan al cabo de una hora; los ID de grupo van en el mapa de grupos.
• Sondeo largo por defecto; los webhooks necesitan un secreto y una ruta libre.