Sección 5: Lanzar tus Agentes

Qué pasa en esta sección

Vas a registrar cada agente con OpenClaw y darles su primer comando. Al finalizar, los 6 agentes estarán activos — reportando en sus canales de Discord y listos para recibir instrucciones tuyas.

Dos formas de hablar con tus agentes:

Método	Ideal para	Cómo funciona
OpenGoat UI	Principiantes — interfaz visual	Panel en el navegador, hacé clic para seleccionar el agente, escribí tu mensaje
Terminal de VS Code	Recomendado — más rápido, más control	`openclaw agent --agent [id] "tu mensaje"`

Ambos métodos funcionan. Empezá con el que te resulte más cómodo.

Enfoque recomendado — híbrido con IA: Cuando estés empezando, mantené tu IA de chat abierta junto a tus agentes. Si un comando no funciona o no sabés qué escribir, describile la situación a la IA y pedile ayuda. Así es exactamente como la mayoría de las personas — incluido el equipo de BALIA OS — manejó las cosas al principio. No necesitás dominar la terminal desde el primer día. La ventana de chat con IA siempre está ahí como tu copiloto.

Cómo funciona esta sección

Pegá el prompt de abajo en tu IA de chat. La IA te guiará para registrar los 6 agentes y enviar tu primer comando a cada uno. Adjuntá tu Documento de Diseño de Equipo para que la IA conozca los IDs de tus agentes y las rutas de trabajo.

Si algo sale mal, describí el error o sacá una captura de pantalla y compartila — la IA te ayudará a solucionarlo.

▶ Pegá esto en tu IA para comenzar

Adjuntá tu Documento de Diseño de Equipo antes de enviar.

Estás ayudándome a registrar y lanzar mi equipo de múltiples agentes de BALIA OS
en OpenClaw.

Adjunté mi Documento de Diseño de Equipo. Leélo para obtener los IDs
y nombres de mis agentes antes de empezar.

Antes de comenzar, preguntame:
"¿Cuál es tu nombre de usuario de Windows? (El nombre en C:\Users\[usuario])"
Usá ese nombre de usuario en todas las rutas de archivo durante esta sesión.
Todos los archivos de mis agentes están en $env:USERPROFILE/.opengoat/

Guiame paso a paso. Un paso a la vez. Si encuentro un error,
ayudame a solucionarlo antes de continuar. Si me quedo atascado/a, pedime que comparta
una captura de pantalla o que pegue el mensaje de error.

Esto es lo que necesitamos hacer:

PASO 1 — Iniciar el gateway
Decime: "Vamos a iniciar el gateway de OpenClaw con un comando que filtra
los registros de fondo ruidosos para que la terminal siga siendo legible."

Guiame para abrir una nueva pestaña de terminal en VS Code y ejecutar el comando correcto
según mi sistema operativo (preguntame cuál uso si todavía no lo sabés):

Windows:
  $env:DEBUG="-ciao*"; openclaw gateway --force

Mac:
  DEBUG="-ciao*" openclaw gateway --force

Explicame qué hace esto:
"La parte DEBUG='-ciao*' oculta los registros de descubrimiento de red en segundo plano que
de otra manera inundarían la terminal. El flag --force elimina cualquier
instancia anterior del gateway. Tu terminal quedará limpia y legible."

Pedime que confirme que veo: "✓ Gateway running on port 18789"
Decime que deje esta pestaña de terminal abierta — el gateway debe seguir ejecutándose.
Si hay un error, ayudame a solucionarlo antes de continuar.

PASO 2 — Registrar cada agente con OpenClaw
Para cada uno de mis 6 agentes (leé los IDs del Documento de Diseño de Equipo),
guiame para ejecutar este comando en la terminal de VS Code:

Windows:
openclaw agents add [agentid] --workspace $env:USERPROFILE\.opengoat\workspaces\[agentid]

Mac:
openclaw agents add [agentid] --workspace ~/.opengoat/workspaces/[agentid]

Ejemplo (Windows): openclaw agents add marcus --workspace C:\Users\john\.opengoat\workspaces\marcus
(marcus es un ejemplo — reemplazalo con los IDs de tus propios agentes de tu Documento de Diseño de Equipo.)

Mostrame los 6 comandos a la vez con mis IDs de agente reales y nombre de usuario completados.
Pedime que los ejecute uno por uno y que confirme que cada uno fue exitoso antes de
mostrarme el siguiente.

Después de registrar los 6, guiame para verificar:
openclaw agents list
Pedime que confirme que los 6 agentes aparecen en la lista.

PASO 2b — Verificar el registro del Security Guardian
El Security Guardian ya fue registrado con OpenClaw en la Sección 4.
Guiame para verificar que está presente:

openclaw agents list

Pedime que confirme que security-guardian aparece en la lista.
Si falta, guiame para ejecutar:

