Sección 4: Creación de los Archivos de tu Agente

Qué Estás Construyendo

Cada agente necesita un conjunto de archivos para funcionar correctamente. OpenClaw lee los archivos principales de forma automática al inicio de cada sesión. Los archivos adicionales del espacio de trabajo le brindan a cada agente contexto, tareas programadas y reglas de herramientas.

Configuración del agente — leída por OpenClaw:

Archivo	Ubicación	Propósito
`config.json`	`agents/[id]/config.json`	Definición del agente en OpenClaw, prompt de sistema
`models.json`	`agents/[id]/models.json`	Configuración del modelo de IA

Archivos del espacio de trabajo — cargados automáticamente por OpenClaw en cada sesión:

Archivo	Propósito
`SOUL.md`	Personalidad, tono, límites estrictos, misión — mantener en menos de 400 palabras
`AGENTS.md`	Reglas de operación, procedimientos de reporte — mantener en menos de 400 palabras
`IDENTITY.md`	Nombre, rol, a quién reportan — solo datos, mantener breve
`HEARTBEAT.md`	Tareas siempre activas, tareas programadas, respuesta a anomalías
`TOOLS.md`	Herramientas permitidas, reglas de habilidades, acciones prohibidas
`USER.md`	Preferencias del Comandante, estilo de comunicación, zona horaria

Archivo de detalle de rol — leído una vez por sesión mediante instrucción en AGENTS.md:

Archivo	Propósito
`SPEC_[NAME].md`	Rol detallado, responsabilidades, rutas clave

Solo CEO — carpeta de identidad:

Archivo	Propósito
`identity/COMPANY_PROFILE.md`	Antecedentes de la empresa, detalles del negocio
`identity/PERSONAL_PROFILE.md`	Antecedentes del propietario, habilidades, experiencia
`identity/VALUES.md`	Estilo de pensamiento, valores, principios de decisión

Estructura completa del espacio de trabajo — todos los agentes:

INFO

$env:USERPROFILE/.opengoat/ ├── agents/ │ └── [agentid]/ │ ├── config.json ← OpenClaw lee este archivo │ └── models.json └── workspaces/ └── [agentid]/ ├── SOUL.md ← cargado automáticamente ├── AGENTS.md ← cargado automáticamente ├── IDENTITY.md ← cargado automáticamente ├── HEARTBEAT.md ← cargado automáticamente ├── TOOLS.md ← cargado automáticamente ├── USER.md ← cargado automáticamente └── SPEC_[NAME].md ← leído mediante instrucción en AGENTS.md

Espacio de trabajo del CEO — carpeta de identidad adicional:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ├── PERSONAL_PROFILE.md └── VALUES.md

Cómo Funciona la Sección 4

En esta sección, trabajarás con tu AI concierge para diseñar cada agente. Para cada agente, decidirás:

Nombre y rol
Personalidad y estilo de comunicación
Qué herramientas puede usar

Una vez que hayas finalizado el diseño con tu AI concierge, tu Security Guardian escribirá los archivos de configuración automáticamente. No necesitas editar ningún archivo manualmente.

Cómo Funciona Esta Sección — Dos Partes

Esta sección tiene dos partes. Complétalas en orden:

Parte 1 — Configuración de Discord (el prompt a continuación) Crea tu servidor de Discord, canales y obtén las URLs de Webhook para cada agente. Esto toma aproximadamente 10 minutos.

Parte 2 — Archivos del Agente (el siguiente prompt) Genera los archivos del agente usando tu Documento de Diseño de Equipo. La IA genera comandos de terminal — pégalos en VS Code para crear los archivos automáticamente.

Comienza con la Parte 1 ahora.

URLs de Webhook de Discord — Obtén Estas Primero

Cada agente reporta a su propio canal de Discord a través de una URL de Webhook. Las necesitas antes de escribir los archivos AGENTS.md.

▶ Pega esto en tu IA para comenzar

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

Estás ayudándome a configurar canales de Discord y URLs de Webhook para mi
equipo multi-agente de BALIA OS.

Guíame paso a paso. Haz una pregunta a la vez.
Si me atasco, pídeme que tome una captura de pantalla y describa lo que veo.

He adjuntado mi Documento de Diseño de Equipo.

PASO 1 — Verificar Discord
Pregunta: "¿Tienes Discord instalado y una cuenta configurada?"
Si no: guíame a discord.com para descargar y crear una cuenta.
Si sí: pasa al Paso 2.

PASO 2 — Crear un servidor de Discord
Guíame para crear un nuevo servidor:
- Haz clic en el botón + en la barra lateral izquierda
- Selecciona "Crear el mío" -> "Para mí y mis amigos"
- Nómbralo "BALIA OS Team"
Confirma que puedo verlo antes de continuar.

PASO 3 — Crear canales para cada agente
Lee mi Documento de Diseño de Equipo para conocer los nombres de los canales.
Para cada agente, crea un canal de texto:
- Haz clic derecho en "Canales de texto" -> Agregar canal -> Texto
- Usa el nombre del canal de mi Documento de Diseño de Equipo
Repite para los 6 agentes. Confirma que todos los canales existen antes de continuar.

PASO 4 — Obtener una URL de Webhook para cada canal
Un canal a la vez:
1. Haz clic derecho en el canal -> Editar canal
2. Integraciones -> Webhooks -> Nuevo Webhook
3. Nómbralo según el agente (ej. "Marcus")
4. Copia la URL del Webhook
5. Pídeme que la pegue en un lugar seguro
Repite para los 6. Confirma que las 6 URLs están guardadas antes de continuar.

PASO 5 — Agregar al archivo .env
Guíame para abrir el archivo .env en VS Code.
El archivo se encuentra en:
- Windows: $env:USERPROFILE\.opengoat\.env
- Mac: ~/.opengoat/.env
Agrega cada webhook:
DISCORD_WEBHOOK_[AGENTNAME]=https://discord.com/api/webhooks/xxxxx/xxxxx
(nombres de agente en MAYÚSCULAS)
Dime: "Nunca compartas este archivo. Nunca lo subas a GitHub."

Cuando todos los webhooks estén guardados: "Configuración de Discord completa."

Comienza ahora. Hazme la primera pregunta.

Cómo Usar el Prompt de IA

Pega el siguiente prompt en tu IA de chat y adjunta:

Tu Documento de Diseño de Equipo de la Sección 2

La IA genera comandos de terminal para cada agente uno a la vez. Pega los comandos en tu terminal de VS Code para crear los archivos automáticamente.

▶ Pega esto en tu IA para comenzar

Estás ayudándome a crear los archivos de agente para BALIA OS,
un sistema operativo multi-agente de IA construido sobre OpenClaw.

Adjunto:
1. Mi Documento de Diseño de Equipo (de la Sección 2)

Léelo antes de generar cualquier cosa.
Extrae todos los nombres de agentes, IDs y nombres de canales de Discord de este documento.

ARQUITECTURA:

1. Yo soy el Comandante. Comando a cada agente directamente. Sin orquestador.

2. Cada agente tiene dos ubicaciones:
   - agents/[id]/ — configuración de OpenClaw (config.json + models.json)
   - workspaces/[id]/ — archivos del espacio de trabajo (SOUL, AGENTS, IDENTITY, HEARTBEAT, TOOLS, USER, SPEC)
   Todas las rutas están bajo $env:USERPROFILE/.opengoat/

3. OpenClaw inyecta automáticamente SOUL.md, AGENTS.md, IDENTITY.md, HEARTBEAT.md,
TOOLS.md, USER.md al inicio de cada sesión. No escribas instrucciones de "léete a ti mismo" en ellos.

4. SPEC_[NOMBRE].md NO se inyecta automáticamente. Agrega al Inicio de Sesión en AGENTS.md:
   "Lee SPEC_[NOMBREAGENTE].md para el detalle completo del rol"

5. El CEO solo tiene una carpeta identity/ dentro de workspaces/ceo/:
   identity/COMPANY_PROFILE.md
   identity/PERSONAL_PROFILE.md
   identity/VALUES.md
   Genera estos archivos únicamente para el agente CEO.

