Discord para Squads Multiagente

Por qué Discord y no Telegram

Telegram funciona perfecto para un agente solo.

En cuanto tienes tres o más, empieza el caos. Todos responden en el mismo hilo. Los agentes se interrumpen entre sí. No hay forma de separar contextos sin construir infraestructura adicional que luego tienes que mantener.

Discord resuelve esto de forma natural. Cada canal es un contexto aislado. Los agentes solo leen lo que les toca. Y cuando necesitas que uno hable con otro, lo mencionas con @. Sin código extra. Sin integraciones raras.

Es la misma lógica que usas cuando organizas un equipo de personas: espacios de trabajo separados, responsabilidades claras, comunicación directa cuando es necesario.

Estructura del servidor

La que yo uso, después de varios meses ajustándola:

COORDINACIÓN
  #alertas-urgentes
  #updates-squad
  #security

AGENTES
  #asistente-principal
  #desarrollo
  #marketing

PROYECTOS
  #proyecto-alpha
  #proyecto-beta

CONTROL
  #task-board
  #task-completed

Regla de oro: cada canal tiene un dueño. El agente de ese canal lee todo lo que ahí se posta. Los demás lo ignoran, excepto cuando los mencionan directamente.

No hace falta crear todo el primer día. Puedes empezar solo con COORDINACIÓN y AGENTES. El resto aparece cuando el trabajo real lo pide.

Cómo funciona cada agente

La arquitectura es simple: un bot de Discord + OpenClaw + un archivo de instrucciones (AGENTS.md).

El flujo es: bot recibe mensaje → OpenClaw lo procesa con Claude o Gemini → el agente responde en el canal.

El AGENTS.md define la personalidad, el rol, los límites y la cultura del agente.

Un agente sin cultura es solo un bot. Un agente con cultura es un colaborador.

Setup paso a paso

Tiempo estimado: 45 minutos. Sin conocimientos técnicos previos. Solo sigue los pasos en orden.

1. Crear el servidor de Discord

1. En la barra izquierda de Discord, clic en el “+” (Añadir un servidor)
2. “Créalo tú mismo” → “Para mí y mis amigos”
3. Dale un nombre (ej: Squad AI) → Crear

Crea esta estructura (clic derecho en el área de canales → Crear categoría / Crear canal):

COORDINACIÓN
  #alertas-urgentes
  #updates-squad
  #security

AGENTES
  #asistente-principal
  #desarrollo
  #marketing

PROYECTOS
  #proyecto-alpha
  #proyecto-beta

CONTROL
  #task-board
  #task-completed

Empieza solo con COORDINACIÓN y AGENTES. Los demás los sumas cuando los necesites.

2. Crear el bot en Discord Developer Portal

1. Ve a discord.com/developers/applications → New Application
2. Ponle el nombre de tu agente (ej: Asistente) → Create
3. En el menú izquierdo, clic en Bot
4. Clic en Reset Token → confirma → copia el token que aparece. Guárdalo ahora, solo se muestra una vez.
5. Activa estos toggles:
   • Server Members Intent
   • Message Content Intent
6. Guarda los cambios

El token es como la contraseña del bot. Nunca lo compartas ni lo subas a GitHub.

3. Invitar el bot a tu servidor

1. En el Developer Portal, ve a OAuth2 → URL Generator
2. En Scopes, marca:
   • bot
   • applications.commands
3. En Bot Permissions, marca:
   • Read Messages / View Channels
   • Send Messages
   • Read Message History
   • Add Reactions
4. Copia la URL generada al final de la página
5. Pégala en el navegador
6. Selecciona tu servidor → Autorizar

Verás el bot aparecer como miembro offline en tu servidor. Eso es correcto. Todavía no está conectado.

4. Instalar OpenClaw y conectar el bot

1. Ve a openclaw.ai
2. Instala OpenClaw en tu Mac o PC
3. Abre la terminal y ejecuta:

openclaw setup

1. Cuando te pida el Discord Token, pega el que copiaste en el paso 2
2. Selecciona tu modelo AI (Claude recomendado para empezar)
3. OpenClaw se conecta automáticamente

En cuanto conecta, el bot aparece online en Discord.

5. Escribir el AGENTS.md — la identidad del agente

Este archivo es lo que separa un bot genérico de un colaborador real.

Ejemplo base:

# AGENTS.md — Asistente Principal

## Rol
Coordinador del squad. Filtra tareas, delega a otros agentes, informa al CEO.

## Puede decidir solo
Organizar tareas, buscar información, redactar borradores, coordinar con otros agentes.

## Necesita aprobación
Enviar emails, publicar contenido, hacer pagos, tomar decisiones estratégicas.

## Voz
Directo, conciso, profesional. Sin relleno.

Guarda este archivo en la carpeta de OpenClaw. El agente lo leerá en cada sesión.

6. Verificar que funciona

1. Ve al canal #asistente-principal
2. Escribe: Hola, ¿estás ahí?
3. El bot debería responder en segundos
4. Luego prueba mencionar a otro agente: @desarrollo necesito un reporte del proyecto

Si el bot responde y puede coordinarse, el sistema ya está funcionando.

Cómo saber que tus agentes están vivos

Este fue mi mayor dolor de cabeza al principio: ¿cómo sabes que están trabajando cuando no los estás mirando?

Cuando tienes un equipo de personas, hay señales visibles. Están en la oficina, en el chat, en la llamada. Con agentes no las hay por defecto. Y eso crea una ilusión peligrosa: asumes que están haciendo algo, pero no tienes forma de confirmarlo hasta que algo falla.

La solución que implementé: heartbeats automáticos.

Cada agente tiene un archivo HEARTBEAT.md con una lista de chequeos periódicos. OpenClaw los ejecuta y reporta en el canal de coordinación.

Si un agente no reporta en 2 horas, un watchdog lanza una alerta en #alertas-urgentes.

No necesito supervisar el trabajo normal. Solo intervengo cuando algo falla. Esa es la diferencia entre ser el CEO del squad y ser su niñero.

Qué pasa cuando fallan

Todo sistema falla. La pregunta es si tienes un plan para cuando pasa.

El mío: cada agente reporta errores en #alertas-urgentes con el contexto del fallo. Un agente watchdog monitorea al resto y re-lanza tareas críticas si detecta que no se completaron.

No necesito estar pendiente. Si algo importante se rompe, me llega una notificación. Si es menor, el squad se auto-corrige.

Lo que aprendí

Hay una cosa que me llevó más tiempo entender que todo lo demás.

Los agentes no son herramientas. Son colaboradores con un contexto muy limitado.

Cuando los tratas como herramientas, les das tareas sueltas y esperas resultados. A veces funcionan. A menudo no. Y cuando algo falla, no sabes por qué, porque no les diste suficiente contexto para que te explicaran lo que estaban haciendo.

Cuando los tratas como colaboradores, les das rol, cultura y memoria. Les explicas qué pueden decidir solos y qué necesita tu aprobación. Les dices cómo hablar contigo y cómo hablar entre ellos.

Y entonces empiezan a trabajar como un equipo.

Ya tienes agentes en Telegram. Cómo migrar sin romper nada.

Si ya tienes agentes funcionando en Telegram, la buena noticia es que migrar es más fácil de lo que parece. Lo que tienen en la cabeza — instrucciones, contexto, memoria — es portable. Lo que cambia es solo el canal de entrada.

Cómo hacerlo sin interrupciones

1. No apagues nada todavía. Pon el agente a escuchar en Discord en paralelo mientras sigue operando en Telegram.

2. Crea el bot de Discord siguiendo los pasos de arriba. Conecta el mismo workspace de OpenClaw que usa tu agente actual. El AGENTS.md y los archivos de memoria se mantienen intactos.

3. Prueba durante 3 días. Duplica las peticiones importantes: mándalas por Telegram y también por Discord. Compara respuestas.

4. Corta Telegram. Desactiva el token de Telegram en OpenClaw. El agente sigue vivo, solo cambia por dónde le hablas.

Lo que cambia

• El token (de Telegram a Discord)
• Los IDs de canales en OpenClaw
• Cómo te diriges al agente (@ en Discord vs mensaje directo)

Lo que no cambia

• El modelo AI
• El AGENTS.md
• Los archivos de memoria
• El workspace completo

La migración real tarda menos de una hora. El tiempo que hay que invertir es en las pruebas.

Recursos para arrancar

• openclaw.ai — el middleware que conecta todo
• discord.com/developers — para crear tus bots
• discord.com/invite/clawd — comunidad de builders usando este stack