Cómo funciona realmente la memoria de OpenCLAW

Los agentes de OpenCLAW no tienen memoria persistente entre conversaciones. Cada vez que envías un mensaje, el agente lee varios archivos (SOUL.md, USER.md, MEMORY.md y el historial de sesiones recientes) y construye su "memoria" desde cero. No está recordando, está leyendo sus notas.

Cinco razones por las que tu agente olvida cosas

Razón 1: Tu sesión es demasiado antigua

Cada mensaje de tu sesión actual se incluye en cada nueva llamada a la API. Después de 2-3 semanas, esto se convierte en miles de tokens. El modelo alcanza su límite de contexto (lo que provoca que las conversaciones tempranas se trunquen silenciosamente) o OpenCLAW ejecuta compactación, que resume todo pero pierde detalles.

Solución: Usa /new regularmente, al menos diariamente y antes de cualquier tarea importante. Esto limpia el búfer de conversación mientras mantiene todos los archivos intactos.

Razón 2: La información importante está en el historial de chat, no en los archivos

Si le dijiste algo a tu agente en una conversación hace 3 semanas, esa información vive en el historial de sesión, que se trunca. Cualquier cosa que tu agente DEBERÍA saber SIEMPRE debe estar en un archivo, no en el chat.

Solución: Pon la información permanente en USER.md:

# Sobre mí
- Nombre: [tu nombre]
- Pareja: [nombre]
- Ubicación: [ciudad]
- Trabajo: [rol]
- Zona horaria: [zona horaria]

Preferencias

Comunicación: directa, sin relleno
Rutina matutina: resumen a las 8am
Nunca programes reuniones antes de las 10am
Pedido de café: [lo que sea, en serio]

Razón 3: MEMORY.md es un lío inflado

La mayoría de la gente nunca estructura MEMORY.md. Después de un mes, se convierte en una gran pared de texto que el modelo hojea en lugar de leer. Los hechos importantes quedan enterrados bajo detalles irrelevantes.

Solución: Estructura tu MEMORY.md en secciones claras:

# Personas
- Sarah (esposa): trabaja en [empresa], cumpleaños 12 de junio
- Mike (compañero de trabajo): maneja el frontend, prefiere Slack sobre correo

Proyectos Activos

Renovación de cocina: el contratista es Dave, presupuesto $15K, comienza en abril
Presentación Q2: vence el 28 de marzo, necesita datos de ventas de Mike

Decisiones Tomadas

Cambié de opus a sonnet el 5 de marzo (razones de costo)
Usando la API de búsqueda de Brave en lugar de Google (nivel gratuito suficiente)

Tareas Recurrentes

Resumen diario a las 8am (calendario + correo + clima)
Lista de compras semanal cada domingo a las 6pm

Razón 4: No tienes una rutina de mantenimiento de memoria

Los archivos de memoria crecen para siempre. Después de 2 meses, tu MEMORY.md tiene 300 líneas y la mitad están desactualizadas o son irrelevantes. El modelo desperdicia tokens leyendo sobre proyectos terminados.

Solución: Configura un cron de memoria nocturno. Añade esto a las instrucciones de tu agente:

cada noche a las 11pm:
1. revisa las conversaciones de hoy
2. extrae cualquier hecho, decisión o compromiso nuevo
3. añádelos a la sección correcta en MEMORY.md
4. elimina cualquier cosa que ya no sea relevante
5. inicia una sesión nueva

Razón 5: Confundes la memoria de sesión con la memoria a largo plazo

Comprende la jerarquía:

• SOUL.md: Identidad y personalidad. Se carga cada vez. Nunca cambia a menos que tú lo cambies.
• USER.md: Hechos sobre ti. Se carga cada vez. Actualízalo cuando tu vida cambie.
• MEMORY.md: Contexto en curso. Se carga cada vez. Crece y se poda.