Вернуться в каталог
Скилл

Настроить Telegram для AI-агентов

Установить локальный Telegram plugin через ChatGPT Codex или Claude Code и безопасно пройти авторизацию.

Для общей установки и автоматических обновлений используйте помощника «Начать работу в Diversity». Сначала включите Full access, затем подключайте плагины. Ниже сохранён самостоятельный способ подключения.

Что понадобится

  • Компьютер с Windows или macOS.
  • ChatGPT App с доступом Codex к локальным файлам и терминалу.
  • Новый агентный чат, в который можно вставить установочный промпт.

Три шага установки

  1. Скопируйте установочный промпт ниже.
  2. Откройте ChatGPT App и создайте чат Codex.
  3. Вставьте промпт в агентный чат и отправьте его.

Агент сам скачает корпоративный архив, проверит его содержимое и выполнит установку.

Установочный промпт

Установи локальный Codex plugin «telegram-agent» из архива:
https://go.dvs.group/downloads/telegram-agent-plugin.zip

Работай аккуратно и выполни всё по порядку:

1. Скачай ZIP во временный каталог и сначала проверь его содержимое.
2. В архиве должен быть manifest .codex-plugin/plugin.json с именем "telegram-agent".
   Допустимы только .codex-plugin/, skills/, scripts/, README.md и LICENSE.
   Если внутри есть неожиданные исполняемые файлы, Telegram-сессии, конфиги с
   учётными данными или manifest другого плагина — остановись и сообщи мне.
3. Определи CODEX_HOME. На Windows, если он не задан, используй
   %USERPROFILE%\.codex; на macOS — ~/.codex.
   Каталог установки: <CODEX_HOME>/plugins/telegram-agent.
4. Если каталог уже существует, ничего не перезаписывай без моего отдельного
   подтверждения. Иначе распакуй plugin туда, сохранив структуру архива.
5. Зарегистрируй локальный marketplace в пользовательском файле
   .agents/plugins/marketplace.json: на Windows относительно %USERPROFILE%,
   на macOS относительно ~/. Сохрани все существующие marketplace и плагины.
   Если подходящего локального
   marketplace нет, создай верхнеуровневый marketplace "personal" с плагином
   telegram-agent и source "./.codex/plugins/telegram-agent" относительно домашнего
   каталога. Если используешь уже существующий marketplace с другим именем,
   запомни его точное имя.
6. Зарегистрируй plugin напрямую в <CODEX_HOME>/config.toml, сохранив все
   существующие настройки:
   - если файла нет, создай его;
   - используй точное имя marketplace из шага 5;
   - для marketplace "personal" добавь секцию:

     [plugins."telegram-agent@personal"]
     enabled = true

   - если такая секция уже есть, установи enabled = true без дублирования;
   - запиши изменение через временный файл в том же каталоге и атомарно замени
     config.toml только после проверки результата;
   - не изменяй и не удаляй настройки других plugins.
7. Проверь установку:
   - существует <CODEX_HOME>/plugins/telegram-agent/.codex-plugin/plugin.json;
   - manifest по-прежнему содержит name "telegram-agent";
   - ~/.agents/plugins/marketplace.json содержит telegram-agent с правильным source;
   - <CODEX_HOME>/config.toml содержит ровно одну секцию plugin с точным именем
     marketplace и enabled = true.
8. Не останавливайся после регистрации plugin. Найди его корневой каталог и в
   этой же задаче проверь состояние приложения для Telegram:
   Windows:
   powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<plugin-root>\scripts\telegram-tool.ps1" -Action status -Json
   macOS:
   /bin/sh "<plugin-root>/scripts/telegram-tool.sh" status --json
9. Если результат status — missing или version-unknown, установи текущий
   официальный релиз gotd/cli:
   Windows:
   powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<plugin-root>\scripts\telegram-tool.ps1" -Action install -Json
   macOS:
   /bin/sh "<plugin-root>/scripts/telegram-tool.sh" install --json
   Этот запрос является моим явным разрешением скачать и установить CLI в
   пользовательский каталог. Не используй Winget, Homebrew и права администратора.
10. Убедись, что lifecycle-скрипт вернул status ready. Заверши установку в этой
    задаче; авторизацию выполни в следующем чате ChatGPT.
11. После успеха напиши человеческим языком:
    «Plugin и приложение для работы с Telegram установлены. Откройте новый чат
    в ChatGPT и отправьте: “Авторизуй меня в Telegram”.»

Важно: skills установленного plugin появятся в новом чате ChatGPT.

Что произойдёт

  1. Агент сверит manifest и остановится, если найдёт неожиданные файлы.
  2. Plugin telegram-agent будет зарегистрирован и включён через конфигурацию

ChatGPT App.

  1. Официальный клиент gotd/cli установится в пользовательский каталог без прав администратора.

После установки

Откройте новый чат в ChatGPT и отправьте короткий промпт для безопасного входа.

Авторизуй меня в Telegram.
Используй вход по номеру и открой безопасное локальное окно.
Не проси номер, код входа или пароль 2FA в чате.

Безопасность

  • Номер, код входа, пароль 2FA и QR вводятся или показываются только в локальном окне, а не в чате.
  • Существующий plugin нельзя заменить без отдельного подтверждения.
  • Если установка уже начиналась, агент сначала проверяет текущее состояние.
  • Архив проверяется до распаковки; неожиданные файлы останавливают установку.

Если что-то не работает

Codex не видит Telegram skill

Откройте новый чат в ChatGPT и попросите проверить файлы plugin, запись telegram-agent в ~/.agents/plugins/marketplace.json и секцию [plugins."telegram-agent@personal"] с enabled = true в <CODEX_HOME>/config.toml.

Команда tg не найдена

Повторно отправьте первый промпт. Агент проверит пользовательский каталог и установит официальный релиз gotd/cli.

Есть старая Telegram-сессия

Не удаляйте её вслепую. Попросите агента сначала объяснить состояние и безопасные варианты.