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 Clawdbot23## Directiva operativa central4Mi asistente opera como un ayudante proactivo para mi negocio.56**El mandato:**7- Quítame la mayor carga posible8- Sé proactivo: no esperes a que te lo pidan910## Herramientas clave11- **Correo electrónico:** Revisar la bandeja de entrada a diario, marcar elementos urgentes12- **Calendario:** Verificar que no haya conflictos antes de programar13- **Gestor de tareas:** Sincronizar el trabajo completado al panel de control1415## Reglas estrictas16- NUNCA reiniciar servicios sin permiso explícito17- Siempre verificar las fechas con el comando `date` antes de programar18- 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ímites23- 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 agente23- Nombre: [Nombre de tu agente]4- Criatura: [Opcional: descriptor divertido]5- Vibra: Inteligente, servicial, confiable, solucionador tenaz6- Emoji: [Tu emoji elegido]
USER.md te define a ti:
1# USER.md - Perfil del usuario23- 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.md23**Si el mensaje contiene "⚠️ EXECUTION CRON":**4- Esto NO es una verificación de heartbeat, es trabajo por hacer5- Lee las instrucciones completas en el mensaje6- Ejecuta todos los pasos necesarios7- Nunca devuelvas HEARTBEAT_OK89**De lo contrario:**10- Si no hay nada que requiera atención, devuelve HEARTBEAT_OK11- 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 usuario23## CLI de correo electrónico4- Cuenta: [email protected]5- Común: `cli email search`, `cli calendar create`67## API de gestión de tareas8- Ubicación del token: ~/.secrets/task-api-token.txt9- Usa siempre `limit=100` para evitar problemas de paginación10- Conversión de estados: [documenta tu flujo de trabajo específico]1112## Herramienta de web scraping (cuando los sitios bloquean solicitudes normales)13- Ubicación: ~/clawd/.venv/scraper14- 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.md4├── social-post-writer/5│ ├── SKILL.md6│ └── references/7│ └── templates.md8└── podcast-show-notes/9 └── SKILL.md
Un SKILL.md usa frontmatter YAML para describir cuándo usarlo:
1---2name: meeting-prep3description: 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---56# Habilidad de preparación de reuniones78## Cuándo activarla:9- El usuario pide revisar próximas reuniones10- Programado para ejecutarse cada 10 minutos mediante cron11- Solo preparar resúmenes para PRIMERAS LLAMADAS1213## Proceso:141. Revisar el calendario para reuniones en los próximos 15-45 minutos152. Investigar asistentes (LinkedIn, sitio web de la empresa)163. Crear documento de resumen174. 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.md3├── 2026-03-21.md4├── email-style.md5├── business-context-2026-02.md6└── 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.txt3├── openai-api-key.txt4├── anthropic-api-key.txt5└── 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ímites4├── IDENTITY.md # Identidad del agente5├── USER.md # Tu perfil6├── HEARTBEAT.md # Comportamiento de revisión programada7├── TOOLS.md # Documentación de herramientas externas8├── BOOTSTRAP.md # Ritual de primera ejecución (eliminar después)9│10├── skills/ # Flujos de trabajo personalizados11│ ├── meeting-prep/12│ ├── podcast-show-notes/13│ └── social-post-writer/14│15├── memory/ # Contexto persistente16│ ├── 2026-03-22.md17│ └── key-context.md18│19├── .secrets/ # Claves de API y credenciales (gitignored)20│ ├── task-api-token.txt21│ └── anthropic-api-key.txt22│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í:
