Better-TG-CLI: preguntas frecuentes
Better-TG-CLI es un CLI y servidor MCP de Telegram de código abierto que los agentes de IA usan con tu propia cuenta. Estas son las preguntas más habituales.
¿Qué es Better-TG-CLI?
Un cliente de Telegram no oficial y de código abierto (MIT) para tu propia cuenta, hecho para agentes de IA. Es un CLI (telegram, unos 60 comandos), un servidor MCP (telegram mcp) y un skill para Claude Code, Codex, Cursor, Claude Desktop y Gemini CLI. Usa MTProto, el protocolo de clientes de Telegram, en la capa actual de la API.
¿Es un bot de Telegram?
No. Inicia sesión como tú, igual que Telegram Desktop, y ve exactamente lo que ves tú. Un bot no puede leer tus chats; esto sí.
¿Telegram bloqueará mi cuenta?
Usar tu propia cuenta desde un cliente de terceros está permitido por los términos de la API de Telegram. Lo que hace que se limiten cuentas es un comportamiento que parece de bot: envíos masivos, entradas o invitaciones masivas, spam y cuentas nuevas que hacen mucho de golpe. Úsalo como usarías Telegram tú mismo; el skill indica a los agentes que eviten esos patrones.
¿Puede un agente enviar mensajes por su cuenta?
No por diseño. Tras iniciar sesión, el perfil está en modo ask: antes de cada escritura el agente te muestra la acción exacta y solo la ejecuta cuando dices que sí. telegram write-access off lo deja en solo lectura. Esto depende de que el agente siga sus instrucciones: un agente con shell en tu usuario podría leer la sesión y actuar como tú.
¿Necesito mis propias claves de API de Telegram?
No. Consigue una clave de acceso gratis en better-tg-cli.com/login (un correo, hasta 3 equipos), o crea tus propias claves en my.telegram.org y ejecuta telegram auth.
¿Dónde se guarda mi sesión y quién ve mis mensajes?
La sesión se guarda en el Llavero de macOS, el Secret Service de Linux, DPAPI de Windows o 1Password. La CLI habla con Telegram directamente y no tiene analítica. Todo lo que lee tu agente también lo ve la empresa que está detrás de ese agente.
¿Leer marca los mensajes como leídos?
No. read, inbox y search dejan los chats sin leer; solo telegram mark-read los marca.
¿Puede leer comentarios de canales, hilos y temas de foros, y pulsar botones de bots?
Sí: telegram read --thread abre las respuestas o comentarios de una publicación, telegram topics lista los temas de un foro y telegram read --topic lee uno, y telegram click pulsa botones en los mensajes de bots.
¿Funciona en Windows?
Sí, de forma experimental: scoop install better-tg-cli o npm. Los secretos se guardan con DPAPI de Windows.
¿Puedo usarlo desde ChatGPT, Grok Bot u otro agente en la nube?
Los agentes en la nube no pueden iniciar un programa en tu equipo, así que ejecuta el servidor MCP por HTTP (telegram mcp --http) con un token bearer y accede a él a través de un túnel.