Wiki de memoria

memory-wiki es un plugin incluido que compila conocimiento duradero en una wiki navegable: páginas deterministas, afirmaciones estructuradas con evidencia, procedencia, paneles y resúmenes legibles por máquinas.

No reemplaza al plugin de Active Memory. La recuperación, la promoción, la indexación y Dreaming siguen siendo responsabilidad del backend de memoria que esté configurado (memory-core, QMD, Honcho, etc.). memory-wiki funciona junto a él y compila el conocimiento en una capa de wiki mantenida.

Regla práctica:

• memory_search para una pasada amplia de recuperación en todos los corpus configurados
• wiki_search / wiki_get cuando se necesita clasificación específica de la wiki, procedencia o una estructura de creencias a nivel de página
• memory_search corpus=all para abarcar ambas capas en una sola llamada, cuando el plugin de Active Memory admite la selección de corpus

Una configuración habitual con prioridad local: QMD como backend de Active Memory para la recuperación y memory-wiki en modo bridge para páginas sintetizadas duraderas. Consulta el ejemplo de QMD + modo puente en Configuración.

Si el modo puente informa de cero artefactos exportados, el plugin de Active Memory no está exponiendo actualmente entradas públicas para el puente. Ejecuta primero openclaw wiki doctor y luego confirma que el plugin de Active Memory admite artefactos públicos.

Modos del almacén

• isolated (predeterminado): almacén propio, fuentes propias, sin dependencia del plugin de Active Memory. Úsalo para un repositorio de conocimiento seleccionado y autónomo.
• bridge: lee artefactos públicos de memoria y registros de eventos del plugin de Active Memory mediante interfaces públicas del SDK de plugins. Úsalo para compilar los artefactos exportados por el plugin de memoria sin acceder a sus componentes internos privados.
• unsafe-local: vía de escape explícita para rutas locales privadas en la misma máquina. Es deliberadamente experimental y no portable; úsala solo cuando comprendas el límite de confianza y necesites específicamente acceso al sistema de archivos local que el modo puente no puede proporcionar.

El modo y el ámbito del almacén son opciones independientes:

• vaultMode elige de dónde proceden las entradas de la wiki.
• vault.scope elige si todos los agentes usan un solo almacén o si cada agente obtiene un almacén secundario.

vault.scope: "global" es el valor predeterminado y conserva el comportamiento existente de un único almacén. Usa vault.scope: "agent" con el modo isolated o bridge cuando los agentes no deban compartir páginas wiki, resúmenes compilados, resultados de búsqueda ni escrituras. El ámbito de agente no puede combinarse con el modo unsafe-local porque esas rutas privadas configuradas no son entradas propiedad del agente. La validación de la configuración rechaza esta combinación.

El modo puente puede indexar, según cada opción de configuración bridge.*:

• artefactos de memoria exportados (indexMemoryRoot)
• notas diarias (indexDailyNotes)
• informes de Dreaming (indexDreamReports)
• registros de eventos de memoria (followMemoryEvents)

Cuando el modo puente está activo y bridge.readMemoryArtifacts está habilitado, openclaw wiki status, openclaw wiki doctor y openclaw wiki bridge import se enrutan a través del Gateway en ejecución para que vean el mismo contexto del plugin de Active Memory que la memoria del agente y del entorno de ejecución. Si el puente está deshabilitado o las lecturas de artefactos están desactivadas, esos comandos conservan el comportamiento local y sin conexión.

Estructura del almacén

<vault>/  AGENTS.md  WIKI.md  index.md  inbox.md  entities/  concepts/  syntheses/  sources/  reports/  _attachments/  _views/  .openclaw-wiki/

El contenido administrado permanece dentro de bloques generados; los bloques de notas humanas se conservan entre regeneraciones.

• sources/: material original importado y páginas respaldadas por el modo puente o unsafe-local
• entities/: elementos duraderos, personas, sistemas, proyectos y objetos
• concepts/: ideas, abstracciones, patrones y políticas (también es el destino de las importaciones de OKF)
• syntheses/: resúmenes compilados y recopilaciones mantenidas
• reports/: paneles generados

