Anatomía de una configuración perfecta de Openclaw

Una guía completa sobre los archivos del espacio de trabajo, habilidades, canales, permisos y cómo configurarlos correctamente.

La mayoría de los usuarios de OpenClaw lo instalan, conectan un canal y nunca abren la carpeta del espacio de trabajo.

Esto es un error.

Tu espacio de trabajo es el centro de control de cómo se comporta tu asistente de IA. Contiene tu identidad, habilidades personalizadas, conexiones de canales y memoria. Una vez que entiendes qué va dónde, puedes configurar OpenClaw exactamente como lo necesitas.

Esta guía explora la anatomía de una configuración perfecta.

PD: OpenClaw es solo el comienzo.

Dentro de nuestra comunidad Build With AI, te enseñaremos cómo crear agentes, aplicaciones y automatizaciones personalizadas que puedes usar tú mismo o vender a clientes. Próximamente.

Únete a la lista de espera aquí: https://return-my-time.kit.com/1bd2720397

-----------------------------------------

Dos capas de configuración, no una

Antes de profundizar, algo que vale la pena saber de antemano: OpenClaw utiliza dos capas de configuración.

La primera es la carpeta de tu espacio de trabajo (normalmente ~/clawd/ o donde lo hayas inicializado). Aquí se almacenan tu configuración personal, habilidades, memoria y secretos.

La segunda es la instalación global en opt/homebrew/lib/node_modules/clawdbot/ (o su equivalente en tu sistema). Esta contiene los documentos centrales, las habilidades integradas y los comportamientos predeterminados.

Tu espacio de trabajo es donde personalizas. La instalación global es lo que actualizas.

AGENTS.md: Tus instrucciones de operación

Este es el archivo más importante de toda tu configuración. Cuando OpenClaw inicia una sesión, lo primero que lee es AGENTS.md. Lo carga directamente en el prompt del sistema y lo mantiene presente durante toda la conversación.

En pocas palabras: cualquier cosa que escribas en AGENTS.md, tu agente la seguirá.

Si le dices que siempre revise tu calendario antes de sugerir horarios de reuniones, lo hará. Si dices "nunca envíes correos sin mi aprobación explícita", lo respetará siempre.

¿Qué va realmente en `AGENTS.md`?

Escribe:

• Tu directiva operativa principal (¿cuál es el trabajo del agente?)
• Herramientas clave y cómo usarlas (CLI de correo, flujos de trabajo de gestión de tareas)
• Reglas estrictas que nunca deben romperse
• Enlaces a recursos importantes (documentación de API, ubicaciones de habilidades)
• Activadores de flujos de trabajo (qué debería suceder automáticamente)

No escribas:

• Documentación completa a la que puedas enlazar en su lugar
• Párrafos largos explicando teoría
• Información que cambia con frecuencia

Mantén AGENTS.md por debajo de 300 líneas. Los archivos más largos empiezan a consumir demasiado contexto y la adherencia a las instrucciones disminuye.

Aquí tienes un ejemplo mínimo pero efectivo:

1# AGENTS.md - Espacio de trabajo de Clawdbot
2
3## Directiva operativa central
4Mi asistente opera como un ayudante proactivo para mi negocio.
5
6**El mandato:**
7- Quítame la mayor carga posible
8- Sé proactivo: no esperes a que te lo pidan
9
10## Herramientas clave
11- **Correo electrónico:** Revisar la bandeja de entrada a diario, marcar elementos urgentes
12- **Calendario:** Verificar que no haya conflictos antes de programar
13- **Gestor de tareas:** Sincronizar el trabajo completado al panel de control
14
15## Reglas estrictas
16- NUNCA reiniciar servicios sin permiso explícito
17- Siempre verificar las fechas con el comando `date` antes de programar
18- Registrar todo el trabajo completado en el sistema de seguimiento

Eso son unas 20 líneas de directivas centrales. Le da a tu agente todo lo que necesita para trabajar de manera productiva sin aclaraciones constantes.

SOUL.md: Personalidad y límites

SOUL.md define quién es tu agente y cómo debe comunicarse. Aquí es donde vive la personalidad.

1# SOUL.md - Personalidad y límites
2
3- Mantén las respuestas concisas y directas.
4- Haz preguntas aclaratorias cuando sea necesario.
5- Nunca envíes respuestas en streaming o parciales a superficies de mensajería externas.

Si AGENTS.md es el manual de instrucciones, SOUL.md es el perfil de personalidad. Algunos usuarios escriben aquí personajes extensos. Otros lo mantienen mínimo. Ambos funcionan, depende de cuánta personalización de personalidad quieras.

IDENTITY.md y USER.md: Quién es quién

