# Plugins para un bot de Telegram con un agente de IA: instalación y comprobación > Dónde se instala un plugin, en qué se diferencia de una skill y de MCP, cómo recargar el agente y cómo comprobar los comandos desde Telegram. Source: https://ailoot.ai/blog/es/telegram-ai-agent-plugins/ Canonical: https://ailoot.ai/blog/es/telegram-ai-agent-plugins/ Language: es Publisher: Ailoot (https://ailoot.ai/) Translation: guide-151 Revision: sha256-0540734f044c520d36d5d15221c1a238f9b67c994c64ec11cbb32689c689c5fe Mi agente funciona en un servidor y le doy órdenes desde Telegram: escribo en el chat, lee archivos, ejecuta tareas y me envía el resultado. En algún momento, llegas a un límite: el bot básico puede hacer muy poco y quieres que revise código, cree commits en GitHub o prepare un resumen programado. La respuesta son los plugins. La gente busca precisamente «cómo instalar un plugin en Telegram» por esto. No se refiere a una tienda de stickers. Quiere saber cómo darle nuevas capacidades a un bot. A continuación, paso a paso: qué es un plugin, dónde se instala realmente, cómo instalar uno en cinco minutos y cómo evitar introducir código malicioso en tu agente. Esta descripción se basa en la documentación oficial. [En la documentación encontrarás información práctica sobre cómo trabajar con Ailoot](https://ailoot.ai/docs/). ## ¿Qué es un plugin para un agente de IA, en pocas palabras?
Punto clave Un plugin es un conjunto de capacidades listo para usar que se añade a un agente con un solo comando. Contiene skills, agentes auxiliares independientes, acciones automatizadas y conexiones a servicios externos. Instala un plugin y el bot tendrá comandos nuevos que no incluía de serie. Elimínalo y desaparecerán. Es como instalar una aplicación en un teléfono, salvo que la aplicación se instala en tu agente de IA.
Veámoslo con más detalle. De serie, un agente de IA puede hacer lo básico: leer archivos, escribir código y responder preguntas. Un plugin es una carpeta con capacidades adicionales que el agente incorpora y empieza a utilizar. La documentación oficial de Claude Code describe un plugin exactamente así: amplía las capacidades del agente con skills, agentes auxiliares independientes, acciones automatizadas y conexiones a servicios externos. Aquí va un ejemplo sencillo. Instala un plugin para trabajar con GitHub y el agente tendrá comandos para crear un commit, abrir un pull request y revisar el historial de cambios. Instala un plugin de revisión y el agente comprobará si tu código contiene errores y vulnerabilidades de seguridad con una lista de verificación predefinida. No tuviste que configurar nada de esto a mano: el autor del plugin lo preparó todo y tú solo lo conectaste. Una cosa más: un plugin no le enseña nada al agente «para siempre». Es un módulo que se puede quitar. Conéctalo hoy, desconéctalo mañana y el bot volverá a tener las mismas capacidades que antes del plugin. Por eso es fácil probar plugins: elige uno, úsalo en una tarea real y, si no te sirve, elimínalo sin dejar rastro. ## ¿En qué se diferencia un plugin de una skill, MCP y un subagente?
Punto clave Una skill es una capacidad; un agente auxiliar independiente se encarga de una subtarea más amplia, y una conexión a un servicio externo da acceso al bot a otro programa. Un plugin es un paquete que contiene todo eso, junto con un archivo descriptivo. Instala un paquete y obtén de una vez todo un conjunto de capacidades, en lugar de ensamblarlas una por una.
La terminología relacionada con los agentes puede resultar confusa, así que he resumido las diferencias en una tabla. También responde a la mitad de las preguntas de quienes empiezan. | Qué es | Qué hace | Cómo se instala | |----|----|----| | Skill | Una capacidad concreta: «crear un commit con nuestro estilo» | Colocar un archivo de instrucciones en la carpeta del agente | | Agente auxiliar | Se encarga de una subtarea más amplia en una conversación independiente sin consumir tu contexto | Describirlo en un archivo aparte | | Acción automatizada | Se activa automáticamente ante un evento: antes de guardar, después de una respuesta | Añadir una regla en la configuración | | Conexión a un servicio (MCP) | Da acceso al bot a un programa externo: GitHub, una base de datos, un navegador | Configurar la dirección y la clave de acceso | | Plugin | Un paquete que contiene todo lo anterior, ensamblado y empaquetado | Un comando de instalación | En el entorno de Claude Code, una conexión a un servicio externo se llama MCP. Es un estándar que permite al agente acceder a GitHub, una base de datos o un navegador. Las cuatro primeras filas de la tabla son componentes independientes. Fíjate en la última fila. Un plugin está un nivel por encima de los otros cuatro. Reúne una skill, un agente auxiliar, una acción automatizada y MCP en un solo paquete. El autor lo reunió todo, añadió un archivo descriptivo y lo publicó. Con un solo comando obtienes un conjunto completo y listo para usar, en vez de ensamblar las cuatro piezas por separado. Esto te da una regla sencilla para elegir. Si necesitas una capacidad pequeña para tu tarea, escribe tú mismo la skill; te llevará quince minutos. Si necesitas un conjunto listo para usar, creado por personas que ya han resuelto tu problema, consigue un plugin. Tengo una guía aparte sobre [cómo elegir skills para Claude Code](https://ailoot.ai/blog/es/choose-claude-code-skills/), incluida la forma de evitar sobrecargar el agente con skills adicionales. ## ¿Dónde se instala un plugin para un agente de IA conectado a Telegram?
Punto clave El plugin se instala en el agente que te responde a través de Telegram, no en Telegram. La aplicación de mensajería es un control remoto: la usas para darle órdenes al bot, mientras el agente funciona en un ordenador o servidor. Así que «instalar un plugin en Telegram» en realidad significa «instalar un plugin en el agente y seguir controlándolo desde el chat».
Aquí surge una confusión habitual. Telegram no tiene plugins: la aplicación de mensajería no almacena las capacidades del bot. Transmite tus mensajes al agente y muestra sus respuestas. El cerebro está en otro lugar: en tu portátil o en un servidor donde funciona un agente como [Hermes Agent](https://ailoot.ai/blog/es/hermes-agent-install-setup/), [OpenClaw](https://ailoot.ai/blog/es/openclaw-install-telegram/) o Claude Code conectado al chat. Hay dos formas de instalar un plugin, y ambas funcionan: 1. **Directamente desde el chat.** Escríbele al agente en Telegram una petición en lenguaje normal: «instala un plugin de GitHub para ti». El agente lo instala en su propio equipo y te responde que está listo. Es práctico cuando el servidor está lejos y tú estás con el móvil. 2. **En el terminal.** Inicia sesión en el equipo donde funciona el agente e instala allí el plugin con un comando. La primera vez es más fiable: puedes ver toda la salida y no se te escapará nada. El método que elijas depende de si confías en que el bot instale extensiones por su cuenta y sin supervisión. Instalé mis primeros plugins a mano en el terminal para ver exactamente qué estaba conectando. Cuando aprendí a manejarlos, empecé a confiar en que el agente los instalara desde el chat. A continuación te mostraré las dos formas. ## ¿Cómo se instala un plugin en un agente en cinco minutos?
Punto clave Primero conecta un mercado de plugins, luego instala el que quieras por su nombre y, después, recarga el agente para que lo incorpore. En Claude Code se hace con tres comandos: añadir un mercado, instalar un plugin y recargar los plugins. Hermes Agent y OpenClaw siguen la misma lógica, aunque usan nombres de comandos distintos.
Te lo mostraré con Claude Code, porque el proceso está descrito palabra por palabra en su documentación y es fácil de repetir. Los comandos son los mismos tanto en el terminal como al enviárselos al agente desde Telegram. 1. **Abre la lista de plugins.** El comando `/plugin` abre un panel directamente en el terminal, con una pestaña que muestra todas las extensiones disponibles y un directorio en claude.com/plugins. Puedes explorarlas antes de instalar ninguna. 2. **Conecta el mercado oficial.** Introduce `/plugin marketplace add anthropics/claude-plugins-official`. Un mercado es un directorio desde el que el agente descarga plugins. Anthropic administra el oficial. 3. **Instala el plugin que necesitas.** Usa el nombre del plugin seguido del nombre del mercado, separados por el signo de arroba: ```bash /plugin install github@claude-plugins-official ``` 4. **Recarga los plugins.** Si, después de la instalación, el bot dice «Run /reload-plugins to activate.», ejecuta `/reload-plugins`. Hasta que los recargues, los comandos nuevos no aparecerán en la conversación actual. Si recibes una advertencia de que al recargar se volverá a leer la conversación, repite el comando así: `/reload-plugins --force`. Eso es todo. Ahora el agente tiene los comandos del plugin. En Claude Code, estos usan el nombre del plugin como prefijo, por ejemplo `/commit-commands:commit`, para que puedas ver enseguida que el comando procede de un plugin. Si le envías un comando al bot en Telegram en lugar de usar el terminal, Claude Code también ofrece un comando de instalación independiente que no requiere el panel interactivo: `claude plugin install`. La documentación señala un detalle: este comando no carga el plugin en una conversación que ya esté abierta. El agente lo incorporará en el siguiente inicio o después de `/reload-plugins`. En otras palabras, tras instalarlo tienes que reiniciar el bot para que aparezcan los comandos nuevos. En Hermes Agent, las extensiones se habilitan y deshabilitan con el comando `hermes tools`, mientras que las skills tienen su propia carpeta. OpenClaw funciona de forma parecida: conecta un conjunto y reinicia el bot. Los nombres son distintos, pero el orden es el mismo: conectar una fuente, instalar por nombre y reiniciar el agente. Los plugins son uno de los componentes de la ingeniería de contexto: decides qué capacidades tiene a mano el agente antes de la primera petición. Para trabajar de forma sistemática, resulta útil esta combinación: **clon de IA** (tu experiencia expresada en skills y plugins) + **Second Brain** (la estructura del conocimiento del proyecto) + **ingeniería de contexto** (qué darle al agente y cuándo). Estos son los tres pilares sin los cuales la IA empieza a adivinar. ## ¿Dónde puedes conseguir plugins y cuáles son de confianza?
Punto clave Hay tres fuentes con distintos niveles de fiabilidad: el mercado oficial de Anthropic, un mercado comunitario verificado y cualquier directorio de terceros en GitHub. El propio proveedor administra el primero; los plugins del segundo han pasado una comprobación automatizada y están fijados a una versión específica; el tercero queda bajo tu responsabilidad. Cuanto más te alejes de la fuente oficial, más a fondo debes comprobar qué contiene.
Un plugin es código de otra persona y tiene los mismos permisos que tu agente: acceso a archivos, al terminal y a servicios. Por eso importa más la fuente que una descripción atractiva. Estas son las fuentes, ordenadas de la más fiable a la más dudosa. | Fuente | Quién se hace responsable | Cómo conectarla | |----|----|----| | Mercado oficial | Anthropic mantiene el directorio | `/plugin marketplace add anthropics/claude-plugins-official` | | Mercado comunitario | Los plugins de terceros han pasado una comprobación automatizada y cada uno está fijado a una versión | `/plugin marketplace add anthropics/claude-plugins-community` | | Ejemplos del proveedor | Anthropic, plugins de ejemplo | `/plugin marketplace add anthropics/claude-code` | | Directorio de terceros | El autor en GitHub; nadie lo ha revisado | Usa la dirección del repositorio bajo tu responsabilidad | Para instalar desde el mercado comunitario, usa un comando parecido, pero con otro mercado: `/plugin install plugin-name@claude-community`. La documentación señala expresamente que esos plugins han pasado una comprobación de seguridad automatizada y que cada uno está fijado a una versión específica del código. Así obtendrás exactamente lo que se comprobó, sin cambios posteriores del autor que se hayan añadido sin que lo sepas. Antes de la instalación, Claude Code muestra una sección «Will install»: una lista de los comandos, agentes auxiliares, skills, acciones automatizadas y conexiones que añadirá el plugin. Léela. Así podrás detectar una extensión para tomar notas que, por algún motivo, solicite acceso al terminal. La documentación oficial enuncia claramente la regla:

Asegúrate de confiar en un plugin antes de instalarlo. Anthropic no controla las conexiones, los archivos ni el resto del código que incluye un plugin y no puede garantizar que funcione según lo previsto. Revisa la página de cada plugin.

— Documentación de Claude Code, https://docs.claude.com/en/docs/claude-code/discover-plugins
En pocas palabras: los mercados oficiales y verificados ofrecen tranquilidad; utiliza un repositorio cualquiera de GitHub solo después de leer lo que contiene y entender por qué necesita los permisos que solicita. La confianza en el código de terceros va más allá de la instalación de plugins, y trato el tema en mi artículo sobre [seguridad en el vibe coding](https://ailoot.ai/blog/es/vibe-coding-security/). ## ¿Cómo compruebas que el plugin está instalado y funciona en Telegram?
Punto clave Pídele al agente una lista de sus comandos o abre el panel de plugins. Si los comandos del plugin aparecen en la lista, está conectado. Después, asígnale una pequeña tarea de prueba directamente en el chat y comprueba si el bot la lleva a cabo usando su nueva capacidad. Si no aparece nada, quizá olvidaste recargar los plugins o conectaste el mercado equivocado.
Dedica un minuto a comprobarlo: ver «instalado» no significa que el bot haya incorporado realmente el plugin. Sigue estos pasos: 1. **Comprueba la lista.** Vuelve a abrir el panel `/plugin` o pídele al agente que muestre los comandos disponibles. Los comandos del plugin nuevo deberían aparecer en la lista, con el nombre del plugin como prefijo en Claude Code. 2. **Dale una tarea de prueba.** Elige algo seguro, no una tarea real. Si has instalado un plugin de GitHub, pídele que muestre los últimos commits. Si has instalado un plugin de revisión, dale un archivo pequeño. Comprueba una cosa: ¿se encarga el bot de la tarea usando esa nueva capacidad? 3. **Compruébalo desde el mismo chat que usas para trabajar.** Si controlas al agente desde Telegram, envía allí el comando de prueba. A veces el plugin está visible en el terminal, pero el bot del chat aún no lo ha recargado. El motivo más habitual por el que un plugin está instalado pero sus comandos no funcionan es que no lo recargaste. El comando de instalación se ejecutó correctamente, pero el agente de la conversación abierta sigue usando su antiguo conjunto de capacidades. `/reload-plugins` puede solucionarlo; si no funciona, reinicia completamente el bot. El segundo motivo es haber instalado desde otro mercado: el nombre del plugin coincide, pero el directorio no es el correcto y el agente indica acertadamente que el plugin no está en los mercados conectados. Si el bot responde en el chat, pero no entiende el comando nuevo, eso no significa que el agente esté averiado ni que hayas hecho algo mal. Casi siempre se trata de una de estas dos cosas: no ha recargado los plugins o conectaste el mercado equivocado. Ambas se solucionan en un minuto. ## ¿Cómo actualizas y eliminas plugins sin saturar el agente?
Punto clave Actualiza el mercado con un comando; solo entonces estarán disponibles las versiones nuevas de los plugins. Eliminar un plugin es igual de fácil que instalarlo: usa el mismo panel. Mantén conectados solo los plugins que realmente utilizas: cada plugin adicional añade comandos al bot y ocupa espacio en su contexto.
Hay un detalle poco evidente sobre las actualizaciones. Cuando el autor publica una versión nueva de un plugin, no llega automáticamente. Primero actualiza el directorio del mercado con `/plugin marketplace update` y solo después instala la versión nueva. Hasta que actualices el mercado, el agente considerará actual la versión que descargó la última vez. Es intencional: así no se te cuelan cambios de otras personas sin que te enteres. Elimina un plugin desde el mismo panel `/plugin` que usaste para instalarlo: busca el plugin en la lista de instalados y elimínalo. No dejará rastro en el agente y los comandos desaparecerán en cuanto recargues. Precisamente por eso no da miedo experimentar con los plugins: instala varios, conserva los dos que funcionen y elimina el resto. Y mantén el orden. Cada plugin conectado añade comandos que el agente debe tener presentes y ocupa parte de su ventana de contexto con sus descripciones. Cinco plugins que no utilizas ralentizan el bot y lo confunden sin motivo. La regla es sencilla: si un plugin no te ha servido en dos semanas, elimínalo. Puedes restaurarlo con un solo comando. ## ¿Qué plugins instalaría primero?
Punto clave Empieza por tres áreas: trabajo con GitHub, revisión de código y commits con un estilo uniforme. Casi todo el que desarrolla un proyecto y controla un agente desde el chat necesita estas capacidades. Añade otras para tareas concretas. No hace falta instalar plugins por adelantado: los que no uses solo ralentizarán el bot.
No voy a darte una lista de los 100 mejores: esto merece una guía aparte, y ya tengo un artículo sobre los 10 mejores plugins de Claude Code. Aquí tienes tres áreas que recomiendo a quienes empiezan y controlan un agente desde Telegram. 1. **Trabajo con GitHub.** Un plugin que proporciona al agente comandos para commits, ramas y pull requests. Escríbele al bot en el chat: «guarda el trabajo y súbelo al repositorio», y lo hará. Esto elimina la principal preocupación de quienes hacen vibe coding sin experiencia: el miedo a perder el código. 2. **Revisión de código.** Un plugin con una lista de comprobación para detectar errores, vulnerabilidades y puntos débiles. Es especialmente útil con Telegram: envía un fragmento de código en el chat y obtén una revisión sin abrir un editor. 3. **Commits con un estilo uniforme.** Un plugin pequeño que hace que el agente dé formato a los commits según una misma plantilla. Puede parecer un detalle menor, pero al cabo de un mes el historial del proyecto tendrá un aspecto ordenado, como el de un equipo, en vez de convertirse en un caos. A partir de ahí, elige plugins para tareas concretas. ¿Trabajas con una base de datos? Consigue un plugin de bases de datos. ¿Preparas resúmenes? Consigue un plugin de programación. La regla general es la misma: empieza por una tarea y luego busca un plugin que la resuelva. Instalar plugins por adelantado «por si acaso» es una forma segura de ahogar al bot en comandos que nunca usarás. ## ¿Qué más pregunta la gente sobre los plugins en un agente de Telegram?
Punto clave Respuestas rápidas a preguntas habituales: la mayoría de los plugins son gratuitos, funcionan con bots en la nube y locales, y un «plugin de Telegram» de una tienda de stickers no es lo mismo que una extensión para un agente de IA. Puedes ver los permisos peligrosos antes de la instalación y deshacerla en un minuto.
### Preguntas frecuentes ¿Los plugins para agentes son de pago? Los plugins de los mercados oficial y comunitario son gratuitos: son de código abierto y conectarlos no tiene ningún coste. El modelo conectado al agente puede ser de pago, igual que un servicio externo si el plugin utiliza alguno. Pero no pagas por instalar un plugin. ¿Puedo instalar un plugin si el bot funciona en un servidor? Sí, y es lo más habitual. Instala el plugin con el mismo comando, ya sea iniciando sesión en el terminal del servidor o dándole la orden directamente al agente en Telegram, si confías en que lo instale sin supervisión. Después de instalarlo, debes reiniciar el bot o indicarle que recargue los plugins; de lo contrario, no incorporará las nuevas capacidades. ¿En qué se diferencia un plugin para un agente de IA de un plugin de Telegram? Son cosas distintas que la gente confunde porque ambas comparten la palabra «plugin». Telegram no tiene extensiones para bots: la aplicación de mensajería solo transmite mensajes. El plugin se instala en el agente de IA que te responde a través de Telegram, y el agente funciona en un ordenador o servidor. No está dentro de la aplicación de mensajería. ¿Cómo puedo saber si un plugin es de confianza? Comprueba la fuente y la lista de permisos. El proveedor administra el mercado oficial, mientras que los plugins comunitarios han pasado una comprobación automatizada y están fijados a una versión. Antes de instalarlo, el agente te muestra exactamente qué añadirá el plugin: si una extensión para tomar notas pide acceso al terminal, es motivo para tener cuidado y no instalarla. ¿Qué hago si el plugin no funciona después de instalarlo? Casi siempre se debe a una de estas dos cosas: no recargaste los plugins después de instalarlos o conectaste el mercado equivocado. Dile al agente que los recargue y, si eso no ayuda, reinicia completamente el bot. Compruébalo desde el mismo chat donde trabajas: puede que el plugin esté visible en el terminal, mientras que el bot de Telegram aún no lo ha incorporado.
### Fuentes - [Claude Code: cómo funcionan los plugins](https://docs.claude.com/en/docs/claude-code/plugins) - [Claude Code: encontrar e instalar plugins](https://docs.claude.com/en/docs/claude-code/discover-plugins) - [Claude Code: mercados de plugins](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces) - [Directorio oficial de plugins de Claude Code](https://claude.com/plugins) - [Mercado comunitario de plugins en GitHub](https://github.com/anthropics/claude-plugins-community) - [Hermes Agent: documentación](https://hermes-agent.nousresearch.com/docs/) - [Hermes Agent: conectar Telegram](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram) - [OpenClaw: sitio web oficial](https://openclaw.ai/) - Guía: los 10 mejores plugins de Claude Code - [Guía: cómo elegir skills para Claude Code](https://ailoot.ai/blog/es/choose-claude-code-skills/) - [Guía: seguridad en el vibe coding](https://ailoot.ai/blog/es/vibe-coding-security/)
Para trabajar de forma sistemática, resulta útil esta combinación: **clon de IA + Second Brain + ingeniería de contexto**. [Abrir Ailoot](https://ailoot.ai/). ## Preguntas sobre la automatización de empresas con IA ### ¿Por qué un plugin instalado sigue sin funcionar por Telegram? El agente en ejecución quizá no lo haya cargado aún. Recarga los plugins o reinicia el bot, comprueba los comandos y realiza una prueba inocua desde el mismo chat de Telegram. El mensaje de instalación no demuestra que la sesión activa lo haya incorporado. ### ¿Dónde instalo el plugin si el bot se ejecuta en un servidor? En el agente de la máquina donde se ejecuta el bot. Telegram transmite mensajes y muestra respuestas; no almacena las extensiones del agente. Verifica el origen y lo que añadirá el plugin antes de instalarlo allí. ## Ailoot · La empresa y su cartera de proyectos Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI. La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes. Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.