Seguridad y privacidad de la CLI de Telegram
Consulta los permisos, las credenciales, el almacenamiento local y las confirmaciones de la CLI de Telegram.
Elige lo que puede hacer tu agente y conoce dónde se guardan los datos de acceso y mensajes. Aquí se explican las protecciones, sus límites y los ajustes que puedes comprobar antes de permitir envíos u otros cambios.
Lea esta página antes de darle acceso a un agente de IA o un script a su cuenta de Telegram a través de tg, o cuando quiera saber qué guarda tg en su computadora. Explica dónde se guarda su inicio de sesión, qué escribe tg en el disco, con qué servidores habla, qué detiene un envío no deseado y qué hacer si se filtra su inicio de sesión. Al final podrás juzgar lo que podría hacer alguien con acceso a esta computadora, o un agente con acceso a tg.
Palabras que utiliza esta página:
- Sesión: el archivo que te mantiene conectado a Telegram. Quien la tenga podrá utilizar su cuenta.
- Archivo local: la base de datos de tu ordenador donde
tgymaxguardan los mensajes que han leído. Es compartido por ambas herramientas y no está cifrado. - Control de envío: las comprobaciones por las que pasa cada cambio antes de llegar a Telegram: permisos, la lista de destinatarios permitidos y el límite de envío por hora.
Lo que cada herramienta WireCat tiene en común (el archivo local, el control de envío, lo que un agente puede hacer a través de MCP, el texto de otras personas en su pantalla, cómo informar una vulnerabilidad) se encuentra en la página de seguridad compartida. Esta página cubre lo que solo agrega Telegram.
Resumen
- El archivo de sesión es tu acceso. Quien pueda leerlo usa tu cuenta, sin contraseña ni código (más abajo).
- Ningún comando acepta secretos como argumento: ni el hash de la aplicación, ni la contraseña 2FA, ni el código de inicio de sesión, ni un número de teléfono.
- La protección de envíos es la común: todos los comandos y herramientas MCP comprueban
permissions, la lista de destinatarios ysends_per_hour(más abajo). tgse comunica con Telegram, npm y my.telegram.org, y con servidores de descarga de modelos o servicios de embeddings y análisis configurados explícitamente (más abajo). Telegram usa el proxy que configures; la comprobación de actualizaciones npm ytg upgradeno.- El archivo local no está cifrado y se conserva después de cerrar la sesión. Solo el cifrado del disco completo lo protege si te roban el disco.
- No protege frente a alguien que utilice tu usuario del equipo ni frente a un agente al que se permite cambiar los ajustes. Los límites detienen a un agente al que un mensaje que ha leído convence para enviar, no a uno que se propone sortearlos; frente a ese, ejecuta el agente en un entorno aislado (sandbox) o como un usuario distinto.
Dónde se guarda la sesión
| Contenido | Ubicación | Quién puede usarlo |
|---|---|---|
| sesión | sessions/<profile>.session en el directorio de estado, 0600 en carpeta 0700 | cualquiera que leal archivo: permite acceder como una contraseña |
| sesión de historial del bot | bots/<profile>/mtproto-<bot-id>.session en el directorio de estado | quien pueda leerla puede usar esa autorización del bot; protégela como la sesión personal |
| identificador y hash de la aplicación | llavero del sistema; credentials.json (0600) junto a la configuración si no hay almacén | solo junto con una sesión |
| datos para CI | TG_API_ID y TG_API_HASH | el proceso que los tenga |
| contraseña del proxy o secreto de MTProxy | llavero del sistema, o credentials.json, uno por perfil y otro para --defaults; la configuración guarda la URL sin él | cualquiera que pueda usar el proxy con él |
La sesión es la clave de autorización de Telegram. Copiar el archivo copia el acceso, sin contraseña ni código. Trátalo como una contraseña: nunca lo subas al repositorio, adjuntes ni pegues.
Ningún comando acepta secretos como argumento. El hash de la aplicación y la contraseña 2FA se solicitan sin mostrarlos; el código y el teléfono se solicitan o se leen por stdin. Un argumento sería visible para todos los procesos mediante ps y quedaría en el historial.
La configuración no admite secretos: no tiene campos para hash, teléfonos ni sesiones.
Qué se guarda en disco
El archivo local, la configuración, los registros de ejecución, el registro de envíos, la lista de destinatarios, los modelos de voz y las exportaciones se describen en la página común. El archivo local se comparte con max, contiene el texto completo de todos los mensajes que tg ha leído o enviado y no está cifrado. Además, tg escribe:
Las rutas exactas en esta máquina: tg personal doctor. Las carpetas de cada sistema: dónde van los archivos.
Si pierdes el equipo, cierra la sesión desde otro dispositivo: Telegram → Ajustes → Dispositivos, y termina la creada por tg. Así el archivo de sesión deja de servir.
Protección de envíos
Todos los comandos y herramientas MCP que cambian algo en Telegram pasan por la protección común: permissions, la lista de destinatarios, sends_per_hour (30 por defecto) y un registro sin texto. Cómo funciona cada control, su código de salida y lo que no puede impedir: la página común.
tg personal config set permissions.messages readonly # no change to messages from this profile
tg personal config set permissions.messages.send ask # a question before each send
tg personal recipients add "Book club" # the first add turns the list on
tg personal sends list # every attempt: sent, refused, failed, or not knownEn Telegram cuentan para el límite por hora: mensajes, reenvíos, ediciones, mensajes fijados con notificación, cada mensaje eliminado, grupos nuevos y cada persona añadida. No cuentan reacciones, votos, mensajes fijados sin aviso ni marcar como leído. Los reenvíos se comprueban contra el chat de destino.
TG_PROFILE_LOCK fija el perfil allí donde el agente no puede modificar su entorno. --file, --photo y los campos @path de bot api rechazan los archivos y carpetas conocidos de credenciales, las carpetas de tg y el almacén local, incluidos los destinos de enlaces simbólicos. Las carpetas de trabajo ocultas normales están permitidas; MCP no puede eludir la protección de estos lugares.
Texto ajeno en tu pantalla
Los caracteres de control, los saltos de línea en nombres y los títulos de chat que se parecen entre sí se tratan como describe la página común. Los nombres de archivos descargados pierden también cualquier punto inicial.
Qué pasa por la red
- Telegram, a través de MTProto para comandos de cuentas personales, incluidos archivos y fotos. Los comandos de bot utilizan la API de bot HTTPS;
bot messages syncutiliza una sesión de bot MTProto separada para el historial. - npm, una vez al día en una terminal, para ver si existe un
tgmás nuevo y entg upgrade.update_checkoTG_NO_UPDATE_CHECK=1lo apaga (configuración). - my.telegram.org, solo durante
tg personal setupotg personal session start: abierto en su navegador, o, con--app auto, controlado portg. Una aplicación quetgcrea allí se titulatg-cliy tiene la página GitHub de este proyecto como dirección. - Hugging Face y GitHub, solo cuando ejecutas
tg personal models downloadotg personal models download. Un mensaje de voz nunca llega allí: en esta máquina se ejecuta un modelo local. - Los endpoints de embeddings configurados reciben texto de conversación de
conversations embeddespués del consentimiento y consulta de texto desearch conversationsremoto, incluidas las búsquedas de MCP. Las incrustaciones locales no envían ningún texto. - Los puntos finales de análisis configurados reciben lotes de mensajes limitados solo con
conversations links rebuild --analyze --chat, después del consentimiento limitado a la cuenta, el chat y el proveedor; La construcción ordinaria no envía nada.
No hay telemetría.
Tu aplicación y las condiciones de Telegram
tg es un cliente de Telegram, igual que las aplicaciones del teléfono y del ordenador. Inicia sesión con tu propia aplicación de my.telegram.org y sigue las condiciones de la API de Telegram. El límite por hora está activado por defecto para que el agente envíe a un ritmo similar al de una persona.
Inicio de sesión
tg personal setup y tg personal session start dibujan el QR en la terminal. Queda en el historial visual, pero Telegram lo renueva mientras esperas, por lo que los antiguos no sirven. Sin terminal se imprime como texto, para que un agente lo pegue en el chat. Un código de acceso mostrado así solo inicia sesión con la cuenta que lo escanea, aquí y solo mientras es válido.
--app auto rellena my.telegram.org sin navegador: solicita el teléfono y el código que el sitio envía por Telegram, nada más.
Cada inicio añade un dispositivo en Telegram → Ajustes → Dispositivos.
Cambios de la instalación global
El postinstall global de npm instala la skill incluida en los directorios de agentes del usuario solo cuando TG_INSTALL_AGENT nombra un agente; en Windows añade la carpeta de comandos npm al PATH del usuario y elimina solo el lanzador tg.ps1 generado por npm para este paquete. Conserva el lanzador .cmd. Las instalaciones de proyectos y npx no hacen estos cambios. Si no está definida o vale TG_INSTALL_AGENT=none, no se instala ninguna skill. El instalador independiente de Windows hace la misma preparación aunque los scripts npm estén desactivados. No cambia la política de ejecución, el PATH del equipo, las credenciales ni el estado de la cuenta. La instalación nunca inicia sesión ni lee chats.
Si se filtra la sesión
- En Telegram → Ajustes → Dispositivos, termina la sesión creada por
tg. También puedes ejecutartg personal session enden este equipo: termina la sesión en Telegram y elimina el archivo. - Inicia sesión de nuevo:
tg personal session start.
Siguiente paso
- Página de seguridad compartida: el archivo local, el guardia, agentes y MCP, reportando una vulnerabilidad
- Diagnóstico: qué se registra exactamente y qué nunca se registra
- Inicio de sesión, sesiones y perfiles: la aplicación, el llavero, perfiles, cerrar sesión
- MCP: qué puede hacer un agente a través de MCP y qué cambia en cada nivel y bandera
- Permisos: cómo configurar
permissionsysends_per_hour