Qué Estás Construyendo

Cada agente necesita un conjunto de archivos para funcionar correctamente. OpenClaw lee los archivos principales automáticamente al iniciar la sesión. Los archivos adicionales del espacio de trabajo proporcionan 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 del 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 por debajo de 400 palabras
AGENTS.md	Reglas de funcionamiento, procedimientos de reporte — mantener por debajo de 400 palabras
IDENTITY.md	Nombre, rol, a quién reporta — solo datos, mantener breve
HEARTBEAT.md	Tareas permanentes, 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 para el CEO — carpeta de identidad:

Archivo	Propósito
identity/COMPANY_PROFILE.md	Información de la empresa, detalles del negocio
identity/PERSONAL_PROFILE.md	Historial 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 esto │ └── 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 de abajo) Crea tu servidor de Discord, los canales y obtén las URLs de Webhook para cada agente. Esto tarda aproximadamente 10 minutos.

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

Empieza ahora con la Parte 1.

---

URLs de Webhook de Discord — Obtenlas Primero

Cada agente reporta a su propio canal de Discord mediante una URL de Webhook. Las necesitarás antes de escribir los archivos AGENTS.md.

▶ Pega esto en tu IA para empezar

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

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 quedo atascado, pídeme que haga una captura de pantalla y describa lo que veo.

He adjuntado mi Documento de Diseño del Equipo.

PASO 1 — Comprobar Discord
Pregunta: "¿Tienes Discord instalado y una cuenta configurada?"
Si no: guíame a discord.com para descargarlo 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 del Equipo para los nombres de los canales.
Para cada agente, crea un canal de texto:
- Haz clic derecho en "Canales de texto" -> Añadir canal -> Texto
- Usa el nombre del canal de mi Documento de Diseño del 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 (por ejemplo, "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 — Añadir al archivo .env
Guíame para abrir el archivo .env en VS Code.
El archivo está en:
- Windows: $env:USERPROFILE\.opengoat\.env
- Mac: ~/.opengoat/.env
Añade 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 completada."

Empieza ahora. Hazme la primera pregunta.

---

Uso del Prompt de IA

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

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

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

---

▶ Pega esto en tu IA para empezar

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

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

Léelo antes de generar nada.
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 "léete a ti mismo" en ellos.

4. SPEC_[NOMBRE].md NO se inyecta automáticamente. Añade en el Inicio de Sesión de 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\[nombre de usuario])"
Espera mi respuesta y utiliza ese nombre de usuario en todas las rutas de archivo.

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 frases: identidad, personalidad, enfoque de trabajo]

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

## Límites Inamovibles
- Nunca actuar fuera del rol definido
- Nunca reportar como completado sin verificar el resultado
- Nunca llevar a cabo una acción destructiva sin aprobación del Comandante
- [1-2 límites específicos del rol]

## Misión Actual
[1-2 frases sobre el foco 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 — tras el paso 2, leer también:
  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 las tareas pendientes para la próxima sesión

## Reporte
- Canal: #[canal-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 a continuación)
- HTTP 204 = éxito. Si no = reportar el fallo inmediatamente.
- Formato: Conclusión -> Detalle -> Próxima acción recomendada
- Reportar en: inicio de sesión / tarea completada / error / fin de sesión

## Gestión de Errores
1. Consultar SPEC_[NOMBRE].md para patrones de error conocidos
2. Sin resolver -> reportar el detalle completo al Comandante
3. Sin reintentos destructivos sin aprobación del Comandante

## Reglas Inamovibles
- Verificar antes de reportar como completado
- Ninguna acción fuera del rol definido
- Ninguna operación destructiva 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

Nombre: [Nombre del Agente]
ID de Agente: [agentid-minúsculas]
Rol: [Título del Rol]
Departamento: Equipo BALIA OS
Reporta a: 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 ante anomalías.
====================================

# HEARTBEAT.md — [Nombre del Agente]

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

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

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

## Ante un 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 Fundamental
- Consultar SPEC_[NOMBRE].md antes de cada tarea para ver las herramientas permitidas
- Cargar solo lo que la tarea requiera

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

## Reporte en Discord
Usar siempre discord_send.py directamente:
python $env:USERPROFILE/.opengoat/scripts/discord_send.py DISCORD_WEBHOOK_[NOMBRE] "mensaje"
Confirmar HTTP 204 tras el envío.

## Prohibido
- Codificar de forma fija claves API o Webhooks (leer siempre 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 centrados en construir 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 a través de AGENTS.md.
====================================

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

## 1. Rol
[2-3 frases]

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

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

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

## 5. Rutas Clave
- Espacio de trabajo: $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 negocio: qué hace, cuánto tiempo lleva en funcionamiento, qué mercados atiende."

P2: "Cuéntame sobre ti: formación, habilidades, experiencia relevante para este negocio."

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

Tras 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 pensará y decidirá
el CEO como el propietario.

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

CÓMO ENTREGAR LOS ARCHIVOS:

Tras generar el contenido de cada archivo, muestra los comandos
exactos de 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: "¿Ves 'Created: [ruta]'?"

CÓMO PROCEDER:
- Empieza con el Agente n.º 1 (no el CEO)
- Genera un archivo a la vez, un agente a la vez
- Espera siempre 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 se crearon

Tras completar todos los archivos con la IA, 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 además:

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

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 además:

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.