--- read_when: - Quiere entender cómo funciona la memoria - Quieres saber qué archivos de memoria escribir summary: Cómo recuerda OpenClaw la información entre sesiones title: Descripción general de la memoria x-i18n: generated_at: "2026-07-14T13:38:27Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 25 provider: openai source_hash: 22542c5df22f1602c89bae05760a5418224d8ee1f1a73679203dec9b2f091f2a source_path: concepts/memory.md workflow: 16 --- OpenClaw recuerda elementos escribiendo archivos Markdown sin formato en el espacio de trabajo del agente (valor predeterminado: `~/.openclaw/workspace`). El modelo solo recuerda lo que se guarda en el disco; no hay ningún estado oculto. ## Cómo funciona El agente tiene tres archivos relacionados con la memoria: - **`MEMORY.md`** — memoria a largo plazo. Hechos duraderos, preferencias y decisiones. Se carga al inicio de una sesión. - **`memory/YYYY-MM-DD.md`** (o `memory/YYYY-MM-DD-.md`) — notas diarias. Contexto y observaciones en curso. Las notas fechadas de hoy y ayer se cargan automáticamente con un simple `/new` o `/reset`; las variantes con identificador, como las escritas por el hook de memoria de sesión incluido, se recogen junto con el archivo que solo contiene la fecha. - **`DREAMS.md`** (opcional) — diario de sueños y resúmenes de las revisiones de Dreaming para su revisión humana, incluidas entradas históricas de reposición fundamentada. Si se desea que el agente recuerde algo, basta con pedírselo: «Recuerda que prefiero TypeScript». El agente escribe la nota en el archivo correspondiente. ## Qué se guarda en cada lugar `MEMORY.md` es la capa compacta y seleccionada: hechos duraderos, preferencias, decisiones permanentes y resúmenes breves que deben estar disponibles al inicio de una sesión. No es una transcripción sin procesar, un registro diario ni un archivo exhaustivo. Los archivos `memory/YYYY-MM-DD.md` son la capa de trabajo: notas diarias detalladas, observaciones, resúmenes de sesiones y contexto sin procesar que aún puede resultar útil más adelante. Se indexan para `memory_search` y `memory_get`, pero no se inyectan en el prompt de arranque en cada turno. Con el tiempo, el agente destila el material útil de las notas diarias en `MEMORY.md` y elimina las entradas obsoletas de la memoria a largo plazo. Las instrucciones generadas para el espacio de trabajo y el flujo de Heartbeat lo hacen periódicamente; no es necesario editar manualmente `MEMORY.md` para cada detalle. Si `MEMORY.md` supera el presupuesto de archivos de arranque, OpenClaw conserva intacto el archivo en el disco, pero trunca la copia inyectada en el contexto. Esto debe considerarse una señal para trasladar el material detallado a `memory/*.md`, conservar solo un resumen duradero en `MEMORY.md` o aumentar los límites de arranque si se desea dedicar más presupuesto del prompt. Utilice `/context list`, `/context detail` o `openclaw doctor` para consultar los tamaños sin procesar e inyectados y el estado de truncamiento. ## Importación desde asistentes de programación La interfaz de control puede importar memoria local existente desde Codex y Claude Code. Abra **Settings** → **Import Memory**, elija el agente de destino, revise los archivos detectados y confirme la importación. OpenClaw solo copia memoria en Markdown: - Codex: los archivos consolidados `MEMORY.md` y `memory_summary.md` dentro de `~/.codex/memories` (o `CODEX_HOME/memories`). Los archivos de ejecución y transcripción sin procesar no se importan. - Claude Code: archivos Markdown de cada directorio de memoria automática del proyecto dentro de `~/.claude/projects/*/memory`, además de un `autoMemoryDirectory` configurado por el usuario, cuando exista. Las instrucciones del proyecto, las sesiones, la configuración y las credenciales no forman parte de esta acción exclusiva de memoria. Los archivos importados permanecen separados en `memory/imports/codex/` y `memory/imports/claude-code/` dentro del espacio de trabajo del agente seleccionado. Se indexan para `memory_search` y están disponibles mediante `memory_get`; no se combinan con el archivo de arranque `MEMORY.md` del agente. Los archivos de origen no se modifican. La vista previa señala los conflictos de destino. Active **Replace existing imports** para reemplazar esos archivos; al aplicar la operación, se crea una copia de seguridad previa a la importación verificada y se conservan copias individuales de los archivos sobrescritos en el informe de migración. ## Memorias sensibles a las acciones La mayoría de las memorias son notas Markdown comunes. Algunas afectan a lo que el agente debe hacer posteriormente; en esos casos, registre cuándo es seguro actuar según la nota, no solo el hecho en sí. Registre ese límite de acción cuando una nota implique: - requisitos de aprobación o permiso, - restricciones temporales, - transferencias a otra sesión, hilo o persona, - condiciones de vencimiento, - momento seguro para actuar, - autoridad de la fuente o del responsable, - instrucciones para evitar una acción tentadora. Una memoria útil y sensible a las acciones deja claro: - qué cambia el comportamiento futuro, - cuándo o bajo qué condición se aplica, - cuándo vence o qué habilita la acción, - qué debe evitar hacer el agente, - quién es la fuente o el responsable, si esto afecta a la confianza o la autoridad. La memoria puede conservar el contexto de aprobación, pero no aplica políticas. Utilice la configuración de aprobación de OpenClaw, el aislamiento y las tareas programadas para establecer controles operativos estrictos. Ejemplo: ```md La migración de la API se está diseñando en otra sesión. Los turnos futuros no deben editar la implementación de la API desde este hilo; los hallazgos de aquí deben usarse únicamente como información para el diseño hasta que se incorpore el plan de migración. ``` Otro ejemplo: ```md Un informe de una fuente no fiable debe revisarse antes de su promoción. Los turnos futuros deben tratarlo únicamente como evidencia; no debe almacenarse como memoria duradera hasta que un revisor de confianza confirme el contenido. ``` Este esquema no es obligatorio para todas las memorias; los hechos simples pueden mantenerse concisos. Utilice límites sensibles a las acciones cuando perder el momento, la autoridad, el vencimiento o el contexto de seguridad para actuar pueda hacer que el agente actúe incorrectamente más adelante. Utilice [compromisos](/es/concepts/commitments) para seguimientos inferidos y de corta duración. Utilice [tareas programadas](/es/automation/cron-jobs) para recordatorios exactos, comprobaciones temporizadas y trabajos recurrentes. La memoria puede seguir resumiendo el contexto duradero relacionado con cualquiera de estas opciones. ## Compromisos inferidos Algunos seguimientos futuros no son hechos duraderos. Si se menciona una entrevista mañana, la memoria útil podría ser «hacer seguimiento después de la entrevista», no «guardar esto para siempre en `MEMORY.md`». Los [compromisos](/es/concepts/commitments) son memorias de seguimiento opcionales y de corta duración para ese caso. OpenClaw los infiere en una ejecución oculta en segundo plano, limita su alcance al mismo agente y canal, y entrega mediante Heartbeat los seguimientos que vencen. Los recordatorios explícitos siguen utilizando [tareas programadas](/es/automation/cron-jobs). ## Herramientas de memoria El agente dispone de dos herramientas para trabajar con la memoria: - **`memory_search`** — encuentra notas relevantes mediante búsqueda semántica, incluso cuando la redacción difiere de la original. - **`memory_get`** — lee un archivo de memoria o intervalo de líneas específico. Ambas herramientas son proporcionadas por el Plugin de memoria activo (valor predeterminado: `memory-core`). ## Búsqueda en la memoria Cuando se configura un proveedor de embeddings, `memory_search` utiliza una búsqueda híbrida: similitud vectorial (significado semántico) combinada con coincidencia de palabras clave (términos exactos como identificadores y símbolos de código). Esto funciona de inmediato con una clave de API de cualquier proveedor compatible. OpenClaw utiliza embeddings de OpenAI de forma predeterminada. Configure `agents.defaults.memorySearch.provider` explícitamente para utilizar Gemini, Voyage, Mistral, Bedrock, DeepInfra, GGUF local, Ollama, LM Studio, GitHub Copilot o un endpoint genérico compatible con OpenAI. Consulte [Búsqueda en la memoria](/es/concepts/memory-search) para conocer el funcionamiento de la búsqueda, las opciones de ajuste y la configuración de proveedores. ## Backends de memoria Basado en SQLite. Funciona de inmediato con búsqueda por palabras clave, similitud vectorial y búsqueda híbrida. No requiere dependencias adicionales. Servicio auxiliar con prioridad local, reclasificación, expansión de consultas y capacidad para indexar directorios fuera del espacio de trabajo. Memoria entre sesiones nativa de IA con modelado de usuarios, búsqueda semántica y conocimiento de varios agentes. Instalación de Plugin. Memoria basada en LanceDB con embeddings compatibles con OpenAI, recuperación automática, captura automática y compatibilidad con embeddings locales de Ollama. Instalación de Plugin. ## Capa de wiki de conocimiento Si se desea que la memoria duradera se comporte más como una base de conocimiento mantenida que como notas sin procesar, utilice el Plugin `memory-wiki` incluido. Compila el conocimiento duradero en un repositorio wiki con una estructura de páginas determinista, afirmaciones y evidencias estructuradas, seguimiento de contradicciones y vigencia, paneles generados, compendios compilados y herramientas nativas de wiki (`wiki_status`, `wiki_search`, `wiki_get`, `wiki_apply`, `wiki_lint`). `memory-wiki` no reemplaza al Plugin de memoria activo; el Plugin de memoria activo sigue siendo responsable de la recuperación, la promoción y Dreaming. `memory-wiki` añade una capa de conocimiento con abundante información de procedencia junto a él. Compila la memoria duradera en un repositorio wiki con abundante información de procedencia, afirmaciones, paneles, modo puente y flujos de trabajo compatibles con Obsidian. ## Vaciado automático de memoria Antes de que la [Compaction](/es/concepts/compaction) resuma la conversación, OpenClaw ejecuta un turno silencioso que recuerda al agente guardar el contexto importante en los archivos de memoria. Esta función está activada de forma predeterminada; configure `agents.defaults.compaction.memoryFlush.enabled: false` para desactivarla. Para mantener ese turno de mantenimiento en un modelo local, configure una sustitución exacta que se aplique únicamente al turno de vaciado de memoria (no hereda la cadena de modelos alternativos de la sesión activa): ```json { "agents": { "defaults": { "compaction": { "memoryFlush": { "model": "ollama/qwen3:8b" } } } } } ``` El vaciado de memoria evita la pérdida de contexto durante la Compaction. Si el agente tiene hechos importantes en la conversación que todavía no se han escrito en un archivo, se guardan automáticamente antes de generar el resumen. ## Dreaming Dreaming es una ejecución opcional de consolidación de memoria en segundo plano. Recopila señales de recuperación a corto plazo, puntúa candidatos y solo promueve los elementos que cumplen los requisitos a la memoria a largo plazo (`MEMORY.md`): - **Opcional**: desactivado de forma predeterminada. - **Programado**: cuando está activado, `memory-core` administra automáticamente un trabajo Cron recurrente para una revisión completa de Dreaming. - **Con umbrales**: las promociones deben superar los criterios de puntuación, frecuencia de recuperación y diversidad de consultas. - **Revisable**: los resúmenes de fases y las entradas del diario se escriben en `DREAMS.md` para su revisión humana. Consulte [Dreaming](/es/concepts/dreaming) para obtener información sobre el comportamiento de las fases, las señales de puntuación y los detalles del diario de sueños. ## Reposición fundamentada y promoción en vivo El sistema de Dreaming tiene dos vías de revisión relacionadas: - **Dreaming en vivo** trabaja con el almacén de Dreaming a corto plazo situado en `memory/.dreams/` y es el que utiliza la fase profunda normal para decidir qué pasa a `MEMORY.md`. - **Reposición fundamentada** lee las notas históricas de `memory/YYYY-MM-DD.md` como archivos diarios independientes y escribe resultados de revisión estructurados en `DREAMS.md`. La reposición fundamentada resulta útil para reproducir notas antiguas e inspeccionar qué considera duradero el sistema, sin editar manualmente `MEMORY.md`. ```bash openclaw memory rem-backfill --path ./memory --stage-short-term ``` La opción `--stage-short-term` incorpora candidatos duraderos fundamentados al mismo almacén de Dreaming a corto plazo que ya utiliza la fase profunda normal; no los promueve directamente. Por tanto: - `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` sigue siendo escrito únicamente por la promoción profunda. Para deshacer una reproducción sin modificar las entradas ordinarias del diario ni el estado normal de recuperación: ```bash openclaw memory rem-backfill --rollback openclaw memory rem-backfill --rollback-short-term ``` ## CLI ```bash openclaw memory status # Comprobar el estado del índice y el proveedor openclaw memory search "query" # Buscar desde la línea de comandos openclaw memory index --force # Reconstruir el índice ``` ## Lecturas adicionales - [Búsqueda en memoria](/es/concepts/memory-search): canalización de búsqueda, proveedores y ajuste. - [Motor de memoria integrado](/es/concepts/memory-builtin): backend SQLite predeterminado. - [Motor de memoria QMD](/es/concepts/memory-qmd): proceso auxiliar avanzado con prioridad local. - [Memoria Honcho](/es/concepts/memory-honcho): memoria nativa de IA entre sesiones. - [Memoria LanceDB](/es/plugins/memory-lancedb): plugin respaldado por LanceDB con embeddings compatibles con OpenAI. - [Wiki de memoria](/es/plugins/memory-wiki): repositorio de conocimiento compilado y herramientas nativas de wiki. - [Dreaming](/es/concepts/dreaming): promoción en segundo plano desde la recuperación a corto plazo hasta la memoria a largo plazo. - [Referencia de configuración de memoria](/es/reference/memory-config): todas las opciones de configuración. - [Compaction](/es/concepts/compaction): cómo interactúa Compaction con la memoria. - [Active Memory](/es/concepts/active-memory): memoria de subagentes para sesiones de chat interactivas.