Importaciones de Open Knowledge Format

openclaw wiki okf import ./bundles/ga4

Importa un paquete desempaquetado de Open Knowledge Format en páginas de conceptos de la wiki. Es una buena opción cuando un catálogo de datos, un rastreador de documentación o un agente de enriquecimiento ya produce OKF: conserva OKF como artefacto de intercambio portable y permite que memory-wiki lo convierta en páginas de conceptos nativas de OpenClaw y resúmenes compilados.

• los archivos .md no reservados son documentos de conceptos
• cada concepto importado requiere un campo de frontmatter type que no esté vacío; si falta type, se genera una advertencia missing-type y se omite el archivo
• los valores de type desconocidos se aceptan como conceptos genéricos
• index.md y log.md están reservados y nunca se importan como conceptos
• los enlaces Markdown rotos o externos se dejan sin cambios

Las páginas importadas se organizan sin subdirectorios bajo concepts/ para que los flujos existentes de compilación, búsqueda, obtención y paneles las detecten sin un segundo árbol de wiki. Cada página conserva el ID de concepto OKF original, la ruta de origen, type, resource, tags, la marca de tiempo y todo el frontmatter del productor. Los enlaces internos de OKF se reescriben para apuntar a las páginas de conceptos generadas en la wiki y también generan entradas estructuradas de relationships con kind: okf-link.

Afirmaciones estructuradas y evidencia

Las páginas contienen frontmatter estructurado claims, no solo texto libre. Cada afirmación puede incluir id, text, status, confidence, evidence[] y updatedAt. Cada entrada de evidencia puede incluir kind, sourceId, path, lines, weight, confidence, privacyTier, note y updatedAt.

Esto hace que la wiki funcione como una capa de creencias, no como un depósito pasivo de notas. Las afirmaciones pueden rastrearse, puntuarse, cuestionarse y resolverse a partir de las fuentes.

Metadatos de entidades para agentes

Las páginas de entidades contienen metadatos genéricos de enrutamiento utilizables para personas, equipos, sistemas, proyectos o cualquier otro tipo de entidad:

• entityType: por ejemplo, person, team, system, project
• canonicalId: clave de identidad estable entre alias e importaciones
• aliases: nombres, identificadores o etiquetas que se resuelven a la misma página
• privacyTier: cadena de formato libre; public se considera que no requiere revisión, mientras que cualquier otro valor (por ejemplo, local-private, sensitive, confirm-before-use) se marca en reports/privacy-review.md
• bestUsedFor / notEnoughFor: indicaciones compactas de enrutamiento
• lastRefreshedAt: marca de tiempo de actualización de la fuente, independiente de la hora de edición de la página
• personCard: ficha opcional de enrutamiento específica de una persona (identificadores, redes sociales, correos electrónicos, zona horaria, área, temas que consultar, temas que evitar consultar, confianza y nivel de privacidad)
• relationships: conexiones tipadas con páginas relacionadas (destino, tipo, peso, confianza, tipo de evidencia, nivel de privacidad y nota)

Para una wiki de personas, comienza con reports/person-agent-directory.md y luego abre la página de la persona con wiki_get antes de usar datos de contacto o hechos inferidos.

pageType: entityentityType: personid: entity.example-personcanonicalId: maintainer.example-personaliases:- Alex- example-handleprivacyTier: local-privatebestUsedFor:- Enrutamiento del ecosistema de ejemplonotEnoughFor:- aprobación legallastRefreshedAt: "2026-04-29T00:00:00.000Z"personCard:handles:  - "@example-handle"socials:  - "https://x.example/example-handle"emails:  - alex@example.comtimezone: America/Chicagolane: Ecosistema de ejemploaskFor:  - Preguntas sobre el despliegue de ejemploavoidAskingFor:  - decisiones de facturación no relacionadasconfidence: 0.8privacyTier: confirm-before-userelationships:- targetId: entity.other-person  targetTitle: Otra persona  kind: collaborates-with  confidence: 0.7  evidenceKind: discrawl-statclaims:- id: claim.example.routing  text: Alex resulta útil para el enrutamiento del ecosistema de ejemplo.  status: supported  confidence: 0.9  evidence:    - kind: maintainer-whois      sourceId: source.maintainers      privacyTier: local-private