Estos dos archivos establecen la relación entre tu agente y tú.

IDENTITY.md define a tu agente:

1# IDENTITY.md - Identidad del agente
2
3- Nombre: [Nombre de tu agente]
4- Criatura: [Opcional: descriptor divertido]
5- Vibra: Inteligente, servicial, confiable, solucionador tenaz
6- Emoji: [Tu emoji elegido]

USER.md te define a ti:

1# USER.md - Perfil del usuario
2
3- Nombre: [Tu nombre]
4- Trato preferido: [Apodo]
5- Zona horaria: [Tu zona horaria]
6- Teléfono: [Tu número]
7- Calendario: [Plataforma de calendario y correo electrónico]

¿Por qué archivos separados? Porque cumplen diferentes propósitos. IDENTITY.md rara vez cambia una vez configurado. USER.md se actualiza a medida que tus preferencias evolucionan. Mantenerlos separados facilita el mantenimiento.

HEARTBEAT.md: Revisiones programadas

Este archivo controla lo que tu agente hace durante las sondas de heartbeat (latido): momentos programados en los que el sistema verifica si necesita atención.

1# HEARTBEAT.md
2
3**Si el mensaje contiene "⚠️ EXECUTION CRON":**
4- Esto NO es una verificación de heartbeat, es trabajo por hacer
5- Lee las instrucciones completas en el mensaje
6- Ejecuta todos los pasos necesarios
7- Nunca devuelvas HEARTBEAT_OK
8
9**De lo contrario:**
10- Si no hay nada que requiera atención, devuelve HEARTBEAT_OK
11- Mantenlo mínimo

Los heartbeats son potentes para crear agentes proactivos. Tu agente puede revisar tu calendario, escanear tu bandeja de entrada o ejecutar cualquier flujo de trabajo automatizado según un horario, todo activado por sondas de heartbeat.

TOOLS.md: Documentación de herramientas externas

Este archivo contiene tus notas sobre herramientas externas y convenciones. No define qué herramientas existen (OpenClaw maneja eso internamente), pero es donde documentas CÓMO las usas TÚ.

1# TOOLS.md - Notas de herramientas del usuario
2
3## CLI de correo electrónico
4- Cuenta: [email protected]
5- Común: `cli email search`, `cli calendar create`
6
7## API de gestión de tareas
8- Ubicación del token: ~/.secrets/task-api-token.txt
9- Usa siempre `limit=100` para evitar problemas de paginación
10- Conversión de estados: [documenta tu flujo de trabajo específico]
11
12## Herramienta de web scraping (cuando los sitios bloquean solicitudes normales)
13- Ubicación: ~/clawd/.venv/scraper
14- Usa modo sigiloso para sitios protegidos

Esto se convierte en tu guía de referencia personal. Cuando tu agente necesita usar una herramienta, consulta TOOLS.md para conocer tus convenciones específicas.

La carpeta skills/: Flujos de trabajo reutilizables

Las habilidades (skills) son donde OpenClaw se vuelve poderoso. Cada habilidad es un flujo de trabajo autocontenido que tu agente puede invocar cuando la tarea coincide con la descripción de la habilidad.

Cada habilidad vive en su propio subdirectorio con un archivo SKILL.md:

1skills/
2├── meeting-prep/
3│   └── SKILL.md
4├── social-post-writer/
5│   ├── SKILL.md
6│   └── references/
7│       └── templates.md
8└── podcast-show-notes/
9    └── SKILL.md

Un SKILL.md usa frontmatter YAML para describir cuándo usarlo:

1---
2name: meeting-prep
3description: Investigación automatizada previa a la llamada y resumen. Usar cuando el usuario pida revisar próximas reuniones o ejecutar preparación de reuniones.
4---
5
6# Habilidad de preparación de reuniones
7
8## Cuándo activarla:
9- El usuario pide revisar próximas reuniones
10- Programado para ejecutarse cada 10 minutos mediante cron
11- Solo preparar resúmenes para PRIMERAS LLAMADAS
12
13## Proceso:
141. Revisar el calendario para reuniones en los próximos 15-45 minutos
152. Investigar asistentes (LinkedIn, sitio web de la empresa)
163. Crear documento de resumen
174. Adjuntar enlace al evento del calendario

La diferencia clave con las instrucciones estáticas: las habilidades pueden incluir archivos de soporte junto a ellas. El archivo references/templates.md puede contener ejemplos de salida, formatos probados o contexto adicional que solo se carga cuando la habilidad está activa.

La carpeta memory/: Contexto persistente

Esta es la memoria a largo plazo de tu agente. Las transcripciones de sesiones, las preferencias aprendidas y los registros diarios viven aquí.

