Telegram: начните здесь
Документация: v0.24.0
Подключите свой Telegram к агенту или пользуйтесь им из терминала.
tg — инструмент, с которым ваш ИИ-агент может читать Telegram, находить сообщения и помогать
отвечать. Он работает с вашим личным аккаунтом и его чатами. Можно пользоваться им и самому,
через команды в терминале. Работает на Windows, macOS и Linux.
Вы в разделе документации Telegram. Начало работы, Telegram и MAX доступны в общей навигации слева; переключатель языка находится вверху страницы.
На этой странице
С чего начать
Подключить через агента
Если вы пользуетесь Codex, Claude Code, Cursor, Gemini CLI или Hermes, начните с установки через агента. Скопируйте короткий запрос: агент установит инструмент, поможет войти и проверит подключение. QR-код и подтверждение входа выполняете вы.
Затем откройте подключение вашего агента. Для приложений, которым нужен MCP-сервер, есть руководство по MCP.
Начать самостоятельно в терминале
Откройте пошаговую установку и выберите инструкции для терминала. После установки войдите и посмотрите несколько чатов:
tg setup --agent alltg chats list --limit 5Сначала команда попросит номер телефона и код, пришедший в Telegram, чтобы получить api_id и api_hash с my.telegram.org. Затем покажет QR-код для входа в аккаунт. На телефоне откройте Telegram → Настройки → Устройства → Подключить устройство и отсканируйте его. Дождитесь Logged in as …, затем запускайте команду списка чатов. Полная последовательность входа.
Что такое приложение Telegram и зачем оно нужно?
Это регистрационная карточка программы, которая подключается к Telegram, — в нашем случае CLI tg. Вы заполняете форму, без разработки или скачивания ещё одного приложения. Telegram выдаёт api_id и api_hash, чтобы узнавать программу; QR или код затем подтверждает доступ к вашему аккаунту. Команда может зарегистрировать или получить эти данные за вас. Пояснение и ручной способ через браузер.
Что попробовать после подключения
- Разобрать непрочитанное. Попросите агента показать, какие чаты ждут вашего ответа.
- Вспомнить договорённости. Спросите, что вы обещали за неделю и чего ждёте от других.
- Найти сообщение. Попросите найти нужную переписку, дату, ссылку или файл.
- Помочь с ответом. Дайте агенту контекст и попросите подготовить или отправить сообщение.
Поиск видит только уже сохранённую часть переписки: при необходимости сначала загрузите историю выбранного чата по инструкции архива. Пустой результат не доказывает, что сообщения не было.
Чтение само по себе не отмечает сообщения прочитанными. Отправка, удаление и другие изменения выполняются отдельными командами. Доступ агента можно ограничить: доступ и безопасность.
Найдите инструкцию под свою задачу
| Задача | Куда перейти |
|---|---|
| Читать, искать и отправлять сообщения | Повседневные команды |
| Войти, выйти или добавить другой аккаунт | Вход и профили |
| Найти сообщение по словам, дате или отправителю | Поиск сообщений |
| Загрузить историю и выгрузить переписку | Архив сообщений |
| Следить за вопросами и участниками группы | Ваши группы |
| Найти готовый запрос для агента | Сценарии использования |
| Посмотреть возможности Telegram-ботов | Боты: доступные возможности |
| Разобраться с ошибкой | Решение проблем |
| Найти точную команду или параметр | Справочник команд |
Слева — все страницы этого раздела. Справа — разделы открытой страницы. Справочник команд пригодится, когда нужна точная опция; для первого знакомства достаточно установки и повседневных задач.