Resumen de la memoria

OpenClaw recuerda cosas escribiendo archivos Markdown sin formato en el espacio de trabajo de su agente. El modelo solo “recuerda” lo que se guarda en el disco; no hay ningún estado oculto.

Cómo funciona

Su agente tiene tres archivos relacionados con la memoria:

MEMORY.md — memoria a largo plazo. Hechos duraderos, preferencias y decisiones. Se carga al inicio de cada sesión de DM.
memory/YYYY-MM-DD.md (o memory/YYYY-MM-DD-<slug>.md) — notas diarias. Contexto de ejecución y observaciones. Las notas de hoy y de ayer se cargan automáticamente, y las variantes con slugs, como las escritas por el hook de memoria de sesión incluido en /new o /reset, ahora se recogen junto con el archivo de solo fecha.
DREAMS.md (opcional) — Diario de sueños y resúmenes del barrido de sueños para revisión humana, incluidas entradas de relleno histórico fundamentadas.

Estos archivos residen en el espacio de trabajo del agente (por defecto ~/.openclaw/workspace).

Qué va dónde

MEMORY.md es la capa compacta y curada. Úselo para hechos duraderos, preferencias, decisiones permanentes y resúmenes breves que deben estar disponibles al inicio de una sesión privada principal. No está destinado a ser una transcripción cruda, un registro diario o un archivo exhaustivo.

Los archivos memory/YYYY-MM-DD.md son la capa de trabajo. Úselos para notas diarias detalladas, observaciones, resúmenes de sesión y contexto sin procesar que aún puede ser útil más adelante. Estos archivos están indexados para memory_search y memory_get, pero no se inyectan en el prompt de arranque normal en cada turno.

Con el tiempo, se espera que el agente destile material útil de las notas diarias en MEMORY.md y elimine entradas a largo plazo obsoletas. Las instrucciones generadas del espacio de trabajo y el flujo de latido pueden hacerlo periódicamente; no necesita editar manualmente MEMORY.md para cada detalle recordado.

