## El techo de la memoria Si ejecuta OpenClaw hoy, su agente almacena la memoria en `MEMORY.md` y los archivos fechados en un directorio `memory/`. Esto funciona para uso con un solo agente y una sola sesión. En el momento en que confías en ese recuerdo para cualquier cosa que esté sucediendo, llegas a un techo. Los modos de falla son específicos y predecibles. **La compactación de la memoria elimina los hechos.** OpenClaw activa un giro de agente silencioso que escribe "recuerdos duraderos" antes de truncar el contexto. Se desconoce qué había en el archivo antes de la compactación. Si la versión compacta dejó caer un hecho, ya no existe. No existe un registro de observación. Sin retroceso. **No hay identidad de entidad entre sesiones.** "Acme Corp" en una sesión y "ACME CORP" en la siguiente pueden resolverse o no en la misma entidad. El agente vuelve a inferir cada vez desde la ventana contextual. No hay identificaciones estables. Sin reglas de fusión. **Escrituras simultáneas en estado corrupto.** Si ejecuta varios agentes o complementos que tocan los mismos archivos de memoria, se dañarán los datos. La propia documentación de OpenClaw lo reconoce. El límite máximo de agente único es real y la mayoría de los flujos de trabajo de agente no permanecerán con un solo agente para siempre. **Sin seguimiento de auditoría.** Cuando el agente da una respuesta incorrecta, no se puede rastrear hasta una observación específica. No se puede ver lo que cambió entre el martes y el jueves. No se puede responder "¿qué sabía mi agente cuando tomó esa decisión?" Estos no son casos extremos. Aparecen tan pronto como el agente maneja contactos, tareas, transacciones o cualquier estado importante en las sesiones. ## Qué agrega el complemento [Neotoma v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3) agrega un manifiesto `openclaw.plugin.json`, un punto de entrada y definiciones de herramientas que se registran en el sistema de complementos de cuatro capas de OpenClaw. Gateway descubre el complemento, valida el manifiesto, carga el tiempo de ejecución y expone las herramientas de Neotoma al agente. Cada modo de falla anterior recibe una solución estructural. **La compactación ya no pierde estado.** Las observaciones se pueden agregar únicamente. El resumen compactado aún puede servir como ventana de contexto, pero las observaciones de la fuente persisten en Neotoma con el historial completo. Nada se cae silenciosamente. **La identidad de la entidad es determinista.** Los ID canónicos basados ​​en hash resuelven "Acme Corp" y "ACME CORP" en una entidad por regla, no por inferencia por sesión. Mismo contacto, misma identificación, siempre. **Las escrituras simultáneas son seguras.** Dos agentes que escriben sobre la misma entidad producen dos observaciones en un almacén de solo anexos, no un conflicto de archivos. Las restricciones del esquema validan cada escritura antes de que ingrese al almacén. **El registro de auditoría está integrado.** Cada observación se remonta a su origen. Las correcciones crean nuevas observaciones, no sobrescriben. Puede reconstruir el estado en cualquier momento. Más allá de arreglar el techo, el complemento expone capacidades que `MEMORY.md` no puede admitir en absoluto: - **Recuperación estructurada.** "Todas las tareas vinculadas a este contacto" o "cada transacción con el proveedor X" es una consulta, no un archivo grep. - **Consultas de cronograma.** Los campos de fecha entre entidades generan cronogramas. "Lo que pasó la semana pasada" aparece en un índice temporal, no en una búsqueda de ventana contextual. - **Validación de esquema.** Los tipos de entidad se verifican durante la escritura. Los datos incorrectos se rechazan antes de ingresar a la tienda. El bucle del agente no cambia. OpenClaw aún gestiona la interpretación de intenciones, la navegación, el llenado de formularios y la ejecución de habilidades. Neotoma maneja el estado. El complemento se encuentra entre las escrituras del agente y el almacenamiento persistente. ## La pregunta general Los archivos Markdown son gratuitos. No cuesta nada configurarlos ni mantenerlos, y la economía del caché KV los recompensa activamente. Neotoma agrega gastos generales. Validación de esquemas en escrituras. Almacenamiento de observaciones. Resolución de entidades. Un proceso de servidor local. Estos no son gratis. Pero la sobrecarga está diseñada para permanecer invisible: el agente instala Neotoma, lo configura y escribe en él sin necesidad de que usted aprenda una nueva herramienta o cambie su forma de trabajar. La pregunta es si vale la pena pagar los gastos generales. Si su agente nunca necesita responder "¿qué sabía el martes pasado?" o "qué escritura dañó este registro de contacto", entonces no. `MEMORY.md` es la arquitectura correcta. Si su agente administra el estado continuo, los contactos, las tareas, las transacciones y las relaciones con los proveedores, y necesita coherencia entre las sesiones, la sobrecarga de la ruta de escritura es la parte más económica del problema. La parte cara es depurar la corrupción estatal a posteriori, cuando la pista de auditoría no existe. ## Lo que esto no hace El complemento no reemplaza el bucle del agente de OpenClaw. No cambia cómo funcionan las habilidades. No requiere migrar el contenido `MEMORY.md` existente (aunque se admite la importación). No resuelve todos los problemas de memoria de los agentes. La calidad de la recuperación, la ingeniería rápida, el diseño de habilidades y la selección del modelo siguen siendo importantes. Neotoma maneja la capa de estado: qué entidades existen, cómo están vinculadas, de dónde vienen y cómo cambiaron. Todo lo que está encima de esa capa permanece igual. Tampoco pretende estabilidad de la producción. Neotoma está en [versión para desarrolladores](/posts/neotoma-developer-release). Se deben esperar cambios radicales. El complemento existe para probar si el estado estructurado debajo de una plataforma de agente real funciona en la práctica, no para prometer confiabilidad en la actualidad. ## Pruébalo, rómpelo He estado ejecutando Neotoma como capa de memoria en [mi propia pila agente](/posts/what-my-agentic-stack-actually-does). Varios agentes escriben en la misma tienda: clasificación de correo electrónico, gestión de tareas, finanzas y contenido. Los problemas de estado de múltiples agentes descritos anteriormente no son hipotéticos para mí. Son los que toco cada semana. El complemento lo pone a disposición de los usuarios de OpenClaw. Instálalo. Habilítelo. Ejecute su agente con un estado estructurado debajo. Vea dónde ayuda. Vea dónde los gastos generales no valen la pena. Vea dónde se rompe el diseño. El circuito de retroalimentación importa más que la arquitectura. Los agentes reales que escriben observaciones reales a través de una capa estructurada es donde las afirmaciones se mantienen o fracasan. ## Evaluar e instalar La forma más rápida de saber si Neotoma se adapta a su flujo de trabajo de OpenClaw es dejar que su agente lo evalúe por usted. Pega esto en tu sesión de OpenClaw: ```copiar Lea https://neotoma.io/evaluate. Antes de responder, inspeccione cualquier herramienta, espacio de trabajo y contexto de configuración más amplio al que pueda acceder para evaluar mi flujo de trabajo real en lugar de solo este chat. Luego, dígame si Neotoma realmente se adapta a mi flujo de trabajo, qué datos serían de mayor valor para persistir primero y qué debo hacer a continuación. ``` Su agente lee la página, verifica su contexto local (herramientas, configuraciones, archivos de memoria y espacio de trabajo) y le indica si los problemas descritos en esta publicación se aplican a su configuración. Si es así, lo guiará a través de la instalación, activación con sus propios datos y configuración del complemento. Si no es así, también te lo indica. Si ya desea Neotoma y prefiere omitir [el paso de evaluación](https://neotoma.io/evaluate), utilice la instalación asistida por agente desde [neotoma.io/install](https://neotoma.io/install). Pega esto en OpenClaw. Su agente lee la secuencia completa de instalación primero en esa página, la instala solo si es necesario, ejecuta la activación con sus datos y luego configura su herramienta actual para su uso continuo, incluidos los pasos de integración de OpenClaw en esa misma página: ```copiar Lea https://neotoma.io/install y guíeme a través del flujo de instalación de Neotoma primero. Instalarla, activarla con mis datos y configurar mi herramienta actual para un uso continuo y sólido. ``` Si prefiere los comandos manuales: `openclaw plugins install clawhub:neotoma` agrega el complemento directamente desde ClawHub. O instale el paquete npm globalmente con `npm install -g neotoma` y luego `neotoma init`, con un pin opcional para esta versión (`npm install -g neotoma@0.4.3`). Las opciones completas, la configuración de MCP, Docker y el comportamiento de reinicio permanecen en [neotoma.io/install](https://neotoma.io/install). Repositorio: [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma). Notas de la versión: [v0.4.3](https://github.com/markmhendrickson/neotoma/releases/tag/v0.4.3). Para conocer el razonamiento arquitectónico más profundo detrás de la memoria estructurada del agente, consulte [OpenClaw y la capa de verdad](/posts/openclaw-and-the-truth-layer) y [El techo de memoria de rebajas](/posts/the-markdown-memory-ceiling).