Windows:
openclaw agents add security-guardian --workspace $env:USERPROFILE\.opengoat\workspaces\security-guardian

Mac:
openclaw agents add security-guardian --workspace ~/.opengoat/workspaces/security-guardian

Luego verificá la lista nuevamente antes de continuar.

PASO 3 — Reiniciar el gateway
Después de registrar los agentes, el gateway necesita reiniciarse para cargarlos.
Guiame para ejecutar:
openclaw gateway restart
Pedime que confirme que el gateway está funcionando nuevamente antes de continuar.

PASO 4 — Iniciar el Security Guardian (PM2)
El Security Guardian se ejecuta continuamente en segundo plano usando PM2.
Guiame para iniciarlo:

pm2 start $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\guardian.js --name security-guardian

(Mac: reemplazá la ruta con ~/.opengoat/workspaces/security-guardian/scripts/guardian.js)

Luego guardá la lista de procesos de PM2 para que se reinicie automáticamente al rebootear:
pm2 save

Pedime que confirme que veo el Security Guardian en la lista de PM2:
pm2 list

Luego pedime que confirme que veo un mensaje de inicio en el canal de Discord #security-channel.

PASO 5 — Enviar el primer comando por la terminal de VS Code (recomendado)
Primero explicame esto:
"La terminal de VS Code es la forma recomendada de hablar con tus agentes.
El comando es:
openclaw agent --agent [agentid] 'tu mensaje aquí'

Esto envía un mensaje directamente a ese agente específico."

Guiame para enviar un comando de prueba al primer agente:
openclaw agent --agent [primer-agentid] 'Por favor presentate y
confirmá que leíste tu SOUL.md, AGENTS.md, IDENTITY.md, HEARTBEAT.md,
TOOLS.md y USER.md.
Luego reportá en tu canal de Discord que estás en línea.'

Preguntame: "¿Qué respondió el agente?
¿Viste aparecer un mensaje en su canal de Discord?"
Si sí: excelente — pasemos al siguiente agente.
Si no: ayudame a solucionar el problema.

Repetir para los 6 agentes.

