Un viernes por la tarde, ninguno de mis agentes respondió durante 8 horas.
No hubo error visible. No hubo alarma. El sistema simplemente... calló.
Y yo no me enteré hasta que revisé por otro motivo. Eso me enseñó algo que ningún tutorial de AI me había dicho. Este es el sistema que construí para que no vuelva a pasar.
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.
Cómo funciona cada agente
La arquitectura es simple: un bot de Discord + OpenClaw + un archivo de instrucciones (AGENTS.md).
El flujo: el bot recibe el 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.
1Crear el servidor de Discord
- En la barra izquierda de Discord, clic en el "+" (Añadir un servidor)
- "Créalo tú mismo" → "Para mí y mis amigos"
- 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.
2Crear el bot en Discord Developer Portal
- Ve a discord.com/developers/applications → New Application
- Ponle el nombre de tu agente (ej:
Asistente) → Create - En el menú izquierdo, clic en Bot
- Clic en Reset Token → confirma → copia el token que aparece. Guárdalo ahora — solo se muestra una vez.
- Activa estos toggles en la misma página:
- ✅ Server Members Intent
- ✅ Message Content Intent
- Guarda los cambios (Save Changes)
3Invitar el bot a tu servidor
- En el Developer Portal, ve a OAuth2 → URL Generator
- En Scopes, marca:
botyapplications.commands - En Bot Permissions, marca:
- ✅ Read Messages / View Channels
- ✅ Send Messages
- ✅ Read Message History
- ✅ Add Reactions
- Copia la URL generada al final de la página → pégala en tu navegador
- Selecciona tu servidor
Squad AI→ Autorizar
Verás el bot aparecer como miembro offline en tu servidor. Eso es correcto — todavía no está conectado.
4Instalar OpenClaw y conectar el bot
- Ve a openclaw.ai → descarga e instala en tu Mac o PC
- Abre la terminal y ejecuta:
openclaw setup - Cuando te pida el Discord Token, pega el que copiaste en el Paso 2
- Selecciona tu modelo AI (Claude recomendado para empezar)
- OpenClaw se conecta automáticamente — el bot aparecerá online en Discord
5Escribir el AGENTS.md — la identidad del agente
Este archivo es lo que separa un bot genérico de un colaborador real. Define quién es el agente, qué puede hacer solo, y qué necesita aprobación tuya.
# 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. Sin "¡Claro que sí!".
Guarda este archivo en la carpeta de OpenClaw. El agente lo leerá en cada sesión.
6Verificar que funciona
- Ve al canal
#asistente-principalen tu servidor - Escribe:
Hola, ¿estás ahí? - El bot debería responder en segundos
- Prueba mencionar otro agente:
@desarrollo necesito un reporte del proyecto
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.
Esas 8 horas de silencio me lo enseñaron.
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. Eso 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 un squad corriendo? Cuéntame cómo lo organizas — @utshull en X.
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. Ambos canales activos al mismo tiempo.
- 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 como siempre, y también por Discord. Compara respuestas. Si el agente en Discord funciona igual o mejor, ya estás listo.
- 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 (Claude, Gemini)
- ✓ El AGENTS.md y sus instrucciones
- ✓ 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
Si tienes preguntas sobre el setup o quieres ver cómo lo aplico en mis empresas, encuéntrame en @utshull en X.