Для общей установки и автоматических обновлений используйте помощника «Начать работу в Diversity». Сначала включите Full access, затем подключайте плагины. Ниже сохранён самостоятельный способ подключения.
Что понадобится
- Компьютер с Windows или macOS.
- ChatGPT App с доступом Codex к локальным файлам и терминалу.
- Новый агентный чат, в который можно вставить установочный промпт.
Три шага установки
- Скопируйте установочный промпт ниже.
- Откройте ChatGPT App и создайте чат Codex.
- Вставьте промпт в агентный чат и отправьте его.
Агент сам скачает корпоративный архив, проверит его содержимое и выполнит установку.
Установочный промпт
Установи локальный 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.Что произойдёт
- Агент сверит manifest и остановится, если найдёт неожиданные файлы.
- Plugin
telegram-agentбудет зарегистрирован и включён через конфигурацию
ChatGPT App.
- Официальный клиент
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-сессия
Не удаляйте её вслепую. Попросите агента сначала объяснить состояние и безопасные варианты.