OpenClaw Soul Files: Define la personalidad de tu asistente IA

"Una IA sin alma es solo un loro sofisticado. Puede responder preguntas, pero no te conoce, no te entiende y no es realmente tuya. Hoy vamos a cambiar eso."

Objetivo de hoy

Por qué tu asistente se siente genérico ahora mismo

Pregúntale a tu asistente "what should I do today?" y responde "please provide more context."

Pídele que escriba un correo y sonará como una plantilla de atención al cliente.

Porque no te conoce. No sabe si eres desarrollador o product manager. No conoce tus proyectos actuales, tu estilo de comunicación, tu horario de trabajo ni qué significa "check the data" en tu contexto.

Cuatro archivos solucionan esto. OpenClaw los llama Soul Files:

Cómo crear estos archivos:

# Navigate to the workspace directory (create it if it doesn't exist)
mkdir -p ~/.openclaw/workspace

# Open each file in a text editor — use any editor you're comfortable with:
# Terminal (Mac/Linux): nano ~/.openclaw/workspace/SOUL.md
# VS Code: code ~/.openclaw/workspace/SOUL.md
# Or just open ~/.openclaw/workspace/ in Finder/Explorer and create new text files

Después de guardar, reinicia el servicio con openclaw gateway restart para aplicar los cambios.

Esto no es un curso completo de prompt engineering. Es el contexto operativo mínimo que convierte un asistente genérico en uno que se siente realmente tuyo.

Qué hace cada archivo

Si escribes bien estos cuatro archivos, la misma pregunta, "help me write an email", producirá algo que suene a tu voz, haga referencia a tu proyecto y encaje con tu estilo.

Cómo escribir SOUL.md

SOUL.md es el manual de personalidad de tu asistente. Hazlo específico y operativo.

Haz que la personalidad sea específica, no vaga:

• ❌ "You are a friendly assistant"
• ✅ "You speak like an experienced tech colleague - direct, pragmatic, occasionally cracking a dry joke, never sycophantic"

Define claramente los límites de comportamiento:

Definir lo que no debe hacer importa más que enumerar todo lo que sí debe hacer. Unas pocas líneas rojas claras te dan confianza real para dejarlo actuar de forma autónoma.

# Minimum SOUL.md template
## Personality
You are [assistant name], a personal AI assistant for [your name].
Direct and concise. No filler phrases like "Certainly!" or "Great question!"

## Rules
- Before sending any external message, confirm with me first.
- Keep responses under 150 words unless I ask for detail.
- If context is missing, ask one sharp question instead of many.

Plantillas Soul: referencia completa y ejemplos →

Cómo escribir USER.md

USER.md no es para otros, es para tu asistente. Cuanto más claramente te describas, más inteligente se vuelve sobre ti sin que tengas que repetir contexto.

Incluye: tu nombre, rol, proyectos actuales (por nombre), tools que usas, horario de trabajo, preferencias de comunicación y en qué estás centrado ahora mismo.

El poder oculto: Antes de USER.md, "check my traffic data" no significaba nada. Después, sabe que tienes yoursite.com, consulta datos de GSC directamente y devuelve exactamente lo que querías decir.

# Minimum USER.md template
## About Me
Name: [your name]
Role: [your role]
Current focus: [main project or priority]

## Preferences
Preferred tools: [tools you use]
Communication style: [brief, direct, detailed, etc.]

AGENTS.md e IDENTITY.md

AGENTS.md se carga al inicio de cada sesión. Contiene instrucciones operativas: reglas, prioridades, convenciones de memoria y cómo debe comportarse el asistente. OpenClaw instala un valor por defecto razonable; sobre todo tendrás que ajustarlo cuando quieras instrucciones más precisas, prioridades más claras o mayor consistencia entre sesiones.

IDENTITY.md es nuevo (se añadió después de que se escribiera la guía original de 7 días). Define el modelo de identidad del asistente: qué tipo de asistente es, para qué sirve y qué representa. Piensa en ello como una misión que da coherencia a los otros tres archivos.

# Minimum AGENTS.md template
## Priorities
- Protect my time and attention.
- Prefer direct, practical answers over long theory.
- Ask for confirmation before taking external actions.

## Memory Conventions
- Treat `USER.md` as the source of truth about me and my current work.
- Keep advice consistent with `SOUL.md` and `IDENTITY.md`.

## Behavior Rules
- Do not send messages, publish content, or make purchases without approval.
- If context is missing, ask one precise question instead of several broad ones.

# Minimum IDENTITY.md template
## Identity
Your name is [assistant name].
You are my long-term AI collaborator, not a generic chatbot.

## Mission
Help me think clearly, move faster, and protect my attention.
Stay consistent with my rules, context, and priorities.

comandos de configuración de openclaw →

Antes y después

El punto de estos archivos no es la teoría. El punto es un cambio visible en el comportamiento.

Antes de SOUL.md: Genérico, demasiado formal, sin contexto

"Hello. I'd be happy to help. Could you please provide more details about your current work and goals?"

Después de SOUL.md: Usa tu nombre, encaja con tu contexto de trabajo y respeta tus reglas

"You’re focused on [project]. I’d start with the traffic drop you mentioned yesterday. I can outline the next three checks, but I won’t message anyone unless you say so."

Después de escribir: reinicia y nota la diferencia

openclaw gateway restart

Luego haz la misma pregunta que hiciste el Día 2. Mismo modelo de IA. Distintos Soul Files. Fíjate en cómo suena y en cuánto menos pide aclaraciones.

Prueba: pregúntale a tu asistente "Who am I and what am I working on right now?" Si responde usando detalles de USER.md, tus Soul Files se están cargando correctamente.

Un alma se cultiva, no se instala

Tu primer SOUL.md será imperfecto. No pasa nada. El patrón real es este:

• Semana 1: escribir una versión básica, suficiente para empezar
• Semana 2: cada vez que pienses "debería haberlo hecho de otra forma", actualiza el archivo correspondiente
• Mes 1: los archivos se estabilizan y el rendimiento se alinea cada vez más con tus expectativas

Cada punto de fricción es una señal de qué debes añadir o aclarar. Con el tiempo, los Soul Files se convierten en una especificación precisa de cómo piensas y trabajas.

Tu asistente mejora cuanto más tiempo lo usas, no porque el modelo sea más inteligente, sino porque el contexto con el que empieza cada conversación es más rico.

Problemas comunes

Los Soul Files no se cargan después de reiniciar

Reinicia el servicio con openclaw gateway restart y asegúrate de haber editado los archivos que OpenClaw realmente lee, no copias en otra carpeta.

Ubicación de archivo incorrecta

Comprueba que los archivos están exactamente en ~/.openclaw/workspace/. Un archivo correcto en la ruta equivocada se comporta igual que no tener archivo.

El asistente ignora reglas en SOUL.md

Haz la regla más corta y más concreta. "Ten cuidado" es débil. "Pregunta antes de enviar mensajes externos" sí es aplicable.