Si tu bot de Telegram, por ejemplo, aparece en línea pero no habla en los grupos, la documentación es directa: revisa el requireMention (obligación de mencionar al bot) y, sobre todo, el modo de privacidad del bot. ¿Quieres que el bot lea todos los mensajes del grupo sin necesidad de que lo mencionen? Debes desactivar el modo de privacidad con el comando /setprivacy desde @BotFather o nombrar al bot administrador del grupo. Un paso crítico que muchos olvidan: después de cambiar este ajuste, saca y vuelve a añadir al bot al grupo para que Telegram aplique el nuevo permiso correctamente.

Fallos Comunes y Soluciones Directas

Aquí tienes las ramas de diagnóstico más probables para que dejes de dar palos de ciego:

1. Error de Red o Timeout

Si ves errores de red al enviar mensajes, los logs de la API de Telegram serán tu mejor pista. Generalmente el problema radica en la configuración de DNS, IPv6 o el enrutamiento del proxy hacia api.telegram.org. Verifica la conectividad de tu servidor con ese endpoint.

2. Token 401 No Autorizado

¿El arranque muestra getMe returned 401? Traducción: el token que te dio @BotFather es incorrecto o ha expirado. Tienes que revisar y actualizar la configuración, ya sea la variable de entorno TELEGRAM_BOT_TOKEN, el archivo de token o el botToken en el archivo de configuración YAML para la cuenta por defecto.

3. Polling Atascado o Desconexiones Frecuentes

Si el bot tarda en responder o se desconecta a cada rato, debes monitorizar con openclaw logs --follow. Si el problema se alarga, la documentación insiste en sospechar del proxy, el DNS o el IPv6. Si además ves un error de getUpdates con conflicto 409, significa que otra instancia de OpenClaw, un script externo u otro poller está usando el mismo token de bot simultáneamente. OpenClaw está diseñado para que solo un proceso de polling activo use cada token.

4. Problemas Tras una Actualización

¿Todo funcionaba bien hasta que hiciste un git pull o actualizaste el paquete? La documentación prescribe un ritual de reinicio:

1. Ejecuta openclaw status --all.
2. Pasa el doctor: openclaw doctor --fix. Este comando es clave porque limpia residuos de dependencias dañadas o archivos de staging/auth obsoletos.
3. Reinicia la puerta de enlace: openclaw gateway restart.
4. Vuelve a comprobar con openclaw status --all.

Especialmente si en el estado ves el mensaje "plugin load failed: dependency tree corrupted", no busques más: el canal está configurado pero la carga del plugin falló por esta corrupción. Ejecutar openclaw doctor --fix antes de reiniciar es la única ruta señalada en los documentos.

Checklist para Configurar Telegram Correctamente

Un error de novato es intentar usar openclaw channels login telegram. En OpenClaw, el canal de Telegram no se autentica así. El flujo correcto es:

1. Obtener el token de @BotFather.
2. Colocarlo en la configuración (channels.telegram.botToken) o en la variable de entorno.
3. Activar explícitamente channels.telegram.enabled: true.
4. Arrancar la puerta de enlace.

Para los mensajes directos, se usa un sistema de vinculación por pares. Después de arrancar, escribe a tu bot y luego ejecuta openclaw pairing list telegram. Deberías ver una solicitud de vinculación pendiente que has de aprobar manualmente.

En Conclusión

Insuficiente evidencia para un veredicto cerrado con solo el aviso "no funciona". Pero la ruta de investigación es clarísima. Sin el resultado de esos cinco comandos de diagnóstico, cualquier solución es un disparo a ciegas. Para empezar a acotar el problema en Telegram, céntrate en estos cuatro sospechosos habituales: el modo de privacidad/las menciones, el token 401, los problemas de DNS/IPv6/proxy o el conflicto de polling 409.

Si tu bot de Telegram, por ejemplo, aparece en línea pero no habla en los grupos, la documentación es directa: revisa el requireMention (obligación de mencionar al bot) y, sobre todo, el modo de privacidad del bot. ¿Quieres que el bot lea todos los mensajes del grupo sin necesidad de que lo mencionen? Debes desactivar el modo de privacidad con el comando /setprivacy desde @BotFather o nombrar al bot administrador del grupo. Un paso crítico que muchos olvidan: después de cambiar este ajuste, saca y vuelve a añadir al bot al grupo para que Telegram aplique el nuevo permiso correctamente.

Fallos Comunes y Soluciones Directas

Aquí tienes las ramas de diagnóstico más probables para que dejes de dar palos de ciego:

1. Error de Red o Timeout

Si ves errores de red al enviar mensajes, los logs de la API de Telegram serán tu mejor pista. Generalmente el problema radica en la configuración de DNS, IPv6 o el enrutamiento del proxy hacia api.telegram.org. Verifica la conectividad de tu servidor con ese endpoint.

2. Token 401 No Autorizado

¿El arranque muestra getMe returned 401? Traducción: el token que te dio @BotFather es incorrecto o ha expirado. Tienes que revisar y actualizar la configuración, ya sea la variable de entorno TELEGRAM_BOT_TOKEN, el archivo de token o el botToken en el archivo de configuración YAML para la cuenta por defecto.

3. Polling Atascado o Desconexiones Frecuentes

Si el bot tarda en responder o se desconecta a cada rato, debes monitorizar con openclaw logs --follow. Si el problema se alarga, la documentación insiste en sospechar del proxy, el DNS o el IPv6. Si además ves un error de getUpdates con conflicto 409, significa que otra instancia de OpenClaw, un script externo u otro poller está usando el mismo token de bot simultáneamente. OpenClaw está diseñado para que solo un proceso de polling activo use cada token.

4. Problemas Tras una Actualización

¿Todo funcionaba bien hasta que hiciste un git pull o actualizaste el paquete? La documentación prescribe un ritual de reinicio:

1. Ejecuta openclaw status --all.
2. Pasa el doctor: openclaw doctor --fix. Este comando es clave porque limpia residuos de dependencias dañadas o archivos de staging/auth obsoletos.
3. Reinicia la puerta de enlace: openclaw gateway restart.
4. Vuelve a comprobar con openclaw status --all.

Especialmente si en el estado ves el mensaje "plugin load failed: dependency tree corrupted", no busques más: el canal está configurado pero la carga del plugin falló por esta corrupción. Ejecutar openclaw doctor --fix antes de reiniciar es la única ruta señalada en los documentos.

Checklist para Configurar Telegram Correctamente

Un error de novato es intentar usar openclaw channels login telegram. En OpenClaw, el canal de Telegram no se autentica así. El flujo correcto es:

1. Obtener el token de @BotFather.
2. Colocarlo en la configuración (channels.telegram.botToken) o en la variable de entorno.
3. Activar explícitamente channels.telegram.enabled: true.
4. Arrancar la puerta de enlace.

Para los mensajes directos, se usa un sistema de vinculación por pares. Después de arrancar, escribe a tu bot y luego ejecuta openclaw pairing list telegram. Deberías ver una solicitud de vinculación pendiente que has de aprobar manualmente.

En Conclusión

Insuficiente evidencia para un veredicto cerrado con solo el aviso "no funciona". Pero la ruta de investigación es clarísima. Sin el resultado de esos cinco comandos de diagnóstico, cualquier solución es un disparo a ciegas. Para empezar a acotar el problema en Telegram, céntrate en estos cuatro sospechosos habituales: el modo de privacidad/las menciones, el token 401, los problemas de DNS/IPv6/proxy o el conflicto de polling 409.