1memory/
2├── 2026-03-22.md
3├── 2026-03-21.md
4├── email-style.md
5├── business-context-2026-02.md
6└── workflow-playbook.md

Buenas prácticas:

• Mantén registros diarios en memory/YYYY-MM-DD.md
• Al iniciar sesión, tu agente lee hoy + ayer si están presentes
• Captura hechos duraderos, preferencias y decisiones
• Evita almacenar secretos

Los archivos de memoria son lo que le da a tu agente contexto entre sesiones. Sin ellos, cada conversación comienza desde cero.

La carpeta .secrets/: Credenciales

Los tokens de API, contraseñas y configuraciones sensibles viven aquí. Esta carpeta debe estar en .gitignore y nunca debe enviarse al repositorio.

1.secrets/
2├── task-api-token.txt
3├── openai-api-key.txt
4├── anthropic-api-key.txt
5└── service-credentials.txt

Tu AGENTS.md o TOOLS.md pueden hacer referencia a estas rutas sin exponer los valores reales.

Configuración de canales: Dónde hablas con tu agente

OpenClaw admite múltiples canales de mensajería: Discord, Telegram, Signal, WhatsApp y más. La configuración del canal está en tu configuración de gateway (gestionada mediante comandos de clawdbot gateway).

Conceptos clave:

• Cada canal tiene su propio comportamiento de sesión
• Puedes tener múltiples canales activos simultáneamente
• Las reglas específicas del canal (como "no responder a menos que te @mencionen en Discord") van en AGENTS.md

El panorama completo

Así es como todo se une:

1~/clawd/
2├── AGENTS.md           # Instrucciones de operación (uso diario)
3├── SOUL.md             # Personalidad y límites
4├── IDENTITY.md         # Identidad del agente
5├── USER.md             # Tu perfil
6├── HEARTBEAT.md        # Comportamiento de revisión programada
7├── TOOLS.md            # Documentación de herramientas externas
8├── BOOTSTRAP.md        # Ritual de primera ejecución (eliminar después)
9│
10├── skills/             # Flujos de trabajo personalizados
11│   ├── meeting-prep/
12│   ├── podcast-show-notes/
13│   └── social-post-writer/
14│
15├── memory/             # Contexto persistente
16│   ├── 2026-03-22.md
17│   └── key-context.md
18│
19├── .secrets/           # Claves de API y credenciales (gitignored)
20│   ├── task-api-token.txt
21│   └── anthropic-api-key.txt
22│
23└── output/             # Archivos generados y exportaciones

Una configuración práctica para empezar

Si estás empezando desde cero, aquí hay una progresión que funciona bien.

Paso 1. Ejecuta openclaw onboard y completa la configuración inicial. Elige tu proveedor de modelo y conecta al menos un canal.

Paso 2. Crea tu carpeta de espacio de trabajo y agrega AGENTS.md con tus directivas centrales. Comienza con 10-20 líneas que cubran tus casos de uso principales.

Paso 3. Agrega IDENTITY.md, USER.md y SOUL.md. Estos establecen la relación y la personalidad.

Paso 4. Crea tu primera habilidad para un flujo de trabajo que realices repetidamente. La preparación de reuniones, borradores de correos electrónicos o la creación de contenido son buenos puntos de partida.

Paso 5. Configura memory/ con una plantilla de registro diario. Tu agente comenzará a construir contexto con el tiempo.

Paso 6. Agrega TOOLS.md a medida que descubras patrones específicos de herramientas que vale la pena documentar.

Eso es genuinamente todo lo que necesitas para el 95% de los casos de uso. Las funciones avanzadas como trabajos cron, configuraciones multiagente y complementos de canal personalizados llegan cuando tienes flujos de trabajo específicos que vale la pena automatizar.

La clave

Tu espacio de trabajo de OpenClaw es en realidad un protocolo para decirle a tu asistente de IA quién eres, qué necesitas que se haga y qué reglas debe seguir. Cuanto más claramente definas eso, menos tiempo pasarás corrigiendo a tu agente y más tiempo pasará haciendo trabajo útil.

AGENTS.md es tu archivo de mayor apalancamiento. Hazlo bien primero. Todo lo demás es optimización.

Empieza pequeño, refina sobre la marcha y trátalo como cualquier otra pieza de infraestructura en tu flujo de trabajo: algo que da frutos todos los días una vez que está configurado correctamente.

PD: OpenClaw es solo el comienzo.

Dentro de nuestra comunidad Build With AI, te enseñaré cómo crear agentes, aplicaciones y automatizaciones personalizadas que puedes usar tú mismo o vender a clientes. Próximamente.

Únete a la lista de espera aquí:

https://return-my-time.kit.com/1bd2720397