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 reciente de la sesión) y construye su "memoria" desde cero. No está recordando, está leyendo sus notas.

Por qué tu agente olvida cosas

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

Cada mensaje en 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 (las conversaciones antiguas se truncan 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 8 a. m.
Nunca programar reuniones antes de las 10 a. m.
Pedido de café: [lo que sea, en serio]

Este archivo se carga en cada sesión y nunca se trunca ni compacta.

Razón 3: MEMORY.md es un desastre inflado

La mayoría de la gente nunca estructura MEMORY.md, así que después de un mes se convierte en un muro gigante 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 el 12 de junio
Mike (compañero de trabajo): maneja el frontend, prefiere Slack sobre el 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

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

Tareas recurrentes

Resumen diario a las 8 a. m. (calendario + correo + clima)
Lista de compras semanal todos los domingos a las 6 p. m.

La memoria organizada se recupera con precisión. El agente lee texto estructurado mejor que un muro de párrafos.

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

Los archivos de memoria crecen para siempre sin limpieza. Después de 2 meses, MEMORY.md tiene 300 líneas, la mitad obsoletas o irrelevantes, desperdiciando tokens en proyectos terminados.

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

todas las noches a las 11 p. m.:


revisar las conversaciones de hoy
extraer cualquier hecho, decisión o compromiso nuevo
agregarlos a la sección correcta en MEMORY.md
eliminar cualquier cosa que ya no sea relevante
iniciar 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 lo cambies.
• USER.md: Hechos sobre ti. Se carga cada vez. Actualiza cuando tu vida cambie.
• MEMORY.md: Contexto en curso. Se carga cada vez. Crece y se poda.