6. SOUL.md y AGENTS.md: menos de 400 palabras cada uno (se inyectan en cada sesión).
   SPEC: puede ser detallado (se lee una vez por sesión).

ANTES DE GENERAR — pregúntame:
"¿Cuál es tu nombre de usuario de Windows? (El nombre en C:\Users\[nombredeusuario])"
Espera mi respuesta y luego usa ese nombre de usuario en todas las rutas de archivos.

GENERA PARA CADA AGENTE:

====================================
ARCHIVO 1: SOUL.md
Ruta: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md
Se inyecta automáticamente en cada sesión. Menos de 400 palabras.
====================================

# SOUL.md — [Nombre del Agente]

## Quién Eres
[2-3 oraciones: identidad, personalidad, enfoque de trabajo]

## Tono
- [Regla 1]
- [Regla 2]
- [Regla 3]
- [Estilo prohibido]

## Límites Estrictos
- Nunca actuar fuera del rol definido
- Nunca reportar como completo sin verificar el resultado
- Nunca tomar una acción destructiva sin aprobación del Comandante
- [1-2 límites específicos del rol]

## Misión Actual
[1-2 oraciones sobre el enfoque actual]

====================================
ARCHIVO 2: AGENTS.md
Ruta: $env:USERPROFILE/.opengoat/workspaces/[agentid]/AGENTS.md
Se inyecta automáticamente en cada sesión. Menos de 400 palabras.
====================================

# AGENTS.md — Procedimientos Operativos de [Nombre del Agente]

## Inicio de Sesión (Cada sesión — en este orden)
1. Confirmar identidad desde SOUL.md
2. Leer SPEC_[NOMBREAGENTE].md para el detalle del rol
3. Leer HEARTBEAT.md — anotar tareas programadas
4. Leer TOOLS.md — anotar herramientas permitidas y restricciones
5. Leer USER.md — anotar preferencias del Comandante
6. Reportar en Discord: "🔷 [Nombre] listo. [tarea actual o estado]"

(Solo CEO — después del paso 2, también leer:
  identity/COMPANY_PROFILE.md
  identity/PERSONAL_PROFILE.md
  identity/VALUES.md)

## Fin de Sesión (Cada sesión)
1. Reportar en Discord: "✅ Sesión de [Nombre] completada. [resumen]"
2. Anotar cualquier tarea pendiente para la siguiente sesión

## Reportes
- Canal: #[canal-de-discord]
- Comando: python $env:USERPROFILE/.opengoat/scripts/discord_send.py
  DISCORD_WEBHOOK_[NOMBRE] "mensaje"
  (discord_send.py se despliega automáticamente en la sección del Guardián de Seguridad más adelante)
- HTTP 204 = éxito. De lo contrario = reportar falla inmediatamente.
- Formato: Conclusión -> Detalle -> Siguiente acción recomendada
- Reportar en: inicio de sesión / tarea completada / error / fin de sesión

## Manejo de Errores
1. Revisar SPEC_[NOMBRE].md para patrones de error conocidos
2. Sin resolver -> reportar detalle completo al Comandante
3. No reintentar acciones destructivas sin aprobación del Comandante

## Reglas Estrictas
- Verificar antes de reportar como completo
- Sin acciones fuera del rol definido
- Sin operaciones destructivas sin aprobación del Comandante

====================================
ARCHIVO 3: IDENTITY.md
Ruta: $env:USERPROFILE/.opengoat/workspaces/[agentid]/IDENTITY.md
Se inyecta automáticamente. Solo datos, mantener breve.
====================================

# IDENTITY.md

Name: [Nombre del Agente]
Agent ID: [agentid-en-minúsculas]
Role: [Título del Rol]
Department: Equipo BALIA OS
Reports To: Comandante (directamente)
Discord: #[nombre del canal]

====================================
ARCHIVO 4: HEARTBEAT.md
Ruta: $env:USERPROFILE/.opengoat/workspaces/[agentid]/HEARTBEAT.md
Se inyecta automáticamente. Tareas programadas y respuesta a anomalías.
====================================

# HEARTBEAT.md — [Nombre del Agente]

## Siempre Activo
[Qué monitorea o mantiene este agente de forma continua]

## Tareas Programadas
[Tareas recurrentes — diarias, semanales o por disparador]

## Al Inicio de Sesión
- Leer SOUL.md y AGENTS.md
- Reportar: "🔷 [Nombre] listo"

## En caso de Error o Anomalía
- Reportar inmediatamente al Comandante vía Discord
- Nunca autocorregirse sin aprobación del Comandante

====================================
ARCHIVO 5: TOOLS.md
Ruta: $env:USERPROFILE/.opengoat/workspaces/[agentid]/TOOLS.md
Se inyecta automáticamente. Reglas y restricciones de herramientas.
====================================

# TOOLS.md — Reglas de Herramientas de [Nombre del Agente]

## Principio Central
- Revisar SPEC_[NOMBRE].md antes de cada tarea para conocer las herramientas permitidas
- Cargar únicamente lo que la tarea requiere

## Herramientas Permitidas
[Lista de herramientas relevantes para el rol de este agente]

## Reporte en Discord
Siempre usar discord_send.py directamente:
python $env:USERPROFILE/.opengoat/scripts/discord_send.py DISCORD_WEBHOOK_[NOMBRE] "mensaje"
Confirmar HTTP 204 después de enviar.

## Prohibido
- Codificar en duro claves API o Webhooks (siempre leer desde .env)
- Acciones fuera del rol definido
- Comunicación externa innecesaria

====================================
ARCHIVO 6: USER.md
Ruta: $env:USERPROFILE/.opengoat/workspaces/[agentid]/USER.md
Se inyecta automáticamente. Preferencias del Comandante.
====================================

# USER.md — Perfil del Comandante

## Nombre
[Nombre preferido del Comandante]

## Zona Horaria
[Zona horaria — pregúntame si no está en el Documento de Diseño del Equipo]

## Estilo de Comunicación
- [Preferencia 1]
- [Preferencia 2]

## Fase Actual
[En qué estamos enfocados construyendo ahora mismo]

====================================
ARCHIVO 7: SPEC_[NOMBREAGENTE].md
Ruta: $env:USERPROFILE/.opengoat/workspaces/[agentid]/SPEC_[NOMBREAGENTE].md
No se inyecta automáticamente. Se lee una vez por sesión vía AGENTS.md.
====================================

# SPEC_[NOMBREAGENTE] v1.0 — [Nombre del Agente] ([Rol])
Última Actualización: [hoy]

## 1. Rol
[2-3 oraciones]

## 2. Responsabilidades
[Lista de viñetas del Documento de Diseño del Equipo]

## 3. Lo que Este Agente NO Hace
[Límites claros]

## 4. Misión de la Fase Actual
[Enfoque actual]

## 5. Rutas Clave
- Workspace: $env:USERPROFILE/.opengoat/workspaces/[agentid]/
- Webhook de Discord: DISCORD_WEBHOOK_[NOMBRE] (leer desde .env)

## 6. Registro de Cambios
| Versión | Fecha | Cambios |
|---------|-------|---------|
| v1.0 | [hoy] | Creación inicial |

====================================
SOLO CEO — ARCHIVOS 8, 9, 10: carpeta identity/
Haz estas 3 preguntas de una en una antes de generar.
====================================
P1: "Cuéntame sobre tu empresa — qué hace, cuánto tiempo lleva operando, qué mercados atiende."

Q2: "Cuéntame sobre ti — antecedentes, habilidades, experiencia relevante para este negocio."

Q3: "¿Cómo tomas decisiones? ¿Qué valores te guían? ¿Qué estilos de pensamiento o perspectivas desearías tener más?"

Después de las 3 respuestas, genera:

COMPANY_PROFILE.md — contenido de P1, estructurado
PERSONAL_PROFILE.md — contenido de P2, estructurado
VALUES.md — contenido de P3, estructurado

Ruta: $env:USERPROFILE/.opengoat/workspaces/ceo/identity/

Cuanto más detalle se proporcione aquí, más el CEO piensa y
decide como el dueño.

====================================

CÓMO ENTREGAR LOS ARCHIVOS:

Después de generar el contenido de cada archivo, muestra los comandos
exactos en Python para crear el archivo. Formato:

--- PEGAR EN LA TERMINAL (Windows) ---
python -c "
content = '''[contenido completo del archivo aquí]'''
import os
path = r'$env:USERPROFILE/.opengoat/workspaces/[agentid]/SOUL.md'
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

--- PEGAR EN LA TERMINAL (Mac) ---
python3 -c "
content = '''[contenido completo del archivo aquí]'''
import os
path = os.path.expanduser('~/.opengoat/workspaces/[agentid]/SOUL.md')
os.makedirs(os.path.dirname(path), exist_ok=True)
open(path, 'w', encoding='utf-8').write(content)
print('Created:', path)
"

Espera a que pegue el comando y confirme que se ejecutó antes de
pasar al siguiente archivo. Pregunta: "¿Viste 'Created: [ruta]'?"

CÓMO PROCEDER:
- Comienza con el Agente #1 (no el CEO)
- Genera un archivo a la vez, un agente a la vez
- Siempre espera la confirmación de la terminal antes del siguiente archivo
- Cuando llegues al CEO: haz primero las 3 preguntas de identidad,
  luego genera 7 archivos principales + 3 archivos de identidad
- Termina con una tabla resumen de todos los archivos creados

Una vez que tu AI concierge haya confirmado el diseño, pide al Security Guardian que escriba los archivos:

Windows:

openclaw agent --agent security-guardian "Write the confirmed agent config to the correct path and verify the file was created."

Guardian confirmará cuando los archivos estén escritos correctamente.

Paso 2 — Confirmar que los archivos fueron creados

Después de que la IA te haya guiado por todos los archivos, confirma el espacio de trabajo de cada agente:

Windows:

dir $env:USERPROFILE\.opengoat\workspaces\[agentid]

Mac:

ls ~/.opengoat/workspaces/[agentid]

Deberías ver:

SOUL.md
AGENTS.md
IDENTITY.md
HEARTBEAT.md
TOOLS.md
USER.md
SPEC_[NAME].md

El CEO adicionalmente:

identity/
├── COMPANY_PROFILE.md
├── PERSONAL_PROFILE.md
└── VALUES.md

Paso 3 — Verificar antes de pasar al siguiente agente

Abre AGENTS.md. ¿La sección de Inicio de Sesión lista todos los pasos incluyendo HEARTBEAT.md, TOOLS.md y USER.md?

Sí -> continúa. No -> pide a la IA que lo corrija primero.

Cuando esta sección esté completa

El espacio de trabajo de cada agente:

INFO

workspaces/[agentid]/ ├── SOUL.md ✅ ├── AGENTS.md ✅ ├── IDENTITY.md ✅ ├── HEARTBEAT.md ✅ ├── TOOLS.md ✅ ├── USER.md ✅ └── SPEC_[NAME].md ✅

El CEO adicionalmente:

INFO

workspaces/ceo/ └── identity/ ├── COMPANY_PROFILE.md ✅ ├── PERSONAL_PROFILE.md ✅ └── VALUES.md ✅

Nota: El Guardián de Seguridad se desplegó en la Sección 3. Si omitiste la Sección 3, vuelve y complétala antes de continuar con la Sección 5.

Qué Estás Construyendo ​

Cómo Funciona la Sección 4 ​

Cómo Funciona Esta Sección — Dos Partes ​

URLs de Webhook de Discord — Obtén Estas Primero ​

▶ Pega esto en tu IA para comenzar

Cómo Usar el Prompt de IA ​

▶ Pega esto en tu IA para comenzar

Paso 2 — Confirmar que los archivos fueron creados ​

Paso 3 — Verificar antes de pasar al siguiente agente ​

Cuando esta sección esté completa ​

Qué Estás Construyendo

Cómo Funciona la Sección 4

Cómo Funciona Esta Sección — Dos Partes

URLs de Webhook de Discord — Obtén Estas Primero

Cómo Usar el Prompt de IA

Paso 2 — Confirmar que los archivos fueron creados

Paso 3 — Verificar antes de pasar al siguiente agente

Cuando esta sección esté completa