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. Almacena tu identidad, habilidades personalizadas, conexiones de canales y memoria. Una vez que entiendas qué va dónde, podrás configurar OpenClaw exactamente como lo necesitas.
Esta guía recorre la anatomía de una configuración perfecta.
PD: Openclaw es solo el comienzo.
Dentro de nuestra comunidad Build With AI, te enseñaremos a construir agentes, aplicaciones y automatizaciones personalizadas que puedas 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 tu carpeta de espacio de trabajo (normalmente ~/clawd/ o donde lo hayas inicializado). Aquí se almacena 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). Contiene la documentación principal, 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 operativas
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á cada vez.
Qué poner 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 gestión de tareas)
- Reglas estrictas que nunca deben romperse
- Enlaces a recursos importantes (documentación de API, ubicaciones de habilidades)
- Desencadenantes de flujo de trabajo (qué debe suceder automáticamente)
No escribas:
- Documentación completa a la que puedas enlazar
- 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 principal4Mi asistente opera como un ayudante proactivo para mi negocio.56**El mandato:**7- Quitarme todo lo posible de encima8- Ser proactivo – no esperar a que le pidan910## Herramientas clave11- **Correo:** Revisar la bandeja de entrada a diario, marcar elementos urgentes12- **Calendario:** Verificar que no haya conflictos antes de agendar13- **Gestor de tareas:** Sincronizar el trabajo completado al panel de control1415## Reglas estrictas16- NUNCA reiniciar servicios sin permiso explícito17- Siempre verificar fechas con el comando `date` antes de agendar18- Registrar todo el trabajo completado en el sistema de seguimiento
Eso son ~20 líneas de directivas principales. 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/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 personajes extensos aquí. 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 de usuario23- Nombre: [Tu nombre]4- Dirección preferida: [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 sirven propósitos diferentes. IDENTITY.md rara vez cambia una vez configurado. USER.md se actualiza a medida que evolucionan tus preferencias. Mantenerlos separados facilita el mantenimiento.
HEARTBEAT.md: Revisiones programadas
Este archivo controla lo que tu agente hace durante los sondeos de heartbeat (momentos programados en los que el sistema verifica si algo 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 requeridos7- Nunca devuelvas HEARTBEAT_OK89**De lo contrario:**10- Si nada necesita atención, devuelve HEARTBEAT_OK11- Mantenlo mínimo
Los heartbeats son poderosos para crear agentes proactivos. Tu agente puede revisar tu calendario, escanear tu bandeja de entrada o ejecutar cualquier flujo de trabajo automatizado en un horario, todo activado por sondeos 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), sino que es donde documentas CÓMO las usas tú.
1# TOOLS.md - Notas de herramientas del usuario23## CLI de correo4- 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- Siempre usa `limit=100` para evitar problemas de paginación10- Conversión de estados: [documenta tu flujo de trabajo específico]1112## Herramienta de scraping web (cuando los sitios bloquean solicitudes normales)13- Ubicación: ~/clawd/.venv/scraper14- Usa modo sigiloso para sitios protegidos
Esta se convierte en tu guía de referencia personal. Cuando tu agente necesite usar una herramienta, consultará TOOLS.md para conocer tus convenciones específicas.
La carpeta skills/: Flujos de trabajo reutilizables
Las habilidades son donde OpenClaw se vuelve potente. 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 y resumen automatizado antes de una llamada. Úsalo cuando el usuario pida revisar próximas reuniones o preparar una reunión.4---56# Habilidad de preparación de reuniones78## Cuándo activarla:9- El usuario pide revisar próximas reuniones10- Programada para ejecutarse cada 10 minutos mediante cron11- Solo prepara para PRIMERAS LLAMADAS1213## Proceso:141. Revisar el calendario en busca de 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 agrupar 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 contexto a tu agente entre sesiones. Sin ellos, cada conversación empieza desde cero.
La carpeta .secrets/: Credenciales
Aquí viven los tokens de API, contraseñas y configuración sensible. Esta carpeta debe estar en gitignore y nunca ser comprometida.
1.secrets/2├── task-api-token.txt3├── openai-api-key.txt4├── anthropic-api-key.txt5└── service-credentials.txt
Tus AGENTS.md o TOOLS.md pueden referenciar 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 de canales reside en tu configuración de gateway (gestionada mediante comandos 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 operativas (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 API y credenciales (gitignorados)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í tienes 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 añade AGENTS.md con tus directivas principales. Empieza con 10-20 líneas cubriendo tus casos de uso principales.
Paso 3. Añade 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 repitas a menudo. La preparación de reuniones, borradores de correos o creación de contenido son buenos puntos de partida.
Paso 5. Configura memory/ con una plantilla de registro diario. Tu agente empezará a construir contexto con el tiempo.
Paso 6. Añade TOOLS.md a medida que descubras patrones específicos de herramientas que valga la pena documentar.
Eso es realmente todo lo que necesitas para el 95% de los casos de uso. Funciones avanzadas como trabajos cron, configuraciones multiagente y plugins de canales personalizados llegan cuando tengas flujos de trabajo específicos que valga 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 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 rinde dividendos 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é a construir agentes, aplicaciones y automatizaciones personalizadas que puedas usar tú mismo o vender a clientes. Próximamente.
Únete a la lista de espera aquí:
