Что понадобится
- Компьютер с Windows или macOS.
- ChatGPT Codex или Claude Code с доступом к локальным файлам и терминалу.
- Новый агентный чат, в который можно вставить установочный промпт.
Три шага установки
- Скопируйте установочный промпт ниже.
- Откройте ChatGPT Codex или Claude Code.
- Вставьте промпт в агентный чат и отправьте его.
Агент сам скачает корпоративный архив, проверит его содержимое и выполнит установку.
Установочный промпт
Установи локальный 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 появятся в новом чате. Полный перезапуск
приложения не нужен.Что произойдёт
- Агент сверит manifest и остановится, если найдёт неожиданные файлы.
- Plugin
telegram-agentбудет зарегистрирован и включён в Codex. - Официальный клиент
gotd/cliустановится в пользовательский каталог без прав администратора.
После установки
Откройте новый чат и отправьте короткий промпт для безопасного входа.
Авторизуй меня в Telegram.
Используй вход по номеру и открой безопасное локальное окно.
Не проси номер, код входа или пароль 2FA в чате.Безопасность
- Номер, код входа, пароль 2FA и QR вводятся или показываются только в локальном окне, а не в чате.
- Существующий plugin нельзя заменить без отдельного подтверждения.
- Если установка уже начиналась, агент сначала проверяет текущее состояние.
- Архив проверяется до распаковки; неожиданные файлы останавливают установку.
Если что-то не работает
Codex не видит Telegram skill
Откройте новый чат и попросите проверить codex plugin list: telegram-agent должен быть установлен и включён.
Команда tg не найдена
Повторно отправьте первый промпт. Агент проверит пользовательский каталог и установит официальный релиз gotd/cli.
Есть старая Telegram-сессия
Не удаляйте её вслепую. Попросите агента сначала объяснить состояние и безопасные варианты.