Canalización de compilación

La compilación lee las páginas de la wiki, normaliza los resúmenes y genera artefactos estables orientados a máquinas en:

• .openclaw-wiki/cache/agent-digest.json
• .openclaw-wiki/cache/claims.jsonl

Los agentes y el código del entorno de ejecución leen estos resúmenes en lugar de analizar Markdown. La salida compilada también permite la indexación inicial de la wiki para búsqueda y obtención, la resolución de los identificadores de afirmaciones a sus páginas propietarias, complementos compactos para instrucciones y la generación de informes.

Paneles e informes de estado

Cuando render.createDashboards está habilitado, la compilación mantiene paneles en reports/:

Búsqueda y recuperación

Dos backends de búsqueda:

• shared: usa el flujo compartido de búsqueda en memoria cuando esté disponible
• local: busca localmente en la wiki

Tres corpus: wiki, memory, all.

• wiki_search / wiki_get usan los resúmenes compilados como primera pasada cuando es posible
• los identificadores de afirmaciones se resuelven a sus páginas propietarias
• las afirmaciones cuestionadas, obsoletas o recientes influyen en la clasificación
• las etiquetas de procedencia se conservan en los resultados

Modos de búsqueda (parámetro --mode / mode de la herramienta):

Cuando un resultado coincide con una afirmación estructurada, wiki_search devuelve matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds y evidenceSourceIds en su carga útil de detalles. La salida de texto incluye líneas compactas Claim: y Evidence: cuando están disponibles.

Herramientas para agentes

El plugin también registra un complemento no exclusivo del corpus de memoria, de modo que las funciones compartidas memory_search y memory_get puedan acceder a la wiki cuando el plugin de memoria activo admita la selección de corpus.

Comportamiento del prompt y del contexto

Cuando context.includeCompiledDigestPrompt está habilitado, las secciones de memoria del prompt añaden una instantánea compilada y compacta de agent-digest.json: solo las páginas principales, solo las afirmaciones principales, cantidad de contradicciones, cantidad de preguntas y calificadores de confianza/actualidad. Esta función es opcional porque modifica la estructura del prompt; es relevante principalmente para motores de contexto o ensamblajes de prompts que consumen explícitamente complementos de memoria.

Configuración

Coloca la configuración en plugins.entries.memory-wiki.config:

{  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "isolated",          vault: {            scope: "global",            path: "~/.openclaw/wiki/main",            renderMode: "obsidian",          },          obsidian: {            enabled: true,            useOfficialCli: true,            vaultName: "OpenClaw Wiki",            openAfterWrites: false,          },          bridge: {            enabled: false,            readMemoryArtifacts: true,            indexDreamReports: true,            indexDailyNotes: true,            indexMemoryRoot: true,            followMemoryEvents: true,          },          unsafeLocal: {            allowPrivateMemoryCoreAccess: false,            paths: [],          },          ingest: {            autoCompile: true,            maxConcurrentJobs: 1,            allowUrlIngest: true,          },          search: {            backend: "shared",            corpus: "wiki",          },          context: {            includeCompiledDigestPrompt: false,          },          render: {            preserveHumanBlocks: true,            createBacklinks: true,            createDashboards: true,          },        },      },    },  },}

Opciones principales:

Almacenes por agente

Establece vault.scope en agent para proporcionar a cada agente configurado una wiki independiente. En este ámbito, vault.path es un directorio principal y OpenClaw añade el id normalizado del agente:

{  agents: {    list: [{ id: "support" }, { id: "marketing" }],  },  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "bridge",          vault: {            scope: "agent",            path: "~/.openclaw/wiki",          },          bridge: {            enabled: true,            readMemoryArtifacts: true,          },        },      },    },  },}

Esto se resuelve como ~/.openclaw/wiki/support y ~/.openclaw/wiki/marketing. Si se omite vault.path en el ámbito de agente, el directorio principal predeterminado es ~/.openclaw/wiki. Por lo tanto, el agente main predeterminado conserva la ruta existente ~/.openclaw/wiki/main.

Las herramientas del agente, los resúmenes compilados del prompt y el complemento de la wiki expuesto mediante memory_search / memory_get resuelven el almacén a partir del contexto del agente activo. Para llamadas de la CLI y del Gateway en una configuración con varios agentes, especifica el agente explícitamente con openclaw wiki --agent <agentId> ... o mediante agentId en la solicitud al Gateway. Si solo hay un agente configurado, este sigue siendo el predeterminado cuando no se proporciona ningún id.

En modo puente, las importaciones con ámbito de agente solo aceptan un artefacto público de memoria cuando su propiedad agentIds incluye al agente seleccionado. Se omiten los artefactos pertenecientes a otro agente, sin metadatos de propiedad o con un propietario desconocido. El ámbito global conserva el comportamiento existente de artefactos compartidos.

Ejemplo: QMD + modo puente

Utiliza esta configuración cuando quieras usar QMD para la recuperación y memory-wiki como una capa de conocimiento mantenida. Cada capa conserva su función específica: QMD mantiene disponibles para búsqueda las notas sin procesar, las exportaciones de sesiones y las colecciones adicionales, mientras que memory-wiki compila entidades estables, afirmaciones, paneles y páginas de fuentes.

{  memory: {    backend: "qmd",  },  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "bridge",          bridge: {            enabled: true,            readMemoryArtifacts: true,            indexDreamReports: true,            indexDailyNotes: true,            indexMemoryRoot: true,            followMemoryEvents: true,          },          search: {            backend: "shared",            corpus: "all",          },          context: {            includeCompiledDigestPrompt: false,          },        },      },    },  },}

Esto mantiene a QMD a cargo de la recuperación de la memoria activa, centra memory-wiki en las páginas y los paneles compilados, y mantiene sin cambios la estructura del prompt hasta que habilites deliberadamente los prompts de resumen compilado.

CLI

openclaw wiki statusopenclaw wiki doctoropenclaw wiki initopenclaw wiki ingest ./notes/alpha.mdopenclaw wiki compileopenclaw wiki lintopenclaw wiki search "alpha"openclaw wiki get entity.alphaopenclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alphaopenclaw wiki bridge importopenclaw wiki obsidian status

Consulta CLI: wiki para obtener la referencia completa de los comandos, incluidos wiki okf import, wiki apply metadata, wiki unsafe-local import, wiki chatgpt import / wiki chatgpt rollback y el conjunto completo de subcomandos wiki obsidian.

Compatibilidad con Obsidian

Cuando vault.renderMode es obsidian, el plugin escribe Markdown compatible con Obsidian y, opcionalmente, puede utilizar la CLI oficial obsidian para consultar el estado, buscar en el almacén, abrir una página, invocar un comando y acceder a la nota diaria. Esto es opcional; la wiki sigue funcionando en modo nativo sin Obsidian.

Los almacenes con ámbito de agente también pueden utilizar Markdown compatible con Obsidian, pero la validación de la configuración rechaza obsidian.useOfficialCli: true junto con vault.scope: "agent". La configuración actual obsidian.vaultName es global y no permite seleccionar un almacén de Obsidian diferente para cada agente. En su lugar, utiliza las herramientas de la wiki y las operaciones de la CLI, o mantén una wiki gestionada con Obsidian en el ámbito global.

Flujo de trabajo recomendado

Documentación relacionada

• Descripción general de la memoria
• CLI: memoria
• CLI: wiki
• Descripción general del SDK de plugins