МессенджерыTelegram

Безопасность и приватность 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) рядом с настройкамитолько вместе с сессией
для CITG_API_ID и TG_API_HASHпроцесс с этими переменными
пароль прокси или секрет MTProxyсистемное хранилище ключей или credentials.json, по одному на профиль и один для --defaults; в настройках хранится адрес без неголюбой, у кого он есть, может пользоваться прокси

Сессия — ключ авторизации Telegram. Копирование файла копирует вход без пароля и кода. Обращайтесь с ним как с паролем: не добавляйте в репозиторий, не прикладывайте к обращениям и не вставляйте в переписку.

Секреты не передаются аргументами команд. Хеш приложения и пароль 2FA запрашиваются скрытым вводом; код входа и телефон — запросом или через stdin. Аргумент был бы виден всем процессам на компьютере в ps и сохранился бы в истории оболочки.

В файле настроек нет полей для секретов: хеша приложения, телефона или сессии.

Что сохраняется на диске

Локальная база, настройки, записи запусков, журнал отправок, список получателей, модели речи и экспорты описаны на общей странице. База общая с max, содержит полный текст всех сообщений, прочитанных или отправленных tg, и не зашифрована. Кроме того, tg записывает:

ДанныеГдеСодержимоеПрава
позиция inbox --newinbox/<profile>.jsonгде остановилась последняя проверка0600
фоновые задания загрузкикаталог состояниячат, прогресс, результат0600
журнал и блокировка serveserve/<profile>.log или журнал systemdдействия serve0600
служба systemd или агент launchd — только tg personal server installкаталог служб пользователякоманда запуска serve0644
резервная копия — только tg personal store backupуказанный файлкопия всей базы0600

Точные пути на этой машине: 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, ключи или состояние аккаунта. Установка не входит в аккаунт и не читает чаты.

Если сессия утекла

  1. В Telegram откройте Настройки → Устройства и завершите сессию, созданную tg. Либо выполните tg personal session end на этом компьютере: она завершит сессию в Telegram и удалит файл.
  2. Войдите снова: tg personal session start.

Дальше