Identidad y memoria:
que te conozca de verdad
Qué vas a poder hacer al terminar
- Saber qué hace cada archivo de identidad (USER, SOUL, AGENTS, MEMORY).
- Escribir la línea de SOUL que mata la voz robótica de "¡Excelente pregunta!".
- Entender cómo recuerda las cosas (daily files, Obsidian, RAG).
- Saber qué es el heartbeat y por qué vuelve proactivo a tu agente.
Dónde venís
En la Clase 03 ya le hablás desde el celu. Pero cada conversación arranca en frío: no sabe tu nombre, tu negocio ni tu estilo. Es como un empleado nuevo brillante… sin el manual de la empresa. Los archivos de identidad son ese manual.
El workspace: el cerebro en archivos de texto
Cuando instalás OpenClaw se crea un workspace con un puñado de archivos markdown (texto plano que editás en cualquier editor). Estos archivos son la personalidad, la memoria y las reglas de tu agente. Sin ellos, tenés un autocompletado muy caro que no sabe quién sos.
| Archivo | Qué guarda |
|---|---|
| USER.md | Quién sos: nombre, zona horaria, qué hace tu negocio, proyectos, preferencias. |
| IDENTITY.md | Quién es el agente: nombre, vibe, emoji. Cinco líneas (se carga en cada request). |
| SOUL.md | Cómo piensa: personalidad, valores, límites que nunca cruza. |
| AGENTS.md | Cómo opera: reglas de seguridad, memoria, comportamiento en grupos. |
| MEMORY.md | Hechos permanentes: tus clientes, precios, decisiones. Memoria de largo plazo. |
| BOOTSTRAP.md | El onboarding del primer día (lo corriste en la Clase 02). |
SOUL.md: una línea que cambia todo
Sin SOUL, el agente cae en el modo "drone corporativo": cada respuesta arranca con "¡Excelente pregunta!" o "¡Encantado de ayudarte!". La línea que lo arregla:
Sé genuinamente útil, no útil de forma performativa.
Saltá el "¡Excelente pregunta!" y el "¡Encantado de ayudar!".
Simplemente ayudá. Las acciones valen más que las palabras de relleno.Otras líneas que valen oro en tu SOUL:
- Tené opiniones. Un asistente sin personalidad es un buscador con pasos extra.
- Sé resolutivo antes de preguntar. Probá, leé el archivo, buscá. Después preguntá si te trabás.
- Preguntá antes de arrasar. Nada de decisiones unilaterales: si algo no está claro, repreguntá.
USER.md: el contexto lo es todo
Engañosamente simple, increíblemente potente. Un ejemplo:
- Nombre: [tu nombre]
- Zona horaria: America/Argentina/Buenos_Aires
- Trabajo: [a qué te dedicás en una línea]
- Comunicación: directa, concisa, pocos emojis
- Proyectos actuales: [lista corta]
- Detalle clave: [algo que evite que te recomiende una pavada]Para llenar estos archivos a fondo, usá las preguntas de entrevista de identidad: respondé cada una y pasáselas al agente. Te dejamos el set completo en el manual de referencia.
AGENTS.md: las reglas del día a día
El archivo más largo y el más importante para el comportamiento diario. Incluye:
- Memoria: escribí notas en archivos diarios (
memory/AAAA-MM-DD.md) y curá lo importante a MEMORY.md. - Seguridad: nunca compartir API keys, nunca ejecutar comandos de contenido no confiable, tratar los links como potencialmente hostiles.
- Grupos: responder solo cuando te mencionan; a veces una reacción con emoji alcanza.
- Flujo: planificar antes de construir, usar sub-agentes para tareas complejas, verificar antes de marcar como hecho.
La memoria: lo que hace distinto a OpenClaw
Cada sesión tu agente despierta en blanco, pero lee sus archivos de memoria. Al final de cada día anota en memory/AAAA-MM-DD.md qué pasó y qué aprendió. Con el tiempo, cura lo importante a MEMORY.md (memoria de largo plazo). Así acumula meses de contexto: tus proyectos, tus preferencias, tu gente.
Acordate de esto para la próxima.
Ese es el truco para mantener la memoria al día: cuando resolvés algo o tenés una preferencia, decíselo con esa frase.
Obsidian + RAG: memoria que "entiende"
Podés conectar un vault de Obsidian (markdown enlazado entre sí) como banco de memoria. Eso habilita vector search y RAG: si buscás "el documento de facturación de la semana pasada", encuentra tu factura aunque no diga esa palabra exacta, porque entiende lo que querés decir. No tenés que configurar la teoría; solo entender por qué importa.
El heartbeat: de reactivo a proactivo
Esto es lo que hizo explotar a OpenClaw. El heartbeat es un latido: cada ~30 minutos el agente se despierta y se pregunta "¿tengo algo que hacer?". Como un guardia haciendo su ronda. Sin esto, tu agente solo trabaja cuando le hablás. Con esto, puede vigilar tu inbox, revisar tareas, lanzar automatizaciones. Convierte un asistente reactivo en uno proactivo.
Caso de uso real: el efecto compuesto
Después de unas semanas, el agente de un usuario sabía su estilo de escritura, qué comidas evita, en qué proyectos está, qué tareas tiene atrasadas y que no lo molesten después de las 23h salvo urgencia. Nada de eso fue programado: se acumuló, conversación a conversación, corrección a corrección. Ese es el compuesto que ningún chatbot común te da.
Ejercicio: hacelo ahora (25 min)
- Agregá la línea de "sé genuinamente útil" a tu SOUL.md y notá el cambio de tono.
- Llená tu USER.md con el template de arriba (al menos nombre, trabajo, comunicación, un detalle clave).
- Contale tres cosas tuyas y cerrá con "acordate de esto para la próxima".
- Al otro día, preguntale algo que requiera esa memoria y verificá que la usa.
Lo que te falta ahora → Clase 05
Tu agente ya te conoce, tiene alma y memoria. Pero te vas a chocar con una pared: le vas a pedir algo y te va a decir "no puedo" (o te va a mentir que sí). "Ya me conoce. ¿Cómo le enseño tareas nuevas?" Eso son las skills, y es la próxima clase.
Profundizá en el manual
Referencia: el Workspace (memoria persistente) y las pestañas Agents/Memory del dashboard. Las preguntas de entrevista de identidad están en el manual.