Безопасность и приватность CLI Telegram
Разберитесь в правах CLI для Telegram, данных входа, локальном хранении и подтверждении действий.
Выберите, что разрешено агенту, и узнайте, где хранятся данные входа и сообщения. Здесь объясняются защита, её ограничения и настройки, которые стоит проверить перед разрешением отправки и других изменений.
Прочтите эту страницу, прежде чем предоставить ИИ-агенту или сценарию доступ к вашему аккаунту Telegram через tg или когда вы захотите узнать, что tg хранит на вашем компьютере. Здесь объясняется, где хранится ваш логин, что tg записывает на диск, с какими серверами он общается, что останавливает нежелательную отправку и что делать, если данные входа утекли. В конце вы сможете судить, что мог сделать кто-то, имеющий доступ к этому компьютеру, или агент, имеющий доступ к tg.
Слова, которые используются на этой странице:
- Сессия: файл, который сохраняет ваш вход в Telegram. Тот, у кого он есть, может использовать ваш аккаунт.
- Локальный архив: база данных на вашем компьютере, где
tgиmaxхранят прочитанные сообщения. Он используется обоими инструментами и не зашифрован. - Защита отправки: проверки, через которые проходит каждое изменение перед отправкой в Telegram: разрешения, список разрешенных получателей и часовой лимит отправки.
Все, что общего у каждого инструмента WireCat — локальное хранилище, защита отправки, действия агента через MCP, текст других людей на вашем экране, как сообщить об уязвимости — находится на общей странице безопасности. Здесь описаны особенности Telegram.
Коротко
- Файл сессии — это ваш вход. Любой, кто может его прочитать, пользуется вашим аккаунтом без пароля и кода (ниже).
- Ни одна команда не принимает секрет аргументом — ни хеш приложения, ни пароль 2FA, ни код входа, ни номер телефона.
- Защита отправок общая:
permissions, список получателей иsends_per_hourпроверяют все команды и инструменты MCP (ниже). tgсвязывается с Telegram, npm и my.telegram.org, а также с серверами загрузки моделей и явно настроенными адресами эмбеддингов и анализа (ниже). Telegram использует настроенный вами прокси; проверка обновлений npm иtg upgrade— нет.- Локальный архив не зашифрован и остаётся после выхода из аккаунта. От кражи диска его защищает только шифрование всего диска.
- Защита не действует против того, кто работает под вашим пользователем на этом компьютере, и против агента, которому разрешено менять настройки. Ограничения останавливают агента, которого уговорило отправить прочитанное им сообщение, но не агента, который намеренно пытается их обойти; от такого агента защищает запуск в песочнице или под отдельным пользователем.
Хранение данных входа
| Данные | Где хранятся | Кто может использовать |
|---|---|---|
| сессия | sessions/<profile>.session в каталоге состояния, 0600 в каталоге 0700 | любой, кто читает файл: он равнозначен паролю |
| сессия истории бота | bots/<profile>/mtproto-<bot-id>.session в каталоге состояния | прочитавший файл получает доступ от имени бота; защищайте его так же, как личную сессию |
| идентификатор и хеш приложения | системное хранилище ключей; при его отсутствии credentials.json (0600) рядом с настройками | только вместе с сессией |
| для CI | TG_API_ID и TG_API_HASH | процесс с этими переменными |
| пароль прокси или секрет MTProxy | системное хранилище ключей или credentials.json, по одному на профиль и один для --defaults; в настройках хранится адрес без него | любой, у кого он есть, может пользоваться прокси |
Сессия — ключ авторизации Telegram. Копирование файла копирует вход без пароля и кода. Обращайтесь с ним как с паролем: не добавляйте в репозиторий, не прикладывайте к обращениям и не вставляйте в переписку.
Секреты не передаются аргументами команд. Хеш приложения и пароль 2FA запрашиваются скрытым вводом; код входа и телефон — запросом или через stdin. Аргумент был бы виден всем процессам на компьютере в ps и сохранился бы в истории оболочки.
В файле настроек нет полей для секретов: хеша приложения, телефона или сессии.
Что сохраняется на диске
Локальная база, настройки, записи запусков, журнал отправок, список получателей, модели речи и экспорты описаны на общей странице. База общая с max, содержит полный текст всех сообщений, прочитанных или отправленных tg, и не зашифрована. Кроме того, tg записывает:
Точные пути на этой машине: tg personal doctor. Папки в каждой системе: куда идут файлы.
Если компьютер потерян, завершите сессию с другого устройства: Telegram → Настройки → Устройства → сессия, созданная tg. После этого файл сессии бесполезен.
Защита отправок
Все команды и инструменты MCP, изменяющие что-либо в Telegram, проходят общую защиту: permissions, список получателей, sends_per_hour (по умолчанию 30) и журнал без текста. Как работает каждая проверка, её код завершения и чего она не может удержать: общая страница.
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 knownВ Telegram в часовой лимит входят: сообщение, пересылка, редактирование, закрепление с уведомлением, каждое удаляемое сообщение, новая группа и каждый добавляемый в неё участник. Реакция, голосование, тихое закрепление и отметка чата прочитанным не учитываются. Пересылка проверяется по чату назначения.
TG_PROFILE_LOCK фиксирует профиль там, где агент не может менять своё окружение. --file, --photo и поля @path команды bot api запрещают известные файлы и папки с учётными данными, собственные папки tg и локальное хранилище, включая цели символических ссылок. Обычные скрытые рабочие папки разрешены; MCP не позволяет обойти защиту этих мест.
Чужой текст в терминале
Управляющие символы, переносы строк в именах и похожие названия чатов обрабатываются так, как описано на общей странице. Имя скачанного файла также теряет начальную точку.
Сетевые подключения
- Telegram через MTProto для команд личного аккаунта, включая файлы и фотографии. Команды бота используют HTTPS Bot API;
bot messages syncиспользует отдельную сессию бота MTProto для истории. - npm, один раз в день на терминале, чтобы проверить, существует ли более новая версия
tg, а также наtg upgrade.update_checkилиTG_NO_UPDATE_CHECK=1отключает его (конфигурация). - my.telegram.org, только во время
tg personal setupилиtg personal session start: открывается в браузере или, в случае--app auto, под управлениемtg. Приложениеtgсоздает его под названиемtg-cli, адресом которого является страница этого проекта на GitHub. - Hugging Face и GitHub, только при запуске
tg personal models downloadилиtg personal models download. Голосовое сообщение туда никогда не поступает: на этой машине работает локальная модель. - Настроенные адреса API векторизации получают текст обсуждения от
conversations embedпосле согласия и текст запроса от удаленногоsearch conversations, включая поиск MCP. Локальная векторизация не отправляют текст. - Настроенные конечные точки анализа получают ограниченные пакеты сообщений только с
conversations links rebuild --analyze --chat, после того как согласие распространяется на аккаунт, чат и поставщика; обычная сборка ничего не отправляет.
Телеметрии нет.
Ваше приложение и правила Telegram
tg — клиент Telegram, как приложения на телефоне и компьютере. Он входит с вашим собственным приложением из my.telegram.org и соблюдает условия API Telegram. Часовой лимит включён по умолчанию, чтобы агент отправлял сообщения с обычной для человека частотой.
Безопасность входа
tg personal setup и tg personal session start рисуют QR-код в терминале. Он остаётся в истории вывода; Telegram обновляет его, пока вы ждёте, поэтому старый код бесполезен. Без терминала он печатается текстом, чтобы агент вставил его в чат. Показанный так код входа впускает только тот аккаунт, который его отсканирует, только сюда и только пока код действует.
--app auto заполняет my.telegram.org без браузера и запрашивает только телефон и код, присланный сайтом в Telegram.
Каждый вход добавляет устройство в Telegram → Настройки → Устройства.
Изменения при глобальной установке
Глобальный postinstall npm устанавливает skill в пользовательские каталоги агентов, только когда TG_INSTALL_AGENT называет агента; в Windows добавляет каталог команд npm в пользовательский PATH и удаляет только созданную npm обёртку tg.ps1 этого пакета. Файл .cmd сохраняется. Установка в проект и npx этого не делают. Если переменная не задана или задано TG_INSTALL_AGENT=none, skill не устанавливается. Отдельный установщик Windows выполняет такую же подготовку даже при отключённых скриптах npm. Он не меняет политику выполнения, системный PATH, ключи или состояние аккаунта. Установка не входит в аккаунт и не читает чаты.
Если сессия утекла
- В Telegram откройте Настройки → Устройства и завершите сессию, созданную
tg. Либо выполнитеtg personal session endна этом компьютере: она завершит сессию в Telegram и удалит файл. - Войдите снова:
tg personal session start.
Дальше
- Общая страница безопасности: архив, защита отправки, агенты, MCP и сообщение об уязвимости.
- Диагностика: что именно записывается, а что никогда не записывается
- Вход, сессии и профили: приложение, системное хранилище ключей, профили, выход из системы.
- MCP: что агент может делать через MCP, и что меняет каждый уровень и флаг.
- Разрешения: как установить
permissionsиsends_per_hour