Better-TG-CLI: частые вопросы
Better-TG-CLI — открытый CLI и MCP-сервер Telegram, через который ИИ-агенты работают с вашим собственным аккаунтом. Здесь ответы на самые частые вопросы.
Что такое Better-TG-CLI?
Неофициальный клиент Telegram с открытым кодом (MIT) для вашего собственного аккаунта, сделанный для ИИ-агентов. Это CLI (telegram, около 60 команд), MCP-сервер (telegram mcp) и скилл для Claude Code, Codex, Cursor, Claude Desktop и Gemini CLI. Он работает по MTProto, собственному клиентскому протоколу Telegram, на актуальном слое API.
Это бот Telegram?
Нет. Он входит от вашего имени, как Telegram Desktop, и видит ровно то же, что и вы. Бот не может читать ваши чаты, а он может.
Telegram заблокирует мой аккаунт?
Пользоваться своим аккаунтом из стороннего клиента разрешают условия API Telegram. Аккаунты ограничивают за поведение, похожее на бота: массовые рассылки, массовые вступления и приглашения, спам, новые аккаунты, которые сразу делают очень много. Пользуйтесь им так же, как пользовались бы Telegram сами; скилл учит агентов избегать таких действий.
Может ли агент отправлять сообщения сам?
Не по замыслу. После входа профиль в режиме ask: перед каждой записью агент показывает вам точное действие и выполняет его только после вашего «да». telegram write-access off включает режим только чтения. Это работает, пока агент следует инструкциям: агент с доступом к оболочке под вашим пользователем может прочитать сессию и действовать от вашего имени.
Нужны ли свои API-ключи Telegram?
Нет. Получите бесплатный ключ входа на better-tg-cli.com/login (одна почта, до 3 компьютеров) или создайте свои ключи на my.telegram.org и запустите telegram auth.
Где хранится сессия и кто видит мои сообщения?
Сессия хранится в «Связке ключей» macOS, Secret Service в Linux, DPAPI в Windows или в 1Password. CLI общается с Telegram напрямую и не собирает аналитику. Всё, что читает агент, видит и компания, которая стоит за этим агентом.
Чтение помечает сообщения прочитанными?
Нет. read, inbox и search оставляют чаты непрочитанными; помечает только telegram mark-read.
Можно ли читать комментарии в каналах, треды и темы форумов и нажимать кнопки ботов?
Да: telegram read --thread открывает ответы или комментарии под постом, telegram topics показывает темы форума, а telegram read --topic читает одну из них; telegram click нажимает кнопки в сообщениях ботов.
Работает ли он в Windows?
Да, экспериментально: scoop install better-tg-cli или npm. Секреты хранятся с помощью DPAPI в Windows.
Можно ли пользоваться им из ChatGPT, Grok Bot или другого облачного агента?
Облачные агенты не могут запустить программу на вашем компьютере, поэтому запустите MCP-сервер по HTTP (telegram mcp --http) с bearer-токеном и откройте к нему доступ через туннель.