El complemento OpenClaw-Mem0 agrega memoria persistente fuera de la ventana de contexto.

El complemento openclaw-mem0 aborda las limitaciones de memoria predeterminadas de OpenClaw almacenando recuerdos fuera de la ventana de contexto, haciéndolos inmunes a la compactación de contexto, límites de tokens y reinicios de sesión.

El problema de la memoria en OpenClaw

Los agentes de OpenClaw no tienen estado entre sesiones, con la memoria predeterminada almacenada en archivos que deben cargarse explícitamente. La compactación de contexto resume el contexto anterior para ahorrar tokens, haciendo que la memoria inyectada se vuelva con pérdidas: archivos de memoria grandes y hechos aprendidos se comprimen, reescriben o eliminan sin advertencia.

Las soluciones alternativas de la comunidad, como archivos MEMORY.md exhaustivos, motores de búsqueda locales BM25 + vectoriales y registros de sesión respaldados por SQLite, comparten la misma limitación: almacenan la memoria dentro de la ventana de contexto, haciéndolos vulnerables a la compactación o reinicios de sesión.

Cómo funciona el complemento

El complemento ejecuta dos procesos en cada turno de conversación:

• Recuperación automática: Busca en Mem0 recuerdos relevantes antes de que el agente responda, inyectando contexto coincidente (preferencias, decisiones pasadas, detalles del proyecto) en el contexto de trabajo en cada turno
• Captura automática: Envía cada intercambio a Mem0 después de que el agente responde, con la capa de extracción de Mem0 determinando qué vale la pena conservar: los hechos nuevos se almacenan, los obsoletos se actualizan, los duplicados se fusionan

Ambos procesos están habilitados por defecto al instalar.

Estructura de la memoria

El complemento separa la memoria en dos ámbitos:

• Recuerdos a largo plazo: De ámbito de usuario, persisten en todas las sesiones (nombre, pila tecnológica, estructura del proyecto, decisiones)
• Recuerdos a corto plazo: De ámbito de sesión, rastrean el trabajo activo sin contaminar el almacén a largo plazo

Ambos ámbitos se buscan durante cada recuperación, mostrándose primero los recuerdos a largo plazo.

El agente obtiene cinco herramientas para la gestión explícita de memoria:

• memory_search - consultas semánticas en todos los recuerdos
• memory_store - guardar explícitamente un hecho específico
• memory_list - ver todos los recuerdos almacenados
• memory_get - recuperar un recuerdo específico por ID
• memory_forget - eliminar recuerdos (cumple con GDPR)

Opciones de configuración

Configuración en la nube (más fácil):

openclaw plugins install @mem0/openclaw-mem0

Obtén una clave API desde app.mem0.ai, luego agrega a openclaw.json:

{
  "openclaw-mem0": {
    "enabled": true,
    "config": {
      "apiKey": "${MEM0_API_KEY}",
      "userId": "your-user-id"
    }
  }
}

Completamente local, completamente privado (autoalojado):

Establece "mode": "open-source" y trae tu propia pila:

{
  "openclaw-mem0": {
    "enabled": true,
    "config": {
      "mode": "open-source",
      "userId": "your-user-id",
      "oss": {
        "embedder": {
          "provider": "ollama",
          "config": {
            "model": "nomic-embed-text"
          }
        },
        "vectorStore": {
          "provider": "qdrant",
          "config": {
            "host": "localhost",
            "port": 6333
          }
        }
      }
    }
  }
}