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

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

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

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

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

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

  1. Скопируйте установочный промпт ниже.
  2. Откройте ChatGPT Codex или Claude Code.
  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. Если он не задан, используй ~/.codex.
   Каталог установки: <CODEX_HOME>/plugins/telegram-agent.
4. Если каталог уже существует, ничего не перезаписывай без моего отдельного
   подтверждения. Иначе распакуй plugin туда, сохранив структуру архива.
5. Зарегистрируй локальный marketplace в ~/.agents/plugins/marketplace.json.
   Сохрани все существующие marketplace и плагины. Если подходящего локального
   marketplace нет, создай верхнеуровневый marketplace "personal" с плагином
   telegram-agent и source "./.codex/plugins/telegram-agent" относительно домашнего
   каталога. Если используешь уже существующий marketplace с другим именем,
   запомни его точное имя.
6. Выполни:
   codex plugin add telegram-agent@<точное-имя-marketplace> --json
7. Проверь через codex plugin list, что telegram-agent установлен и enabled.
8. Не останавливайся после установки plugin. Найди корневой каталог установленного
   telegram-agent и в этой же задаче проверь состояние приложения для 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. Не начинай авторизацию в
    этой задаче и не проси перезапускать Codex.
11. После успеха напиши человеческим языком:
    «Plugin и приложение для работы с Telegram установлены. Перезапускать Codex
    не нужно. Откройте новый чат и отправьте: “Авторизуй меня в Telegram”.»

Важно: skills установленного plugin появятся в новом чате. Полный перезапуск
приложения не нужен.

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

  1. Агент сверит manifest и остановится, если найдёт неожиданные файлы.
  2. Plugin telegram-agent будет зарегистрирован и включён в Codex.
  3. Официальный клиент gotd/cli установится в пользовательский каталог без прав администратора.

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

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

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

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

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

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

Codex не видит Telegram skill

Откройте новый чат и попросите проверить codex plugin list: telegram-agent должен быть установлен и включён.

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

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

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

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