Sección 5: Lanzar tus agentes

Qué ocurre en esta sección

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

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

Enfoque recomendado — híbrido con IA: Cuando estés empezando, mantén abierta tu IA de chat junto a tus agentes. Si un comando no funciona o no sabes qué escribir, simplemente describe la situación a la IA y pídele ayuda. Así es exactamente como la mayoría de la gente — incluido el equipo de BALIA OS — gestionó las cosas al principio. No necesitas dominar el terminal el primer día. La ventana de chat con la 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 del Equipo para que la IA conozca los IDs de tus agentes y las rutas de trabajo.

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

▶ Pega esto en tu IA para empezar

Adjunta tu Documento de Diseño del Equipo antes de enviar.

Estás ayudándome a registrar y lanzar mi equipo multi-agente de BALIA OS
en OpenClaw.

He adjuntado mi Documento de Diseño del 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\[username])"
Usa ese nombre de usuario en todas las rutas de archivo 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 solucionarlo antes de continuar. Si me quedo atascado, pídeme
que comparta una captura de pantalla o que pegue el mensaje de error.

Esto es lo que necesitamos hacer:

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

Guíame para abrir una nueva pestaña de terminal en VS Code y ejecutar el
comando correcto para mi sistema operativo (pregúntame cuál uso 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 el terminal. El flag --force elimina cualquier
instancia anterior de la puerta de enlace. Tu terminal permanecerá limpio y legible."

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

PASO 2 — Registrar cada agente en OpenClaw
Para cada uno de mis 6 agentes (lee los IDs del Documento de Diseño del Equipo),
guíame para ejecutar este comando en el 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 — sustitúyelo por los IDs de tus propios agentes de tu Documento de Diseño del Equipo.)

Muéstrame los 6 comandos a la vez con los IDs de mis agentes reales y mi nombre de
usuario completados.
Pídeme que los ejecute uno a uno y que 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 Guardián de Seguridad
El Guardián de Seguridad ya fue registrado en 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 falta, 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 de nuevo antes de continuar.

PASO 3 — Reiniciar la puerta de enlace
Después de registrar los agentes, la puerta de enlace necesita reiniciarse para cargarlos.
Guíame para ejecutar:
openclaw gateway restart
Pídeme que confirme que la puerta de enlace está funcionando de nuevo antes de continuar.

PASO 4 — Iniciar el Guardián de Seguridad (PM2)
El Guardián de Seguridad 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: sustituye la ruta por ~/.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 Guardián de Seguridad 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 el terminal de VS Code (recomendado)
Explica esto primero:
"El 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 [first-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 informa 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í: genial — pasa al siguiente agente.
Si no: ayúdame a solucionar el problema.

Repite para los 6 agentes.

PASO 6 — (Opcional) Configuración de la interfaz OpenGoat
Una vez confirmado que todos los agentes funcionan correctamente desde el terminal, ofrece:
"También puedes hablar con tus agentes a través de la interfaz OpenGoat —
un panel visual en el navegador.
¿Te gustaría configurarlo también?
Te ofrece una interfaz con la que puedes seleccionar agentes y enviar mensajes
sin necesidad de escribir comandos en el terminal."
Si sí: 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 OpenGoat
Explícame cómo funciona 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: omitir y pasar al Paso 7.

PASO 7 — Confirmación final
Repasa 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 en funcionamiento (puerto 18789)
□ Cada agente respondió al primer comando
□ Cada agente publicó en su canal de Discord
□ (Opcional) Interfaz OpenGoat accesible en localhost:19123

PASO 8 — Generar CLAUDE.md
Una vez confirmado que los 6 agentes (incluido el Guardián de Seguridad) están
registrados y en funcionamiento, guíame para generar CLAUDE.md — el archivo
de instrucciones que Claude Code lee automáticamente al inicio de cada sesión:

"Ahora vamos a generar tu CLAUDE.md. Se construye automáticamente a partir
de la configuración del equipo que ya completaste, así que no necesitas
rellenar 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 hace automáticamente una copia de
seguridad primero y luego pregunta si se desea sobrescribir. "yes" lo
sobrescribe (la copia de seguridad ya está guardada); "no" guarda el
nuevo contenido como CLAUDE_generated_draft.md, dejando el CLAUDE.md
existente completamente intacto.

Si me pregunta por mi tier comprado (T1 / T2 / T3), guíame para introducir
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 ven correctos.

Cuando todas las casillas estén marcadas, di:
"Tu equipo BALIA OS está en marcha. Los 6 agentes están funcionando e informando
a Discord. Estás listo para la Sección 6 — Construyendo tu primera habilidad."

Empieza 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 momento — 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 obligatoria antes de eliminar/sobrescribir archivos, etc.)
El manejo de información sensible (sin salida en texto plano de claves API, webhooks, etc.)
Las reglas de idioma de salida

Cómo personalizarlo: Todo lo que está debajo de la sección "Personaliza libremente todo lo que hay debajo de esta línea" al final del archivo es tuyo para editar — añade reglas específicas del proyecto, comandos habituales 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 esenciales. 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 hace automáticamente una copia de seguridad primero y luego pregunta si se desea sobrescribir. Responde "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 configurado todo, así es como das instrucciones:

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 del terminal en ejecución. Abre una nueva pestaña para otros comandos.

Desde el terminal de VS Code:

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

# Comprobar la lista de agentes
openclaw agents list

# Reiniciar el gateway si es necesario
openclaw gateway restart

marcus es un ejemplo — sustitúyelo por el ID de tu propio agente (p. ej. --agent ceo o --agent nova).

Desde la interfaz OpenGoat:

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

Desde Discord (solo informes — no para comandos): Discord es donde tus agentes publican sus informes. Consulta aquí 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 trata en T1. Usa el terminal de VS Code o la interfaz OpenGoat para dar comandos por ahora.

Si un agente no responde

Comprueba esto 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?
Comprueba que SOUL.md, AGENTS.md e IDENTITY.md existen en:
Windows: $env:USERPROFILE\.opengoat\workspaces\[agentid]\
Mac: ~/.opengoat/workspaces/[agentid]/
¿Está la clave API configurada correctamente? Abre .env (en tu carpeta .opengoat) y confirma que ANTHROPIC_API_KEY está relleno.

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

Verificar tu configuración

Una vez confirmado que todos los agentes están 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 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 empezar

Acerca de CLAUDE.md ​

Hablar con tus agentes en el día a día ​