Ejecutar un agente de IA dentro de Telegram, Discord y Slack con CowAgent
Configurar CowAgent, un agente gratuito de código abierto, en Telegram, Discord o Slack: instalación en escritorio, claves de modelo, tokens de bot, memoria, habilidades y el costo de su funcionamiento.
Las aplicaciones de chat son el lugar donde ya vive mucha gente. Telegram, Discord y Slack albergan los mensajes, las conversaciones y cada vez más del trabajo real. Entonces, ¿por qué debería un asistente de IA exigir otra pestaña del navegador, otra aplicación y una nueva conversación cada vez que lo necesites?
Un arreglo más natural coloca al asistente donde ya se realiza el trabajo. Imagina un asistente persistente dentro de tus plataformas de chat existentes que recibe mensajes, mantiene el contexto, recuerda intercambios anteriores, planifica tareas y lleva a cabo las acciones, todo sin una interfaz separada.
CowAgent es un proyecto de código abierto que hace esto. Es gratuito, funciona en tu propio ordenador o en un servidor pequeño, y se conecta a Telegram, Discord o Slack. Una vez configurado, se convierte en un asistente siempre activo al que se puede acceder a través de los mismos canales que utilizas a diario. La configuración es sencilla, pero hay muchos procesos que ocurren en segundo plano. Saber cómo el agente se comunica con esas plataformas, gestiona las conversaciones, mantiene la memoria y convierte los mensajes en acciones facilita enormemente su personalización.
¿Por qué ejecutar un agente uno mismo en lugar de usar un chatbot alojado?
Un chatbot en una pestaña del navegador es adecuado para preguntas ocasionales. Deja de ser suficiente cuando el objetivo pasa de hacer preguntas a llevar a cabo tareas continuas. Una pestaña no recuerda lo que ocurrió la semana pasada a menos que el producto almacene el historial en algún lugar. Tampoco forma parte de un chat grupal esperando a ser mencionada. No se puede programar para publicar un resumen matutino ni se activa con un mensaje de un compañero de trabajo en las primeras horas de la mañana.
Un agente que funciona de forma continua en una máquina que usted controla, conectado directamente a una plataforma de mensajería, se comporta de manera diferente. Permanece conectado como un pequeño servidor o servicio en segundo plano. Conserva la memoria entre sesiones en lugar de comenzar desde cero cada vez. Puede acceder a él desde su teléfono a través de la aplicación de chat que ya tiene abierta, sin necesidad de instalar nada nuevo ni recordar un inicio de sesión adicional. Y como el software es de código abierto, la forma en que almacena las conversaciones y toma decisiones no está oculta dentro de un sistema cerrado.
Qué es CowAgent
El proyecto se describe a sí mismo como un agente gratuito de código abierto que realiza tres cosas que un simple bot de preguntas y respuestas no puede hacer. Planifica tareas y no se limita a responder a un mensaje de forma aislada. Utiliza herramientas que le permiten leer archivos, ejecutar comandos, buscar en la web o llamar a servicios externos, yendo más allá de la simple generación de texto. Además, recuerda las conversaciones anteriores, manteniendo el contexto y sin tratar cada mensaje como algo completamente nuevo.
Debajo de estas capacidades existe una capa flexible para conectarse con modelos de lenguaje. No está atado a un proveedor específico. Puedes dirigirlo hacia Claude, GPT, Gemini, DeepSeek o una docena de otros modelos, proporcionando una clave API del que prefieras. Esto es importante porque la calidad, el precio y la disponibilidad de los modelos cambian constantemente, y una herramienta vinculada a un único proveedor pierde valor con el tiempo. Tratar el modelo como una pieza intercambiable mantiene al agente útil independientemente del proveedor que esté a la vanguardia en un momento dado.
Paso uno: descargar el cliente de escritorio
La forma más rápida de comenzar es utilizar el cliente de escritorio para macOS y Windows. A diferencia de una instalación puramente por línea de comandos, la versión de escritorio incluye el backend dentro de la aplicación, por lo que no hay un proceso de servidor separado que configurar antes de que funcione cualquier cosa. Descargarlo e instalarlo constituye todo el primer paso, al igual que con cualquier aplicación de escritorio.
Download link: https://cowagent.ai/download/
En Windows, eso normalmente significa ejecutar un instalador. En macOS, suele significar arrastrar la aplicación a la carpeta Applications o ejecutar un paquete firmado.
Paso dos: superar el Gatekeeper de macOS
Los usuarios de Mac deberían esperar una advertencia al iniciar la aplicación por primera vez. Gatekeeper, la herramienta de verificación integrada en macOS, busca aplicaciones firmadas y notariadas por un desarrollador de Apple registrado. Los proyectos de código abierto distribuidos fuera de la Mac App Store suelen activar esta advertencia, ya que la firma y notarización requieren una cuenta de desarrollador de Apple y una configuración adicional que muchos proyectos comunitarios no han realizado.
El mensaje no significa que haya algo roto o inseguro en sí mismo. Significa que macOS no puede verificar al desarrollador a través de la cadena de firmas de Apple. Para continuar, haga clic con el botón derecho o con Control sobre el ícono, elija “Abrir” en el menú en lugar de hacer doble clic y confírmelo. Eso permite que esta aplicación pase mientras se dejan intactas las demás configuraciones de seguridad del sistema. Cualquier persona cautelosa puede leer el código fuente del proyecto antes de instalarlo, ya que todo el agente es de acceso público.
Paso tres: conectar un proveedor de modelos de lenguaje
Una vez que la aplicación esté abierta, conéctela a al menos un proveedor de modelos con una clave API. La clave es la que proporciona la inteligencia: la planificación, el razonamiento y la redacción de respuestas provienen del modelo al que se dirige, mientras que CowAgent se encarga de la memoria, el uso de herramientas, la planificación de tareas y los enlaces a las plataformas de chat circundantes.
Los proveedores soportados incluyen Claude, GPT, Gemini y DeepSeek, además de unos diez más. Cada uno requiere su propia clave, que se obtiene desde la consola de desarrolladores o el panel de control de dicho proveedor. El proceso es similar en todos lados, aunque los detalles pueden variar: se crea una cuenta, se busca la sección de API o claves de desarrollador, se genera una clave y se almacena en un lugar seguro, ya que la mayoría de los proveedores solo muestran la clave completa una vez.
Dentro de CowAgent, la clave se introduce en la pantalla de configuración del modelo, generalmente en la sección de ajustes o en la consola. Conceptualmente, un registro se ve como el ejemplo a continuación, aunque la interfaz es gráfica y no existe un archivo en bruto que se pueda editar a mano:
provider: claude
api_key: sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Dado que se pueden utilizar varios proveedores simultáneamente, es posible conectar más de un modelo y elegir cuál se encargará de las respuestas en chat, cuál de la comprensión de imágenes y cuál de otras funciones. Esto resulta útil para comparar directamente el comportamiento de los modelos, o si ya cuenta con créditos en más de un proveedor y no desea que se desperdicien.
Paso cuatro: conectar una plataforma de mensajería
Con un modelo conectado, el asistente ya puede mantener conversaciones, pero el verdadero beneficio se obtiene al acceder a él a través de una aplicación de chat y no de una interfaz dedicada. Telegram, Discord y Slack siguen un mismo patrón en cuanto a la configuración del modelo: se genera un token API en esa plataforma y luego se pega en la configuración del canal correspondiente dentro de CowAgent.
- Telegram: cree un bot a través del asistente oficial BotFather de Telegram, el cual emite un token de bot después de una breve conversación guiada dentro de Telegram.
- Discord: cree una aplicación en el portal de desarrolladores de Discord, agregue un bot a ella, copie el token del bot y luego invite al bot a un servidor utilizando un enlace de invitación con los permisos adecuados.
- Slack: cree una aplicación en el panel de control de la API de Slack, active los alcances del bot y las suscripciones a eventos que necesite, instale la aplicación en un espacio de trabajo y copie el token de bot resultante.
Una vez que se ingresa el token y se activa el canal, el agente se convierte en miembro de esa plataforma. Los mensajes enviados directamente a él, o que lo mencionan en un grupo o servidor, llegan al modelo de lenguaje junto con toda la memoria y el contexto que haya recopilado, y la respuesta regresa por el mismo canal. Para las personas que chatean con él, no hay diferencia visible respecto a hablar con un contacto humano o con un bot ordinario, aparte de la forma en que responde.
Una instancia en ejecución no está limitada a una sola plataforma. Un mismo agente puede servir a Telegram, Discord y Slack simultáneamente, compartiendo una misma memoria y un mismo modelo, por lo que no hay necesidad de duplicar nada para cada plataforma.
Qué ocurre en el fondo
Cuando llega un mensaje por cualquier canal, se ejecuta el mismo proceso interno. La integración del canal que lo recibe captura el texto, la imagen o la nota de voz. Esa información se envía al mecanismo de razonamiento principal del agente, el cual consulta la memoria relevante de conversaciones anteriores, decide si se necesitan herramientas (buscando en la web, leyendo un archivo, ejecutando una tarea programada) y elabora un plan para responder. El modelo conectado escribe la respuesta real basándose en ese plan y en el contexto, y la respuesta se envía de vuelta a través del canal por donde comenzó el mensaje.
Ese ciclo es la razón por la cual el agente parece menos un chatbot sin estado y más bien un asistente continuo. Puedes plantear un tema hoy y volver a referirte a él la próxima semana; funciona como un asistente humano que estuvo presente en la conversación anterior, sin necesidad de repetir cada detalle.
Agregar habilidades desde Skill Hub
Más allá de una conversación básica, el agente se vuelve mucho más útil una vez que se instalan las habilidades. Una habilidad es un flujo de trabajo de nivel superior, a diferencia de una herramienta simple, que agrupa los pasos necesarios para algo específico, como utilizar un servicio externo concreto, automatizar una tarea recurrente o gestionar un tipo especial de solicitud.
Las habilidades se pueden buscar e instalar desde un mercado abierto llamado Skill Hub, sin necesidad de código. En la interfaz o mediante un comando breve, se busca por palabra clave e se instala con una sola acción:
/skill search calendar
/skill install calendar-assistant
El modelo de mercado implica que las capacidades no están fijas en el momento de la instalación. Las habilidades publicadas por la comunidad o creadas a través de conversaciones habituales con el propio agente pueden añadirse en cualquier momento sin necesidad de reinstalar la aplicación. Quien la configuró para chats informales puede agregar una habilidad semanas después para gestionar un calendario, resumir documentos o comunicarse con una API específica, de la misma manera en que se instalaría una aplicación desde una tienda.
Costo y apertura
Tanto la aplicación de escritorio como el marco del agente y el Skill Hub se describen como gratuitos y de código abierto. El único costo continuo es el proveedor del modelo de lenguaje al que te conectas, ya que el acceso a modelos como Claude, GPT, Gemini o DeepSeek por medio de API suele facturarse por el proveedor según el uso y no está incluido en el software del agente.
Esa distinción es útil al presupuestar para una configuración personal o de un equipo pequeño. No hay costo de suscripción ni tarifa de licencia para el framework, y el uso del modelo, que es la única cuenta a pagar, a menudo puede mantenerse bajo o incluso ser gratuito, dependiendo del proveedor y del crédito de prueba o nivel gratuito que ofrezca en ese momento. El código abierto también significa que todo el código fuente, incluyendo cómo se almacena la memoria, cómo se ejecutan las herramientas y cómo se enrutan los mensajes entre canales y modelos, puede ser inspeccionado por cualquier persona que quiera verificar qué hace el software antes de confiarle conversaciones reales, archivos o tareas programadas.
Un primer día realista
En resumen, una primera sesión se lleva a cabo de la siguiente manera: descarga e instala el cliente de escritorio; si es necesario, pasa por el mensaje de Gatekeeper en una Mac. Ingresa una clave API de tu proveedor de modelos preferido en la aplicación, lo que permite mantener una conversación real. Genera un token de bot para Telegram, Discord o Slack y conéctalo, de modo que el asistente sea accesible desde una aplicación de chat para teléfono o escritorio que ya esté abierta. Envía un primer mensaje al bot para confirmar que todo está configurado correctamente. Luego instala una o dos habilidades desde Skill Hub según las tareas principales que realizará el asistente, ya sea programar citas, realizar búsquedas, gestionar archivos o algo más específico.
Ninguno de estos pasos lleva mucho tiempo, ni requiere habilidades de programación, ya que tanto la conexión con el modelo como la conexión con el canal se reducen a pegar una clave o token en una pantalla de configuración, sin necesidad de editar código.
Lo que obtendrá al final
Incluir un asistente de IA en la aplicación de chat que ya utiliza elimina una cantidad sorprendente de obstáculos en comparación con dejarlo en una pestaña o panel separado. Esta configuración no cuesta nada en términos de software, evita la dependencia del modelo subyacente y no requiere un trabajo técnico avanzado, más allá de descargar una aplicación e insertar un par de claves.
Una vez conectado a Telegram, Discord o Slack y dotado de al menos un modelo con el que trabajar, dispondrá de un asistente persistente que recuerda el contexto, planifica tareas de varios pasos y se vuelve cada vez más capaz a medida que se añaden nuevas habilidades, todo ello funcionando silenciosamente en el hardware que ya tiene en su escritorio.
Leer más
- Notas prácticas: Su agente de programación no necesita más contexto. Necesita un mapa. — Guía paso a paso de las Notas prácticas: Su agente de programación no necesita más contexto. Necesita un mapa.: contratos, verificaciones y espacios para código listo para usar para los equipos que implementan este patrón.
- Notas prácticas: Una GUI de base de datos que también regula qué puede hacer su agente de IA — Guía paso a paso de las Notas prácticas: Una GUI de base de datos que también regula qué puede hacer su agente de IA: contratos, verificaciones y espacios para código listo para usar para los equipos que implementan este patrón.