Si MEMORY.md crece más allá del presupuesto del archivo de arranque, OpenClaw mantiene el archivo en disco intacto pero trunca la copia inyectada en el contexto del modelo. Trátelo como una señal para mover el material detallado de vuelta a memory/*.md, mantener solo el resumen duradero en MEMORY.md, o aumentar los límites de arranque si explícitamente desea gastar más presupuesto de prompt. Use /context list, /context detail o openclaw doctor para ver tamaños crudos frente a inyectados y el estado de truncamiento.

Compromisos inferidos

Algunos seguimientos futuros no son hechos duraderos. Si mencionas una entrevista mañana, el recuerdo útil puede ser “hacer un seguimiento después de la entrevista”, no “guardar esto para siempre en MEMORY.md”.

Compromisos son recuerdos de seguimiento optativos y a corto plazo para ese caso. OpenClaw los infiere en un proceso en segundo plano oculto, los limita al mismo agente y canal, y entrega los seguimientos vencidos a través de latidos. Los recordatorios explícitos todavía usan tareas programadas.

Herramientas de memoria

El agente tiene dos herramientas para trabajar con la memoria:

memory_search — encuentra notas relevantes utilizando búsqueda semántica, incluso cuando la redacción difiere de la original.
memory_get — lee un archivo de memoria específico o un rango de líneas.

Ambas herramientas son proporcionadas por el plugin de memoria activo (predeterminado: memory-core).

Plugin complementario Memory Wiki

Si quieres que la memoria duradera se comporte más como una base de conocimiento mantenida que simplemente notas crudas, usa el plugin incluido memory-wiki.

memory-wiki compila el conocimiento duradero en una bóveda wiki con:

estructura de página determinista
reclamaciones y evidencias estructuradas
seguimiento de contradicciones y vigencia
paneles generados
resúmenes compilados para consumidores de agentes/tiempo de ejecución
herramientas nativas de wiki como wiki_search, wiki_get, wiki_apply y wiki_lint

No reemplaza al plugin de memoria activo. El plugin de memoria activo todavía se encarga del recuerdo, la promoción y la ensoñación. memory-wiki añade una capa de conocimiento rica en procedencia junto a él.

Consulta Memory Wiki.

Búsqueda de memoria

Cuando se configura un proveedor de incrustaciones, memory_search utiliza búsqueda híbrida — combinando similitud vectorial (significado semántico) con coincidencia de palabras clave (términos exactos como IDs y símbolos de código). Esto funciona directamente una vez que tienes una clave API para cualquier proveedor compatible.

Para obtener detalles sobre cómo funciona la búsqueda, las opciones de ajuste y la configuración del proveedor, consulta Memory Search.

Backends de memoria

Integrado (predeterminado)

Basado en SQLite. Funciona de inmediato con búsqueda de palabras clave, similitud vectorial y búsqueda híbrida. Sin dependencias adicionales.

QMD

Sidecar con prioridad local con reranking, expansión de consultas y la capacidad de indexar directorios fuera del espacio de trabajo.

Honcho

Memoria nativa de IA multi-sesión con modelado de usuario, búsqueda semántica y conciencia multi-agente. Instalación de complemento.

LanceDB

Memoria con respaldo de LanceDB incluida con incrustaciones compatibles con OpenAI, recuerdo automático, captura automática y soporte de incrustación local de Ollama.

Capa de wiki de conocimiento

Memory Wiki

Compila la memoria duradera en una bóveda wiki rica en procedencia con reclamos, paneles, modo puente y flujos de trabajo compatibles con Obsidian.

Vaciamiento automático de memoria

Antes de que la compactación resuma tu conversación, OpenClaw ejecuta un turno silencioso que recuerda al agente guardar el contexto importante en archivos de memoria. Esto está activado de forma predeterminada: no necesitas configurar nada.

Para mantener ese turno de mantenimiento en un modelo local, establezca una anulación exacta del modelo de vaciado de memoria:

{
  "agents": {
    "defaults": {
      "compaction": {
        "memoryFlush": {
          "model": "ollama/qwen3:8b"
        }
      }
    }
  }
}

La anulación solo se aplica al turno de vaciado de memoria y no hereda la cadena de reserva de la sesión activa.

Soñando (Dreaming)

Soñar es un pase opcional de consolidación en segundo plano para la memoria. Recopila señales a corto plazo, puntúa los candidatos y promueve solo los elementos calificados a la memoria a largo plazo (MEMORY.md).

Está diseñado para mantener la memoria a largo plazo con alta señal:

Optativo: deshabilitado por defecto.
Programado: cuando está habilitado, memory-core gestiona automáticamente un trabajo cron recurrente para un barrido completo de sueño.
Con umbral: las promociones deben superar las puertas de puntuación, frecuencia de recuperación y diversidad de consultas.
Revisable: los resúmenes de fase y las entradas del diario se escriben en DREAMS.md para su revisión humana.

Para el comportamiento de las fases, las señales de puntuación y los detalles del Diario de Sueños, consulte Soñar.

Relleno fundamentado y promoción en vivo

El sistema de soñado (dreaming) ahora tiene dos carriles de revisión estrechamente relacionados:

Soñar en vivo funciona desde el almacén de sueños a corto plazo en memory/.dreams/ y es lo que la fase profunda normal utiliza al decidir qué puede graduarse a MEMORY.md.
Retroalimentación fundamentada lee las notas históricas de memory/YYYY-MM-DD.md como archivos de día independientes y escribe una salida de revisión estructurada en DREAMS.md.

La retroalimentación fundamentada es útil cuando desea reproducir notas antiguas e inspeccionar lo que el sistema considera duradero sin editar manualmente MEMORY.md.

Cuando usa:

openclaw memory rem-backfill --path ./memory --stage-short-term

los candidatos duraderos fundamentados no se promocionan directamente. Se clasifican en el mismo almacén de soñado a corto plazo que la fase profunda normal ya usa. Eso significa:

DREAMS.md sigue siendo la superficie de revisión humana.
el almacén a corto plazo sigue siendo la superficie de clasificación orientada a la máquina.
MEMORY.md solo se escribe mediante la promoción profunda.

Si decide que la reproducción no fue útil, puede eliminar los artefactos preparados sin tocar las entradas ordinarias del diario o el estado de recuperación normal:

openclaw memory rem-backfill --rollback
openclaw memory rem-backfill --rollback-short-term

CLI

openclaw memory status          # Check index status and provider
openclaw memory search "query"  # Search from the command line
openclaw memory index --force   # Rebuild the index

Lecturas adicionales

Motor de memoria incorporado: backend SQLite predeterminado.
Motor de memoria QMD: sidecar local-first avanzado.
Memoria Honcho: memoria nativa de IA entre sesiones.
Memory LanceDB: complemento respaldado por LanceDB con incrustaciones compatibles con OpenAI.
Memory Wiki: bóveda de conocimiento compilada y herramientas nativas de wiki.
Búsqueda de memoria: canalización de búsqueda, proveedores y ajustes.
Soñar: promoción en segundo plano del recuerdo a corto plazo a la memoria a largo plazo.
Referencia de configuración de memoria: todos los perillas de configuración.
Compactación: cómo interactúa la compactación con la memoria.