PASO 6 — (Opcional) Configuración de la UI de OpenGoat
Después de que todos los agentes estén confirmados funcionando desde la terminal, ofrecé:
"También podés hablar con tus agentes a través de la UI de OpenGoat —
un panel visual en el navegador.
¿Querés configurar eso también?
Te da una interfaz con la que podés hacer clic para seleccionar agentes y enviar mensajes
sin necesidad de escribir comandos en la terminal."
Si sí: guiame para:
1. Abrir una nueva pestaña de terminal en VS Code
2. Ejecutar: opengoat start
3. El navegador se abrirá automáticamente con la UI de OpenGoat
Guiame por la interfaz — cómo seleccionar un agente y enviar un mensaje.
(Si el navegador no se abre automáticamente, ir a http://localhost:19123)
Si no: saltear y pasar al Paso 7.

PASO 7 — Confirmación final
Revisá esta lista de verificación conmigo:
□ Los 6 agentes registrados (openclaw agents list muestra los 6)
□ Security Guardian registrado (security-guardian aparece en la lista)
□ Security Guardian ejecutándose en PM2 (pm2 list lo muestra en línea)
□ Gateway funcionando (puerto 18789)
□ Cada agente respondió al primer comando
□ Cada agente publicó en su canal de Discord
□ (Opcional) UI de OpenGoat accesible en localhost:19123

PASO 8 — Generar CLAUDE.md
Una vez que los 6 agentes (incluyendo el Security Guardian) estén confirmados
como registrados y en funcionamiento, guiame para generar CLAUDE.md — el archivo
de instrucciones que Claude Code lee automáticamente al comienzo de cada sesión:

"Ahora generemos tu CLAUDE.md. Se construye automáticamente a partir de la
configuración de equipo que ya completaste, así que no necesitás completar nada
a mano."

Windows:
cd $env:USERPROFILE\.opengoat\workspaces\security-guardian
node generate_claude_md.js

Mac:
cd ~/.opengoat/workspaces/security-guardian
node generate_claude_md.js

Pedime que confirme que veo un mensaje que termina con algo como:
[OK] CLAUDE.md generated: (tu ruta)\.opengoat\CLAUDE.md

Si ya existe un CLAUDE.md, el script automáticamente hace una copia de
seguridad primero, y después pregunta si querés sobrescribirlo. "yes" lo
sobrescribe (con la copia de seguridad ya guardada); "no" guarda el nuevo
contenido como CLAUDE_generated_draft.md, dejando el CLAUDE.md existente
completamente intacto.

Si te pregunta por tu tier comprado (T1 / T2 / T3), guiame para ingresar mi
tier real.

Una vez generado, pedime que abra
$env:USERPROFILE\.opengoat\CLAUDE.md y confirme que los nombres del equipo y
los roles se vean correctos.

Cuando todas las casillas estén marcadas, decí:
"Tu equipo de BALIA OS está en vivo. Los 6 agentes están corriendo e informando
a Discord. Estás listo para la Sección 6 — Construyendo Tu Primera Habilidad."

Comenzá ahora. Haceme la primera pregunta.

Sobre CLAUDE.md

El archivo CLAUDE.md generado en el PASO 8 es un archivo de instrucciones que Claude Code en VS Code lee automáticamente al comienzo de cada sesión. Se genera en este punto — justo después de confirmar que todos los agentes están registrados y en funcionamiento — directamente bajo $env:USERPROFILE.opengoat.

Qué se incluye automáticamente:

Una tabla de composición del equipo (nombres y roles de los 6 agentes)
La prohibición absoluta de operaciones destructivas (confirmación requerida antes de eliminar/sobrescribir archivos, etc.)
El manejo de información sensible (sin salida en texto plano de API keys, webhooks, etc.)
Las reglas de idioma de salida

Personalizarlo: Todo lo que está debajo de la sección ## A partir de esta línea, personalizá libremente todo lo que sigue al final del archivo es tuyo para editar — agregá reglas específicas del proyecto, comandos frecuentes, o cualquier otra cosa útil.

Las dos secciones cerca del inicio — ## Prohibición Absoluta de Operaciones Destructivas (Crítico — Seguir Siempre — No Borrar) y ## Manejo de Información Sensible (No Borrar) — son reglas de seguridad centrales. Aparecen en tu idioma seleccionado (disponible en 20 idiomas). No elimines ni modifiques estas dos secciones.

Si ya existe un CLAUDE.md: Ejecutar el PASO 8 nunca sobrescribe silenciosamente un CLAUDE.md existente. El script primero hace una copia de seguridad automáticamente, y después pregunta si querés sobrescribirlo. Respondé "no" y el archivo existente queda completamente intacto — el contenido recién generado se guarda por separado como CLAUDE_generated_draft.md.

Hablar con Tus Agentes en el Día a Día

Una vez que todo esté configurado, así es como le das comandos:

Iniciá el gateway (hacé esto primero, en cada sesión):

Windows:

$env:DEBUG="-ciao*"; openclaw gateway --force

Mac:

DEBUG="-ciao*" openclaw gateway --force

Dejá esta pestaña de terminal corriendo. Abrí una nueva pestaña para otros comandos.

Desde la terminal de VS Code:

# Hablar con un agente específico
openclaw agent --agent marcus "Summarize what you worked on today"

# Verificar lista de agentes
openclaw agents list

# Reiniciar el gateway si es necesario
openclaw gateway restart

marcus es un ejemplo — reemplazalo con el ID de tu propio agente (ej. --agent ceo o --agent nova).

Desde la UI de OpenGoat:

Abrí una nueva pestaña de terminal en VS Code
Ejecutá: opengoat start
El navegador se abre automáticamente con la UI de OpenGoat
Seleccioná el agente desde el panel de la izquierda
Escribí tu mensaje y presioná Enter (Si el navegador no se abre automáticamente: ir a http://localhost:19123)

Desde Discord (solo reportes — no para comandos): Discord es donde tus agentes publican sus reportes. Ahí leés sus actualizaciones. Enviar comandos a los agentes vía Discord requiere un Bot de Discord — esta es una configuración avanzada que no se cubre en T1. Usá la terminal de VS Code o la UI de OpenGoat para dar comandos por ahora.

Si un Agente No Responde

Revisá esto en orden:

¿Está corriendo el gateway?
```
openclaw gateway restart
```
¿Está registrado el agente?
```
openclaw agents list
```
Si tu agente no aparece en la lista, volvé a ejecutar el comando agents add del Paso 2.
¿Están los archivos del workspace en el lugar correcto?
Verificá que SOUL.md, AGENTS.md e IDENTITY.md existan en:
Windows: $env:USERPROFILE\.opengoat\workspaces\[agentid]\
Mac: ~/.opengoat/workspaces/[agentid]/
¿Está configurada correctamente la API key? Abrí .env (en tu carpeta .opengoat) y confirmá que ANTHROPIC_API_KEY esté completada.

Si seguís teniendo problemas, pegá el mensaje de error en tu IA de chat y pedí ayuda.

Verificá Tu Configuración

Una vez que todos los agentes estén confirmados en vivo, ejecutá:

Windows:

node $env:USERPROFILE\.opengoat\workspaces\security-guardian\scripts\verify_setup.js --section 5

Mac:

node ~/.opengoat/workspaces/security-guardian/scripts/verify_setup.js --section 5

Esto confirma que los 6 agentes están registrados, que el Security Guardian está corriendo y que estás listo para la Sección 6.

Qué pasa en esta sección ​

Cómo funciona esta sección ​

▶ Pegá esto en tu IA para comenzar

Sobre CLAUDE.md ​

Hablar con Tus Agentes en el Día a Día ​