Falta OpenClaw MEMORY.md: diagnosticar la primera capa fallida

Si OpenClaw dice MEMORY.md falta, no cree ni restaure el archivo hasta que sepa qué espacio de trabajo y sesión produjeron el síntoma. El diagnóstico confiable más corto es: 1. identificar el espacio de trabajo activo del agente afectado; 2. demostrar que MEMORY.md es un archivo normal en ese espacio de trabajo; 3. confirmar que la sesión puede cargar memoria privada a largo plazo; 4. distinguir un marcador de arranque faltante de una copia inyectada truncada; 5. Pruebe la frescura de la búsqueda solo después de que pasen las comprobaciones de arranque. Esos controles responden a diferentes preguntas. La reindexación no puede reparar el espacio de trabajo incorrecto. La recreación de un archivo no puede solucionar la exclusión intencional de una sesión compartida. Aumentar un presupuesto rápido no puede restaurar un archivo que no está en el disco. OpenClawLa documentación actual deja los límites inusualmente claros: los archivos Markdown en el espacio de trabajo son la fuente duradera, MEMORY.md es la capa curada a largo plazo cargada al inicio de la sesión y detallada memory/YYYY MM DD.md las notas se recuperan a través de herramientas de memoria en lugar de inyectarse en cada turno. Ese diseño crea más de un significado legítimo de "desaparecido". Primero prueba qué espacio de trabajo está activo OpenClawEl espacio de trabajo predeterminado es normalmente ~/.openclaw/workspace , pero eso es sólo un valor predeterminado. Un perfil puede seleccionar un espacio de trabajo con sufijo, OPENCLAW WORKSPACE DIR puede anular el valor predeterminado y un agente no predeterminado puede tener su propio espacio de trabajo configurado. Un archivo en un directorio antiguo o hermano es real pero irrelevante para la sesión que utiliza otro directorio. Pregunte al tiempo de ejecución por sus valores resueltos en lugar de inferirlos del directorio actual del shell: Elija el agente afectado de esa salida. Luego inspeccione los metadatos, no los contenidos: En macOS, use stat f 'type=%HT bytes=%z modified=%Sm' en cambio. Mantenga la ruta privada exacta en la evidencia del operador local; un recibo de salud exportado solo necesita una identificación de espacio de trabajo opaca, activeWorkspaceMatches , fileExists , regularFile , recuento de bytes y tiempo de modificación. El orden importa: El espacio de trabajo activo no coincide con la ruta inspeccionada: clasificar WRONG WORKSPACE . Repare la configuración del agente o perfil, o migre intencionalmente el archivo después de revisar ambas copias. No sobrescriba silenciosamente ninguno de los espacios de trabajo. La ruta activa coincide pero el archivo está ausente: clasificar MISSING ON DISK . Decida si este agente realmente necesita una memoria a largo plazo curada. MEMORY.md es opcional; openclaw setup workspace <path Puede generar valores predeterminados faltantes sin sobrescribir archivos existentes. La ruta existe pero no es un archivo regular elegible: clasificar UNSUPPORTED FILE TYPE . Esto es especialmente relevante para la siembra en sandbox. La documentación actual del espacio de trabajo dice que las copias iniciales de la zona de pruebas aceptan archivos normales en el espacio de trabajo e ignoran los alias de enlaces simbólicos o físicos que se resuelven fuera del espacio de trabajo de origen. El archivo es un archivo normal en el espacio de trabajo activo: no llame a la capa de almacenamiento rota. Pasar al alcance de la sesión y arrancar la evidencia. Esta primera etapa evita una reparación falsa común: encontrar una solución plausible. MEMORY.md en algún lugar del disco y suponiendo que el agente afectado lo utilice. Un archivo puede existir y aún estar ausente en un mensaje La siguiente pregunta no es "¿puede el shell leer el archivo?" Es “¿qué hizo OpenClaw ¿Inyectar para esta sesión? En la sesión afectada, utilice: El informe contextual distingue el tamaño del archivo sin formato del tamaño inyectado y expone el truncamiento. openclaw doctor También puede informar problemas de arranque. Registre el resultado como una pequeña enumeración: present , missing marker , truncated , o not loaded —en lugar de copiar el texto de la memoria en un ticket de incidente. Actual OpenClaw El comportamiento crea tres ramas importantes: Un marcador faltante no es un bloqueo. Cuando falta un archivo de arranque, OpenClaw inyecta un marcador de archivo faltante y continúa. Ese marcador es evidencia sobre el espacio de trabajo resuelto en el momento de la construcción de la sesión. Es más fuerte que la afirmación en lenguaje natural de un agente de que “no puede recordar”, pero aún así no le dice por qué el archivo está ausente. Una copia truncada no es un archivo faltante. OpenClaw mantiene el archivo intacto en el disco mientras trunca la copia inyectada cuando se excede el presupuesto de arranque. Los valores predeterminados documentados son 20.000 caracteres por archivo y 60.000 caracteres en archivos de arranque. Si /context detail informes de truncamiento, clasificación BOOTSTRAP TRUNCATED . Mover material detallado a memory/ .md , acortar la capa seleccionada o aumentar deliberadamente los límites después de considerar el costo inmediato. Restaurar el archivo no solucionaría nada. La memoria privada puede estar fuera de alcance intencionalmente. La guía del espacio de trabajo indica que se cargue MEMORY.md solo en la sesión privada principal, no en contextos compartidos o grupales. Un archivo que está presente en el disco pero no cargado en una sesión compartida es SCOPE EXCLUDED , no insalubre. Cambiar ese límite para que un cheque se vuelva verde podría filtrar el contexto privado. La regla práctica es: Esta prioridad antepone deliberadamente la privacidad a la disponibilidad. Un operador no debe “reparar” una sesión compartida inyectando memoria privada duradera. Mantenga la carga de arranque y la búsqueda de memoria en carriles separados MEMORY.md inyección de arranque y memory search están relacionados, pero no son el mismo mecanismo. El archivo seleccionado puede estar presente en un mensaje de sesión principal mientras la recuperación indexada está obsoleta. Por el contrario, la búsqueda de memoria puede devolver una nota diaria mientras que la copia de arranque de MEMORY.md falta o está truncado. Solo después de pasar el espacio de trabajo, la elegibilidad de archivos, el alcance y la inyección de arranque debe ejecutar: Utilice un canario creado para la prueba, no una frase privada copiada de la memoria a largo plazo. Registre si el índice está actualizado y si se devolvió el ID de registro opaco del canario. No exportes la frase. Un resumen sin editar de un breve secreto tampoco es seguro porque se puede adivinar sin conexión. Son útiles dos clasificaciones posteriores: SEARCH STALE : el archivo se cargó, pero el índice informa un estado pendiente o sucio. La reindexación es relevante aquí. RETRIEVAL MISS : el índice afirma estar actualizado, pero no se devuelve el canario conocido. Inspeccione la cobertura de origen, la configuración del backend y el comportamiento de las consultas. Ningún estado justifica el reemplazo MEMORY.md . La reparación de búsqueda comienza solo después de que se comprueba el estado del archivo y del arranque. El historico OpenClaw asunto 9307 es una advertencia útil sobre la combinación de capas: OpenClaw El informe 2026.2.2 3 incluyó ambos ENOENT lecturas de archivos de memoria y fallas de sincronización de vigilancia/búsqueda separadas. No hay evidencia de que exista el mismo error en la versión actual. OpenClaw. Es evidencia de que un incidente puede contener más de una capa fallida. Reproducir la decisión antes de tocar la producción. El siguiente clasificador no utiliza contenido de memoria y codifica la precedencia de la primera capa fallida: Reproduje ocho partidos siguiendo esa precedencia exacta: una sesión principal saludable, un archivo ausente, un espacio de trabajo incorrecto, un enlace de sandbox rechazado, una exclusión de sesión compartida, una copia de arranque truncada, un índice sucio y un índice canario nuevo. Los ocho obtuvieron la clasificación esperada. Ese experimento expone el principal resultado operativo: una persona puede describir seis estados no saludables como “falta de memoria”, pero cada uno requiere una respuesta diferente. Utilice esta matriz de reparación después de la clasificación: Clasificación Acción razonable más pequeña Verificación WRONG WORKSPACE Corrija la ruta del agente/perfil seleccionado o realice una migración revisada Una nueva sesión principal resuelve el ID del espacio de trabajo opaco previsto MISSING ON DISK Sembrar o crear el archivo seleccionado opcional solo si es necesario Una nueva sesión informa present , no simplemente un comando de escritura exitoso UNSUPPORTED FILE TYPE Reemplace el alias con un archivo normal aprobado en el espacio de trabajo Las sesiones de sandbox y de anfitrión acuerdan la elegibilidad SCOPE EXCLUDED Preservar el límite de privacidad La sesión privada principal lo carga; la sesión compartida no BOOTSTRAP LOAD FAILURE Inspeccionar permisos, vista de tiempo de ejecución y preparación de arranque /context detail informa una copia inyectada distinta de cero BOOTSTRAP TRUNCATED Seleccionar o ajustar deliberadamente los presupuestos puntuales El canario sensible a la acción requerido permanece en la porción inyectada SEARCH STALE Reconstruir o esperar el índice según el backend activo Tanto la frescura del índice como la recuperación del canario pasan RETRIEVAL MISS Inspeccionar la cobertura de origen y la configuración de recuperación El mismo canario acotado regresa por ID opaca No se detenga en "el comando tuvo éxito". El resultado es un recibo de sesión nueva que muestra el espacio de trabajo previsto, el archivo elegible, el alcance correcto, el estado de arranque que no falta y, solo cuando se requiere una búsqueda, un índice actual más una recuperación canaria. Queda una limitación: este recibo prueba el transporte y la disponibilidad, no la verdad semántica. No puede establecer que una decisión recordada sea correcta, vigente o aún autorizada. La memoria sensible a la acción todavía necesita un propietario, alcance, vencimiento y límite de aprobación. Dónde Sidewisp encaja Este es el tipo de contrato de evidencia que debe presentar una capa de salud de un agente de IA: primera capa fallida, impacto, frescura, confianza, acción segura más pequeña y verificación posterior a la acción. no deberia subir MEMORY.md , revelar rutas privadas o llamar a una reindexación de recuperación antes de que regrese el comportamiento de memoria esperado. Sidewisp se encuentra actualmente en versión preliminar privada. Su motor de seguimiento de la producción y OpenClaw El adaptador no se envía en el repositorio del sitio web actual, por lo que Sidewisp Actualmente no inspecciona ni repara esta condición. La dirección del producto es agregar una capa de salud alrededor de los tiempos de ejecución existentes y mantener la autoridad humana sobre la recuperación. Puede únete a la lista de espera de vista previa privada si ese límite coincide con la forma en que opera a los agentes. fuentes primarias Descripción general de la memoria OpenClaw — roles de archivos, carga de inicio, notas diarias indexadas y truncamiento de arranque. Espacio de trabajo del agente OpenClaw – resolución del espacio de trabajo, elegibilidad de semillas de sandbox, marcadores faltantes, presupuestos puntuales y alcance de la sesión privada. Número de OpenClaw n.º 9307 — evidencia histórica del incidente 2026.2.2 3, retenida solo con el límite de esa versión.