Sección 5: Lanzamiento de tus Agentes

Qué ocurre en esta sección

Registrarás cada agente con OpenClaw y les darás su primer comando. Al final, los 6 agentes estarán en vivo — 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, haz clic para seleccionar el agente y escribe tu mensaje
Terminal de VS Code	Recomendado — más rápido y con mayor control	`openclaw agent --agent [id] "tu mensaje"`

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

Enfoque recomendado — híbrido con IA: Cuando estés comenzando, mantén abierta tu IA de chat junto a tus agentes. Si un comando no funciona o no estás seguro de qué escribir, simplemente describe la situación a la IA y pide ayuda. Así es exactamente como la mayoría de las personas — incluido el equipo de BALIA OS — manejaron las cosas al principio. No necesitas 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

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

Si algo sale mal, describe el error o toma una captura de pantalla y compártela — la IA te ayudará a resolverlo.

▶ Pega esto en tu IA para comenzar

Adjunta 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.

He adjuntado mi Documento de Diseño de Equipo. Léelo para obtener
los IDs y nombres de mis agentes antes de comenzar.

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

Guíame paso a paso. Un paso a la vez. Si encuentro un error,
ayúdame a resolverlo antes de continuar. Si me atasco, pídeme que comparta
una captura de pantalla o que pegue el mensaje de error.

Esto es lo que necesitamos hacer:

PASO 1 — Iniciar el gateway
Dime: "Iniciaremos el gateway de OpenClaw con un comando que filtra
los registros de fondo ruidosos para que la terminal permanezca legible."

Guíame para abrir una nueva pestaña de terminal en VS Code y ejecutar
el comando correcto según mi SO (pregúntame qué SO tengo si aún no lo sabes):

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

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

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

Pídeme que confirme que veo: "✓ Gateway running on port 18789"
Dime que deje esta pestaña de terminal abierta — el gateway debe seguir ejecutándose.
Si hay un error, ayúdame a resolverlo antes de continuar.

PASO 2 — Registrar cada agente con OpenClaw
Para cada uno de mis 6 agentes (lee los IDs del Documento de Diseño de Equipo),
guíame 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 — reemplaza con los IDs de tus propios agentes de tu Documento de Diseño de Equipo.)

Muéstrame los 6 comandos a la vez con los IDs reales de mis agentes y mi nombre de usuario completados.
Pídeme que los ejecute uno por uno y confirme que cada uno tiene éxito antes
de mostrarme el siguiente.

Después de registrar los 6, guíame para verificar:
openclaw agents list
Pídeme 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.
Guíame para verificar que está presente:

openclaw agents list

Pídeme que confirme que security-guardian aparece en la lista.
Si no está, guíame 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 verifica la lista nuevamente antes de continuar.

PASO 3 — Reiniciar el gateway
Después de registrar los agentes, el gateway necesita reiniciarse para cargarlos.
Guíame para ejecutar:
openclaw gateway restart
Pídeme 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.
Guíame para iniciarlo:

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

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

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

Pídeme que confirme que veo el Security Guardian en la lista de PM2:
pm2 list

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

PASO 5 — Enviar el primer comando desde la terminal de VS Code (recomendado)
Explica primero 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."

Guíame para enviar un comando de prueba al primer agente:
openclaw agent --agent [primer-agentid] 'Por favor, preséntate y
confirma que has leído tu SOUL.md, AGENTS.md, IDENTITY.md, HEARTBEAT.md,
TOOLS.md y USER.md.
Luego reporta en tu canal de Discord que estás en línea.'

Pregúntame: "¿Qué respondió el agente?
¿Viste aparecer un mensaje en su canal de Discord?"
Si es así: excelente — continúa con el siguiente agente.
Si no: ayúdame a solucionar el problema.

Repite para los 6 agentes.

