# Безопасность и приватность CLI Telegram (/ru/docs/tg/security)

Выберите, что разрешено агенту, и узнайте, где хранятся данные входа и сообщения. Здесь объясняются защита, её ограничения и настройки, которые стоит проверить перед разрешением отправки и других изменений.

Прочтите эту страницу, прежде чем предоставить ИИ-агенту или сценарию доступ к вашему аккаунту Telegram через `tg` или когда вы захотите узнать, что `tg` хранит на вашем компьютере. Здесь объясняется, где хранится ваш логин, что `tg` записывает на диск, с какими серверами он общается, что останавливает нежелательную отправку и что делать, если данные входа утекли. В конце вы сможете судить, что мог сделать кто-то, имеющий доступ к этому компьютеру, или агент, имеющий доступ к `tg`.

Слова, которые используются на этой странице:

- **Сессия**: файл, который сохраняет ваш вход в Telegram. Тот, у кого он есть, может использовать ваш аккаунт.
- **Локальный архив**: база данных на вашем компьютере, где `tg` и `max` хранят прочитанные сообщения. Он используется обоими инструментами и не зашифрован.
- **Защита отправки**: проверки, через которые проходит каждое изменение перед отправкой в Telegram: разрешения, список разрешенных получателей и часовой лимит отправки.

Все, что общего у каждого инструмента WireCat — локальное хранилище, защита отправки, действия агента через MCP, текст других людей на вашем экране, как сообщить об уязвимости — находится на [общей странице безопасности](/llms.mdx/docs/ru/security/content.md). Здесь описаны особенности Telegram.

## Коротко [#коротко]

- **Файл сессии — это ваш вход.** Любой, кто может его прочитать, пользуется вашим аккаунтом без пароля и кода ([ниже](#where-the-login-lives)).
- **Ни одна команда не принимает секрет аргументом** — ни хеш приложения, ни пароль 2FA, ни код входа, ни номер телефона.
- **Защита отправок общая**: `permissions`, список получателей и `sends_per_hour` проверяют все команды и инструменты MCP ([ниже](#the-send-guard)).
- **`tg` связывается с Telegram, npm и my.telegram.org**, а также с серверами загрузки моделей и явно настроенными адресами эмбеддингов и анализа ([ниже](#what-goes-over-the-network)). 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` и сохранился бы в истории оболочки.

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

## Что сохраняется на диске [#что-сохраняется-на-диске]

Локальная база, настройки, записи запусков, журнал отправок, список получателей, модели речи и экспорты описаны на [общей странице](/llms.mdx/docs/ru/security/content.md). База общая с `max`, содержит **полный текст** всех сообщений, прочитанных или отправленных `tg`, и не зашифрована. Кроме того, `tg` записывает:

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

Точные пути на этой машине: `tg personal doctor`. Папки в каждой системе: [куда идут файлы](/llms.mdx/docs/ru/tg/installation/content.md#where-files-go).

Если компьютер потерян, завершите сессию с другого устройства: Telegram → Настройки → Устройства → сессия, созданная `tg`. После этого файл сессии бесполезен.

## Защита отправок [#защита-отправок]

Все команды и инструменты MCP, изменяющие что-либо в Telegram, проходят общую защиту: `permissions`, список получателей, `sends_per_hour` (по умолчанию 30) и журнал без текста. Как работает каждая проверка, её код завершения и чего она не может удержать: [общая страница](/llms.mdx/docs/ru/security/content.md).

```sh
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 не позволяет обойти защиту этих мест.

## Чужой текст в терминале [#чужой-текст-в-терминале]

Управляющие символы, переносы строк в именах и похожие названия чатов обрабатываются так, как описано на [общей странице](/llms.mdx/docs/ru/security/content.md). Имя скачанного файла также теряет начальную точку.

## Сетевые подключения [#сетевые-подключения]

- **Telegram** через MTProto для команд личного аккаунта, включая файлы и фотографии. Команды бота используют HTTPS Bot API; `bot messages sync` использует отдельную сессию бота MTProto для истории.
- **npm**, один раз в день на терминале, чтобы проверить, существует ли более новая версия `tg`, а также на `tg upgrade`.   `update_check` или `TG_NO_UPDATE_CHECK=1` отключает его ([конфигурация](/llms.mdx/docs/ru/tg/configuration/content.md)).
- **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 [#ваше-приложение-и-правила-telegram]

`tg` — клиент Telegram, как приложения на телефоне и компьютере. Он входит с вашим собственным приложением из my.telegram.org и соблюдает [условия API Telegram](https://core.telegram.org/api/terms). Часовой лимит включён по умолчанию, чтобы агент отправлял сообщения с обычной для человека частотой.

## Безопасность входа [#безопасность-входа]

`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`.

## Дальше [#дальше]

- [Общая страница безопасности](/llms.mdx/docs/ru/security/content.md): архив, защита отправки, агенты, MCP и сообщение об уязвимости.
- [Диагностика](/llms.mdx/docs/ru/tg/diagnostics/content.md): что именно записывается, а что никогда не записывается
- [Вход, сессии и профили](/llms.mdx/docs/ru/tg/sessions/content.md): приложение, системное хранилище ключей, профили, выход из системы.
- [MCP](/llms.mdx/docs/ru/tg/mcp/content.md): что агент может делать через MCP, и что меняет каждый уровень и флаг.
- [Разрешения](/llms.mdx/docs/ru/tg/permissions/content.md): как установить `permissions` и `sends_per_hour`
