Ir al contenido
Guías

El wiki de memoria de OpenClaw

Una bóveda de conocimiento compilada con afirmaciones, evidencias, procedencia y paneles junto al plugin de memoria

6 min de lectura

Las notas de memoria simples responden a qué recuerda el agente; no dicen con qué grado de certeza lo sabe, de dónde salió un dato ni qué dos notas se contradicen. El plugin incluido memory-wiki de OpenClaw añade esa capa. Compila el conocimiento duradero en un wiki navegable de páginas deterministas, afirmaciones estructuradas con evidencias, procedencia, paneles y compendios legibles por máquina, y se sitúa junto al plugin de memoria activo en lugar de sustituirlo: el recuerdo, la promoción, la indexación y el sueño siguen a cargo del plugin de memoria configurado. Estos son los modos de bóveda, la estructura, el modelo de afirmaciones, el pipeline de compilación, los informes, las herramientas y las salvedades sobre las bóvedas por agente.

Modos, ámbito, estructura

  • Tres modos de bóveda: isolated, el predeterminado, con su propia bóveda y sus propias fuentes y sin depender del plugin de memoria; bridge, que lee los artefactos de memoria públicos y los registros de eventos del plugin de memoria activo a través de los puntos de integración públicos del SDK de plugins, e indexa, según cada interruptor, los artefactos exportados, las notas diarias, los informes de sueño y los registros de eventos de memoria; y unsafe-local, una vía de escape explícita en la misma máquina para rutas privadas, experimental y no portable.
  • El ámbito de la bóveda es una elección aparte: global, el predeterminado, mantiene una sola bóveda compartida, mientras que el ámbito por agente da a cada agente una bóveda hija para que los agentes no puedan compartir páginas, compendios, resultados de búsqueda ni escrituras; el ámbito por agente no se puede combinar con el modo unsafe-local, y la validación lo rechaza.
  • La bóveda contiene notas de agente y de wiki en el nivel superior, un índice y una bandeja de entrada, y carpetas para entidades, conceptos, síntesis, fuentes, informes, adjuntos y vistas; el contenido gestionado permanece dentro de bloques generados y los bloques de notas humanas sobreviven a la regeneración.
  • Los paquetes en Open Knowledge Format se importan como páginas de concepto, conservando el frontmatter original de id de concepto, tipo, recurso, etiquetas, marca de tiempo y productor, con los enlaces internos reescritos hacia páginas del wiki y emitidos como relaciones estructuradas.
Esto hace que el wiki se comporte como una capa de creencias, no como un vertedero pasivo de notas.

Afirmaciones, entidades, compilación

Las páginas llevan afirmaciones estructuradas en el frontmatter, cada una con un id, un texto, un estado, una confianza, entradas de evidencia y una fecha de actualización, donde cada evidencia lleva un tipo, un id de fuente, una ruta, líneas, un peso, una confianza, un nivel de privacidad y una nota; las afirmaciones se pueden seguir, puntuar, impugnar y remontar a sus fuentes. Las páginas de entidad añaden metadatos de enrutamiento aplicables a personas, equipos, sistemas o proyectos: un tipo de entidad, un id canónico, alias, un nivel de privacidad en el que todo lo que no sea público se marca para revisión, indicaciones de para qué sirve mejor y para qué no basta, una marca de tiempo de actualización, una ficha de persona opcional con identificadores, redes sociales, correos electrónicos, zona horaria, área y listas de qué pedirle y qué evitar pedirle, y relaciones tipadas. La compilación lee las páginas, normaliza los resúmenes y guarda una instantánea orientada a la máquina en el estado de plugins SQLite compartido de OpenClaw; la preparación del prompt en tiempo de ejecución carga esa instantánea de forma asíncrona y nunca extrae Markdown ni lee archivos de caché, las ediciones de las fuentes solo llegan a la máquina tras la siguiente compilación, y una publicación de compilación encadenada causalmente permite que una actualización del ciclo de vida rechace una instantánea procedente de un estado más reciente que luego se revirtió. Las cachés compiladas se pueden reconstruir y se reemplazan, no se migran.

Informes, búsqueda, herramientas

  • Con los paneles activados, la compilación mantiene informes de preguntas abiertas, contradicciones, páginas y afirmaciones de baja confianza, afirmaciones sin evidencia estructurada, páginas obsoletas, el directorio de personas y agentes, el grafo de relaciones, la cobertura de procedencia y una revisión de privacidad de los niveles no públicos.
  • La búsqueda tiene un backend compartido que usa el flujo de búsqueda de memoria cuando está disponible y uno local que busca solo en el wiki, tres corpus (wiki, memory y all) y cinco modos: auto, find-person, route-question, source-evidence y raw-claim; un resultado sobre una afirmación estructurada devuelve el id, el estado, la confianza, los tipos de evidencia y los id de fuente de la afirmación, y las afirmaciones impugnadas, obsoletas o recientes influyen en la clasificación.
  • Cinco herramientas del agente: wiki status, wiki search, wiki get, wiki apply para mutaciones acotadas de síntesis y metadatos sin cirugía libre de páginas, y wiki lint para comprobaciones estructurales, huecos de procedencia, contradicciones y preguntas abiertas; el plugin también registra un complemento de corpus no exclusivo para que la búsqueda y la lectura compartidas de la memoria lleguen al wiki cuando el plugin de memoria admite la selección de corpus.

La memoria de OpenClaw explicada es la capa junto a la que se sitúa este plugin, y la búsqueda de memoria de OpenClaw, la pasada de recuerdo amplia que la documentación sigue recomendando primero.

La interfaz y las salvedades

La interfaz de control recorre el wiki compilado desde la página de memoria, en las pestañas de sueños y diario: agrupa las páginas de síntesis, entidades y conceptos con recuentos por página, abre el contenido en línea mediante la misma búsqueda que usa la herramienta get, limita cada panel a las 2500 tarjetas más recientes, y nunca recorre las páginas brutas de la bóveda ni espera a una compilación completa. El compendio compilado se puede añadir a las secciones de memoria del prompt, con las páginas y afirmaciones principales y los recuentos de contradicciones y preguntas, pero es opcional porque cambia la forma del prompt. Cambiar el ámbito de la bóveda no copia ni divide una bóveda existente, y las bóvedas por agente son una frontera de conocimiento dentro del mismo proceso, no del sistema operativo, ya que las herramientas sin entorno aislado con acceso al sistema de archivos del host pueden seguir leyendo el directorio de otro agente. El sueño en OpenClaw es la consolidación propia del plugin de memoria que el modo bridge puede indexar, y el aislamiento de OpenClaw explicado, la frontera a la que remite la documentación cuando los agentes no confían entre sí.

En Diali

En Diali, el plugin viene con la imagen del motor, y su bóveda queda en el volumen persistente del asistente, bajo el directorio de estado, una vez activado; la frontera por agente importa menos aquí, ya que cada instancia ejecuta su propio asistente. OpenClaw alojado en Diali es el asistente y la guía de plugins de OpenClaw explica cómo se activan los plugins incluidos.

  • Una capa de creencias junto a la memoria, no un sustituto.
  • Afirmaciones con evidencias, compiladas en SQLite y reflejadas en paneles.
  • Aislado de forma predeterminada; en modo bridge, indexa lo que exporta la memoria.
Empezar

Deja de leer sobre ello y crea el tuyo

Configura un agente, elige un canal y ponlo a trabajar dentro de la aplicación que ya tienes abierta.