PASO 6 — (Opcional) Configuración de la interfaz de OpenGoat
Después de confirmar que todos los agentes funcionan correctamente en la terminal, ofrece:
"También puedes hablar con tus agentes a través de la interfaz de OpenGoat —
un panel visual en el navegador.
¿Te gustaría configurarlo también?
Te da una interfaz con la que puedes seleccionar agentes y enviar mensajes
sin necesidad de escribir comandos en la terminal."
Si acepta: guíame 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 interfaz de OpenGoat
Explícame cómo usar la interfaz — cómo seleccionar un agente y enviar un mensaje.
(Si el navegador no se abre automáticamente, ve a http://localhost:19123)
Si no acepta: omite este paso y pasa al Paso 7.

PASO 7 — Confirmación final
Revisa esta lista de verificación conmigo:
□ Los 6 agentes están registrados (openclaw agents list muestra los 6)
□ Security Guardian está registrado (security-guardian aparece en la lista)
□ Security Guardian está ejecutándose en PM2 (pm2 list lo muestra en línea)
□ El gateway está en ejecución (puerto 18789)
□ Cada agente respondió al primer comando
□ Cada agente publicó en su canal de Discord
□ (Opcional) La interfaz de OpenGoat es 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 ejecución, guíame para generar CLAUDE.md — el archivo de instrucciones
que Claude Code lee automáticamente al inicio de cada sesión:

"Ahora generemos tu CLAUDE.md. Se construye automáticamente a partir de
la configuración del equipo que ya completaste, así que no necesitas llenar 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

Pídeme que confirme que ve 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 luego pregunta si se debe sobrescribir. "yes" lo sobrescribe
(la copia de seguridad ya está guardada); "no" guarda el nuevo contenido como
CLAUDE_generated_draft.md en su lugar, dejando el CLAUDE.md existente completamente
intacto.

Si me preguntan por mi tier comprado (T1 / T2 / T3), guíame para ingresar mi
tier real.

Después de generarlo, pídeme 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, di:
"Tu equipo de BALIA OS está activo. Los 6 agentes están en ejecución y reportando
a Discord. Estás listo para la Sección 6 — Construyendo tu primera habilidad."

Comienza ahora. Hazme la primera pregunta.

Acerca de 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 inicio de cada sesión. Se genera en este punto — justo después de confirmar que todos los agentes están registrados y en ejecución — 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 (se requiere confirmación antes de eliminar/sobrescribir archivos, etc.)
El manejo de información sensible (sin salida en texto plano de claves de API, webhooks, etc.)
Las reglas de idioma de salida

Personalizándolo: Todo lo que está debajo de la sección ## Personaliza libremente todo lo que está debajo de esta línea en la parte inferior del archivo es tuyo para editar — agrega reglas específicas del proyecto, comandos frecuentes o cualquier otra cosa útil.

Las dos secciones cerca de la parte superior — ## Prohibición Absoluta de Operaciones Destructivas (Crítico — Seguir Siempre — No Eliminar) y ## Manejo de Información Sensible (No Eliminar) — son reglas de seguridad fundamentales. 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 sobrescribirá silenciosamente un CLAUDE.md existente. El script primero hace una copia de seguridad automáticamente, y luego pregunta si se debe sobrescribir. Responde "no" y el archivo existente queda completamente intacto — el nuevo contenido generado se guarda por separado como CLAUDE_generated_draft.md.

Cómo hablar con tus agentes día a día

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

Inicia el gateway (haz esto primero, en cada sesión):

Windows:

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

Mac:

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

Deja esta pestaña de terminal ejecutándose. Abre una nueva pestaña para otros comandos.

A través de la terminal de VS Code:

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

# Revisa la lista de agentes
openclaw agents list

# Reinicia el gateway si es necesario
openclaw gateway restart

marcus es un ejemplo — reemplázalo con tu propio ID de agente (p. ej. --agent ceo o --agent nova).

A través de la interfaz de OpenGoat:

Abre una nueva pestaña de terminal en VS Code
Ejecuta: opengoat start
El navegador se abre automáticamente con la interfaz de OpenGoat
Selecciona el agente desde el panel izquierdo
Escribe tu mensaje y presiona Enter (Si el navegador no se abre automáticamente: ve a http://localhost:19123)

A través de Discord (solo para reportes — no para comandos): Discord es donde tus agentes publican sus reportes. Aquí lees sus actualizaciones. Enviar comandos a los agentes a través de Discord requiere un Bot de Discord — esta es una configuración avanzada que no se cubre en T1. Por ahora, usa la terminal de VS Code o la interfaz de OpenGoat para dar comandos.

Si un agente no responde

Revisa estos puntos en orden:

¿Está el gateway en ejecución?
```
openclaw gateway restart
```
¿Está el agente registrado?
```
openclaw agents list
```
Si tu agente no aparece en la lista, vuelve a ejecutar el comando agents add del Paso 2.
¿Están los archivos del espacio de trabajo en el lugar correcto?
Verifica que SOUL.md, AGENTS.md e IDENTITY.md existan en:
Windows: $env:USERPROFILE\.opengoat\workspaces\[agentid]\
Mac: ~/.opengoat/workspaces/[agentid]/
¿Está la clave de API configurada correctamente? Abre .env (en tu carpeta .opengoat) y confirma que ANTHROPIC_API_KEY esté completado.

Si sigues teniendo problemas, pega el mensaje de error en tu IA de chat y pide ayuda.

Verifica tu configuración

Una vez que todos los agentes estén confirmados como activos, ejecuta:

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á en ejecución y que estás listo para la Sección 6.

Qué ocurre en esta sección ​

Cómo funciona esta sección ​

▶ Pega esto en tu IA para comenzar

Acerca de CLAUDE.md ​

Cómo hablar con tus agentes día a día ​