# Установка плагинов в Telegram-агента: настройка и проверка > Пошаговое руководство по установке плагинов в ИИ-агенте, которым управляют через Telegram: объясняем, что входит в плагин, где он работает, как установить и проверить расширение, а также как оценить его права и источник. Source: https://ailoot.ai/blog/ru/telegram-ai-agent-plugins/ Canonical: https://ailoot.ai/blog/ru/telegram-ai-agent-plugins/ Language: ru Publisher: Ailoot (https://ailoot.ai/) Translation: guide-151 Revision: sha256-1e6172b5ff8c74dc0f7713d108d150d906c7817b4ae5e60048e3314e432280b8 ИИ-агент может работать на сервере, а управлять им можно через Telegram: отправлять команды, поручать работу с файлами и получать результаты. Когда базовых возможностей становится недостаточно, например нужны проверка кода, операции с GitHub или регулярные сводки, пригодятся плагины. По запросу «как установить плагин в тг» обычно ищут способ добавить боту новые функции, а не расширения для стикеров. В этом руководстве разберём, что такое плагин, где его устанавливают, как выполнить установку и как заранее оценить безопасность расширения. Сведения о Claude Code сверены с официальной документацией. [Практические сведения о работе с Ailoot — в документации](https://ailoot.ai/docs/). ## Что такое плагин для ИИ-агента простыми словами?
Коротко Плагин — это готовый комплект дополнительных возможностей для агента. В него могут входить навыки, вспомогательные агенты, автоматические действия и подключения к сторонним сервисам. После установки агент получает новые функции, а после удаления перестаёт ими пользоваться. Это похоже на установку приложения, только расширение предназначено для ИИ-агента.
Без расширений агент обычно умеет выполнять основные действия: читать файлы, создавать код и отвечать на вопросы. Плагин добавляет к этому набору подготовленные возможности. В документации Claude Code сказано, что плагины могут включать навыки, специализированных агентов, автодействия и интеграции с внешними сервисами. Например, расширение для GitHub может добавить команды для подготовки коммита, создания pull request и просмотра истории изменений. Плагин для проверки кода может анализировать его по заданному перечню ошибок и проблем безопасности. Автор заранее собирает компоненты, а пользователь устанавливает готовый набор. Плагин можно отключить или удалить, если он больше не нужен. После этого агент возвращается к доступным ему без расширения функциям. Такой формат удобен для пробного использования: проверьте плагин на подходящей задаче и удалите его, если он не подошёл. ## Чем плагин отличается от навыка, MCP и субагента?
Коротко Навык описывает отдельную функцию, вспомогательный агент выполняет самостоятельную крупную подзадачу, а интеграция открывает доступ к внешней программе. Плагин объединяет такие компоненты и сопровождает их описанием. Поэтому вместо настройки нескольких частей по отдельности можно установить подготовленный комплект.
Термины, связанные с агентами, легко перепутать. В таблице показано, для чего нужен каждый компонент и как его подключают. | Что это | Что делает | Как ставится | |----|----|----| | Навык | Выполняет одну задачу по заданным правилам, например оформляет коммит в принятом стиле | Файл с инструкцией помещают в каталог агента | | Агент-помощник | Выполняет крупную подзадачу в отдельном диалоге | Его описание сохраняют в отдельном файле | | Автодействие | Запускается при событии, например перед сохранением или после ответа | Правило добавляют в настройки | | Подключение к сервису (MCP) | Даёт агенту доступ к внешней программе, например GitHub, базе данных или браузеру | Настраивают адрес и ключ доступа | | Плагин | Объединяет такие компоненты в готовый комплект | Устанавливают одной командой | В Claude Code подключение к внешнему сервису называется MCP. Это стандарт взаимодействия, с помощью которого агент может обращаться, например, к GitHub, базе данных или браузеру. В таблице первые четыре строки описывают отдельные составляющие. Плагин объединяет их в один комплект. Его автор подготавливает компоненты и файл с описанием, после чего пользователь подключает набор целиком. Это избавляет от необходимости отдельно настраивать каждый компонент. Выбирайте способ по задаче. Если нужно одно небольшое умение, его можно описать самостоятельно в виде навыка. Если нужен уже собранный набор возможностей, подойдёт плагин. Перед установкой полезно проверить, какие именно компоненты он добавляет. ## Что значит «установить плагин в тг» и при чём тут Telegram?
Коротко Плагин устанавливается в ИИ-агент, а не в Telegram. Мессенджер служит каналом управления: через него отправляют команды и получают ответы. Сам агент работает на компьютере или сервере. Поэтому установка «плагина в тг» обычно означает добавление расширения к агенту, которым управляют из чата.
Telegram не хранит функции ИИ-бота и не устанавливает для него плагины. Он передаёт сообщения между пользователем и агентом, который работает на отдельном компьютере или сервере. Плагин нужно устанавливать в программную среду самого агента. Есть два способа это сделать: 1. **Отправить команду через чат.** Можно попросить агента установить плагин, например для работы с GitHub. Агент выполнит установку в своей среде и сообщит результат. Этот вариант позволяет управлять удалённым сервером с телефона. 2. **Выполнить команду в терминале.** Подключитесь к компьютеру или серверу, где запущен агент, и установите плагин там. Для первой установки этот способ удобен тем, что вывод команды виден непосредственно. Выбор зависит от того, готовы ли вы поручить агенту самостоятельно устанавливать расширения. При ручной установке можно проверить вывод команд и понять, какие компоненты подключаются. Ниже описаны оба способа. ## Как проходит в Claude Code установка плагинов за пять минут? {#как-поставить-плагин-в-агента-за-пять-минут}
Коротко Для Claude Code общий порядок таков: подключить каталог плагинов, установить нужное расширение и перечитать список плагинов. Первые две операции выполняются отдельными командами; после установки может понадобиться команда перезагрузки. В других агентах последовательность похожая, но команды отличаются.
В примере ниже используется Claude Code: порядок установки описан в официальных материалах Anthropic. Команды можно выполнить в терминале или передать агенту через Telegram, если он принимает такие инструкции. 1. **Откройте панель плагинов.** Команда `/plugin` запускает её в терминале. Там можно посмотреть доступные расширения и каталог на сайте claude.com/plugins. 2. **Подключите официальный каталог.** Выполните команду `/plugin marketplace add anthropics/claude-plugins-official`. Агент будет получать плагины из указанного каталога Anthropic. 3. **Установите нужное расширение.** Укажите имя плагина и каталог через символ `@`: ```bash /plugin install github@claude-plugins-official ``` 4. **Перечитайте список плагинов.** Если после установки появилось сообщение `Run /reload-plugins to activate.`, выполните `/reload-plugins`. До перезагрузки новые команды могут быть недоступны в текущем диалоге. Если агент предупреждает, что перечитывание затронет диалог, повторите команду с флагом `/reload-plugins --force`. После активации агенту становятся доступны команды плагина. В Claude Code к имени команды может добавляться имя расширения, например `/commit-commands:commit`, чтобы было понятно, откуда она появилась. Для установки из командной строки Claude Code также поддерживает команду `claude plugin install`. Согласно документации, установка этой командой не загружает плагин в уже открытый разговор. Он станет доступен при следующем запуске или после команды `/reload-plugins`. В других агентах команды и расположение компонентов могут отличаться. Перед установкой сверяйтесь с официальной документацией используемого продукта. В общем виде порядок остаётся таким: подключить каталог, установить расширение по имени и перезапустить агента или перечитать его плагины. ## Где брать плагины и каким можно доверять?
Коротко Источники плагинов отличаются тем, кто их сопровождает и как проверяет содержимое. Официальный каталог поддерживает Anthropic; каталог сообщества описан в документации Anthropic как прошедший автоматическую проверку и закрепляющий плагины за определёнными версиями. Сторонний каталог требует самостоятельной проверки. Чем меньше известен источник, тем внимательнее нужно изучить содержимое и запрашиваемые права.
Плагин может выполнять код и обращаться к ресурсам, доступным агенту, включая файлы и подключённые сервисы. Поэтому перед установкой важно оценивать не только описание, но и происхождение расширения. | Источник | Кто отвечает | Как подключить | |----|----|----| | Официальный магазин | Каталог поддерживает Anthropic | `/plugin marketplace add anthropics/claude-plugins-official` | | Магазин сообщества | Каталог сторонних плагинов; Anthropic указывает, что они прошли автоматическую проверку и закреплены за версиями | `/plugin marketplace add anthropics/claude-plugins-community` | | Примеры вендора | Подборка примеров Anthropic | `/plugin marketplace add anthropics/claude-code` | | Сторонний каталог | Каталог стороннего автора; степень проверки нужно выяснять самостоятельно | Адрес репозитория, после проверки его содержимого | Для установки плагина из магазина сообщества используется команда с его каталогом, например: `/plugin install имя-плагина@claude-community`. В документации Anthropic сказано, что плагины этого магазина автоматически проверяются на безопасность и привязаны к конкретной версии кода. Это позволяет установить опубликованную проверенную версию, а не более поздние изменения автора. Перед установкой Claude Code показывает раздел `Will install` со списком команд, вспомогательных агентов, навыков, автодействий и подключений, которые добавит расширение. Изучите этот список. Например, доступ к терминалу может быть неожиданным для плагина, предназначенного только для заметок. В документации Anthropic приведено такое предупреждение:

Устанавливайте только те плагины, источникам которых доверяете. Anthropic не контролирует содержимое плагинов — подключений, файлов и кода — и не может гарантировать, что они будут работать как задумано. Ознакомьтесь со страницей каждого плагина.

— Официальная документация Claude Code: https://docs.claude.com/en/docs/claude-code/discover-plugins
Практический вывод: начинайте с официального каталога, а для расширения из стороннего репозитория сначала изучите его состав и выясните, зачем ему нужны запрошенные права. ## Как проверить, что плагин встал и работает в Telegram?
Коротко Убедитесь, что команды расширения появились в списке плагинов, а затем проверьте его безопасной небольшой задачей. Если плагин не виден или команда не работает, агент мог ещё не перечитать список либо установка могла выполниться из другого каталога.
После установки проверьте результат: сообщение об успешной установке само по себе не подтверждает, что агент уже загрузил новые возможности. 1. **Проверьте перечень команд.** Снова откройте `/plugin` или попросите агента показать доступные команды. В Claude Code новые команды плагина могут иметь префикс с его именем. 2. **Поручите небольшую проверочную задачу.** Начните с безопасного примера, не требующего изменений в рабочем проекте. Например, для расширения GitHub попросите показать последние коммиты, а для проверки кода — проанализировать небольшой файл. 3. **Тестируйте через тот же канал, которым пользуетесь.** Если обычно вы управляете агентом в Telegram, отправьте проверочную команду туда. Агент в терминале и агент в чате могут иметь разное состояние, пока плагины не перечитаны. Если плагин установлен, но команды не отвечают, проверьте, не пропущена ли перезагрузка. Открытый разговор может продолжать работать с прежним набором возможностей. Выполните `/reload-plugins`, а при необходимости перезапустите агента. Также убедитесь, что плагин устанавливался из подключённого каталога: одинаковые имена в разных магазинах могут относиться к разным расширениям. Если бот принимает сообщения, но не распознаёт новую команду, сначала проверьте активацию плагина и выбранный каталог. Эти две проверки часто помогают найти причину. ## Как обновлять и удалять плагины, чтобы не захламлять агента?
Коротко Сначала обновляют каталог, затем устанавливают доступную в нём версию плагина. Удалить ненужное расширение можно через панель управления. Оставляйте только те плагины, которые действительно нужны: каждый добавляет агенту дополнительные команды и описания.
По документации Claude Code, обновление каталога выполняется командой `/plugin marketplace update`. После этого установите доступную версию плагина. Если каталог не обновить, агент может продолжать использовать сведения о прежней версии. Плагины можно удалить через панель `/plugin`: найдите расширение среди установленных и выберите удаление. После того как изменения применены и агент перечитал список, команды удалённого плагина перестают быть доступны. Следите за тем, какие расширения остаются подключёнными. Описания команд и функций занимают часть контекста агента, поэтому ненужные плагины могут мешать работе. Если за две недели расширение ни разу не пригодилось, рассмотрите его удаление. Позже его можно установить снова. ## Какие плагины я бы поставил в первую очередь?
Коротко Для начала выберите расширения под конкретные задачи, например работу с GitHub, анализ кода или оформление коммитов. Остальные подключайте по мере необходимости. Установка плагинов «про запас» добавляет функции, которыми можно так и не воспользоваться.
Начните с тех задач, которые регулярно возникают в вашем проекте и подходят возможностям доступных плагинов. Для управления через Telegram это могут быть следующие направления: 1. **Работа с GitHub.** Расширение может добавить действия с коммитами, ветками и pull request. Передайте агенту нужную задачу и проверьте, какие операции он собирается выполнять, прежде чем разрешать изменения в репозитории. 2. **Проверка кода.** Такой плагин помогает анализировать код по заданным критериям, включая ошибки и проблемы безопасности. Начните с небольшого фрагмента, результат которого легко проверить. 3. **Единый стиль коммитов.** Расширение может помочь оформлять коммиты по согласованному шаблону. Это упрощает чтение истории проекта и делает записи более последовательными. Дальше выбирайте расширения под конкретную работу: например, взаимодействие с базой данных или подготовку отчётов по расписанию. Сначала определите задачу, затем подберите для неё плагин. Так агенту не придётся работать с набором ненужных команд. ## Что ещё спрашивают про плагины в Telegram-агенте?
Коротко В этом разделе — ответы о стоимости плагинов, установке на сервере, различии между расширениями для ИИ-агента и функциями Telegram, проверке прав и устранении проблем после установки.
### Частые вопросы Плагины для агента платные? В официальном каталоге Anthropic и магазине сообщества размещаются открытые плагины; за саму установку командами из руководства плата не взимается. При этом модель, используемая агентом, или внешний сервис, к которому обращается плагин, могут быть платными. Проверяйте условия соответствующих поставщиков. Можно ли поставить плагин, если бот работает на сервере? Да. Установите расширение на том сервере, где работает агент, либо отправьте ему команду через Telegram, если агент поддерживает такое действие и вы готовы поручить ему установку. После этого перезапустите агента или выполните команду перечитывания плагинов, чтобы новые возможности загрузились. Чем плагин для ИИ-агента отличается от плагина в Telegram? Это разные вещи, которые иногда называют одним словом. Telegram передаёт сообщения и показывает ответы, а расширение устанавливается в программную среду ИИ-агента. Сам агент работает на компьютере или сервере, а не внутри чата. Как понять, что плагину можно доверять? Оцените, кто опубликовал расширение, какие проверки описаны и какие права оно запрашивает. Перед установкой просмотрите список добавляемых компонентов. Например, расширение для заметок, запрашивающее доступ к терминалу, требует дополнительной проверки. Что делать, если после установки плагин не работает? Проверьте, что агент перечитал список плагинов и что расширение установлено из нужного каталога. Выполните `/reload-plugins`, а если это не помогло — перезапустите агента. Проверьте команду в том же чате, где обычно управляете ботом: состояние в терминале и Telegram может обновляться отдельно.
### Источники - [Claude Code: обзор плагинов](https://docs.claude.com/en/docs/claude-code/plugins) - [Claude Code: поиск и установка плагинов](https://docs.claude.com/en/docs/claude-code/discover-plugins) - [Claude Code: каталоги плагинов](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces) - [Официальный каталог плагинов Claude Code](https://claude.com/plugins) - [Репозиторий магазина плагинов сообщества](https://github.com/anthropics/claude-plugins-community) - [Hermes Agent: официальная документация](https://hermes-agent.nousresearch.com/docs/) - [Hermes Agent: подключение Telegram](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram) - [OpenClaw: официальный сайт](https://openclaw.ai/)
[Открыть Ailoot](https://ailoot.ai/). ## Вопросы и ответы ### Почему установленный плагин всё ещё не работает через Telegram? Работающий агент мог ещё не загрузить его. Перезагрузите плагины или перезапустите бота, проверьте команды и выполните безвредный тест из того же чата Telegram. Вывод установки не доказывает загрузку в активную сессию. ### Где устанавливать плагин, если бот работает на сервере? В агенте на машине, где выполняется бот. Telegram передаёт сообщения и показывает ответы, но не хранит расширения агента. Перед установкой там проверьте источник и добавляемые компоненты. ## Ailoot · Компания и портфель её проектов Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI. Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно. Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.