Wiki de memoria

memory-wiki es un plugin incluido que convierte la memoria durable en una bóveda de conocimiento compilada.

No reemplaza al plugin de memoria activa. El plugin de memoria activa sigue siendo responsable de la recuperación, promoción, indexación y Dreaming. memory-wiki se coloca a su lado y compila el conocimiento durable en una wiki navegable con páginas deterministas, afirmaciones estructuradas, procedencia, paneles y resúmenes legibles por máquina.

Úsalo cuando quieras que la memoria se comporte más como una capa de conocimiento mantenida y menos como un montón de archivos Markdown.

Qué añade

• Una bóveda de wiki dedicada con diseño de página determinista
• Metadatos estructurados de afirmaciones y evidencia, no solo prosa
• Procedencia, confianza, contradicciones y preguntas abiertas a nivel de página
• Resúmenes compilados para consumidores de agente/runtime
• Herramientas nativas de wiki para buscar/obtener/aplicar/verificar
• Importaciones de Open Knowledge Format a conceptos de wiki compilados
• Modo puente opcional que importa artefactos públicos desde el plugin de memoria activa
• Modo de renderizado compatible con Obsidian e integración con CLI opcionales

Cómo encaja con la memoria

Piensa en la separación así:

Si el plugin de memoria activa expone artefactos de recuperación compartidos, OpenClaw puede buscar en ambas capas en una sola pasada con memory_search corpus=all.

Cuando necesites clasificación específica de wiki, procedencia o acceso directo a páginas, usa las herramientas nativas de wiki.

Patrón híbrido recomendado

Un buen valor predeterminado para configuraciones locales primero es:

• QMD como backend de memoria activa para recuperación y búsqueda semántica amplia
• memory-wiki en modo bridge para páginas de conocimiento sintetizado durable

Esa separación funciona bien porque cada capa se mantiene enfocada:

• QMD mantiene buscables las notas sin procesar, las exportaciones de sesión y las colecciones adicionales
• memory-wiki compila entidades estables, afirmaciones, paneles y páginas fuente

Regla práctica:

• usa memory_search cuando quieras una pasada amplia de recuperación en la memoria
• usa wiki_search y wiki_get cuando quieras resultados de wiki conscientes de la procedencia
• usa memory_search corpus=all cuando quieras que la búsqueda compartida abarque ambas capas

Si el modo puente informa cero artefactos exportados, el plugin de memoria activa aún no está exponiendo entradas públicas de puente. Ejecuta primero openclaw wiki doctor y luego confirma que el plugin de memoria activa admita artefactos públicos.

Cuando el modo puente está activo y bridge.readMemoryArtifacts está habilitado, openclaw wiki status, openclaw wiki doctor y openclaw wiki bridge import leen a través del Gateway en ejecución. Eso mantiene las comprobaciones de puente de la CLI alineadas con el contexto del plugin de memoria en runtime. Si el puente está deshabilitado o las lecturas de artefactos están desactivadas, esos comandos mantienen su comportamiento local/sin conexión.

Modos de bóveda

memory-wiki admite tres modos de bóveda:

isolated

Bóveda propia, fuentes propias, sin dependencia de memory-core.

Usa esto cuando quieras que la wiki sea su propio almacén de conocimiento curado.

bridge

Lee artefactos públicos de memoria y eventos de memoria desde el plugin de memoria activa a través de puntos de unión públicos del SDK de plugins.

Usa esto cuando quieras que la wiki compile y organice los artefactos exportados del plugin de memoria sin acceder a elementos internos privados del plugin.

El modo puente puede indexar:

• artefactos de memoria exportados
• informes de sueños
• notas diarias
• archivos raíz de memoria
• registros de eventos de memoria

unsafe-local

Vía de escape explícita en la misma máquina para rutas privadas locales.

Este modo es intencionalmente experimental y no portable. Úsalo solo cuando entiendas el límite de confianza y necesites específicamente acceso al sistema de archivos local que el modo puente no puede proporcionar.

Diseño de la bóveda

El plugin inicializa una bóveda así:

<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.

Los grupos principales de páginas son:

• sources/ para material sin procesar importado y páginas respaldadas por puente
• entities/ para cosas, personas, sistemas, proyectos y objetos durables
• concepts/ para ideas, abstracciones, patrones y políticas
• syntheses/ para resúmenes compilados y acumulados mantenidos
• reports/ para paneles generados

Importaciones de Open Knowledge Format

memory-wiki puede importar paquetes Open Knowledge Format desempaquetados con:

openclaw wiki okf import ./bundles/ga4

Este es el encaje más limpio cuando un catálogo de datos, rastreador de documentación o agente de enriquecimiento ya produce OKF: conserva OKF como artefacto de intercambio portable y deja que memory-wiki lo convierta en páginas de conceptos nativas de OpenClaw y resúmenes compilados.

El importador sigue la forma de OKF v0.1:

• los archivos .md no reservados son documentos de concepto
• cada concepto importado necesita un campo de frontmatter type no vacío
• se aceptan valores OKF type desconocidos
• los archivos reservados index.md y log.md no se importan como conceptos
• los enlaces Markdown rotos o externos se conservan

Las páginas de conceptos importadas se aplanan bajo concepts/ para que las rutas existentes de compilación, búsqueda, obtención, panel y resumen de prompts las vean sin añadir un segundo árbol de wiki. Cada página conserva el ID de concepto OKF original, la ruta fuente, type, resource, tags, la marca de tiempo y todo el frontmatter del productor. Los enlaces OKF internos se reescriben a las páginas de concepto de wiki generadas y también se emiten como entradas estructuradas relationships con kind: okf-link.

Afirmaciones y evidencia estructuradas

Las páginas pueden llevar frontmatter claims estructurado, no solo texto libre.

Cada afirmación puede incluir:

• id
• text
• status
• confidence
• evidence[]
• updatedAt

Las entradas de evidencia pueden incluir:

• kind
• sourceId
• path
• lines
• weight
• confidence
• privacyTier
• note
• updatedAt

Esto es lo que hace que la wiki actúe más como una capa de creencias que como un volcado pasivo de notas. Las afirmaciones pueden rastrearse, puntuarse, disputarse y resolverse hasta sus fuentes.

Metadatos de entidad orientados al agente

Las páginas de entidad también pueden llevar metadatos de enrutamiento para uso del agente. Esto es frontmatter genérico, por lo que funciona para personas, equipos, sistemas, proyectos o cualquier otro tipo de entidad.

Los campos comunes incluyen:

• entityType: por ejemplo person, team, system o project
• canonicalId: clave de identidad estable usada entre alias e importaciones
• aliases: nombres, identificadores o etiquetas que deberían resolverse a la misma página
• privacyTier: public, local-private, sensitive o confirm-before-use
• bestUsedFor / notEnoughFor: pistas compactas de enrutamiento
• lastRefreshedAt: marca de tiempo de actualización de fuente separada del tiempo de edición de la página
• personCard: tarjeta de enrutamiento opcional específica de persona con identificadores, redes sociales, correos electrónicos, zona horaria, carril, pedir por, evitar pedir por, confianza y privacidad
• relationships: aristas tipadas a páginas relacionadas con destino, tipo, peso, confianza, tipo de evidencia, nivel de privacidad y nota

Para una wiki de personas, el agente normalmente debería empezar con reports/person-agent-directory.md y luego abrir la página de la persona con wiki_get antes de usar datos de contacto o hechos inferidos.

Ejemplo:

pageType: entityentityType: personid: entity.brad-grouxcanonicalId: maintainer.brad-grouxaliases:  - Brad  - bgrouxprivacyTier: local-privatebestUsedFor:  - Microsoft Teams and Azure routingnotEnoughFor:  - legal approvallastRefreshedAt: "2026-04-29T00:00:00.000Z"personCard:  handles:    - "@bgroux"  socials:    - "https://x.example/bgroux"  emails:    - brad@example.com  timezone: America/Chicago  lane: Microsoft ecosystem  askFor:    - Teams rollout questions  avoidAskingFor:    - unrelated billing decisions  confidence: 0.8  privacyTier: confirm-before-userelationships:  - targetId: entity.alice    targetTitle: Alice    kind: collaborates-with    confidence: 0.7    evidenceKind: discrawl-statclaims:  - id: claim.brad.teams    text: Brad is useful for Microsoft Teams routing.    status: supported    confidence: 0.9    evidence:      - kind: maintainer-whois        sourceId: source.maintainers        privacyTier: local-private

Canalización de compilación

El paso de compilación lee páginas wiki, normaliza resúmenes y emite artefactos estables orientados a máquinas bajo:

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

Estos resúmenes existen para que los agentes y el código de runtime no tengan que extraer información de páginas Markdown.

La salida compilada también impulsa:

• indexación wiki de primera pasada para flujos de búsqueda/obtención
• búsqueda de ID de afirmación de vuelta a las páginas propietarias
• suplementos compactos de prompts
• generación de informes/paneles

Paneles e informes de salud

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

Los informes integrados incluyen:

• reports/open-questions.md
• reports/contradictions.md
• reports/low-confidence.md
• reports/claim-health.md
• reports/stale-pages.md
• reports/person-agent-directory.md
• reports/relationship-graph.md
• reports/provenance-coverage.md
• reports/privacy-review.md

Estos informes rastrean cosas como:

• clústeres de notas de contradicción
• clústeres de afirmaciones en competencia
• afirmaciones sin evidencia estructurada
• páginas y afirmaciones de baja confianza
• frescura obsoleta o desconocida
• páginas con preguntas sin resolver
• tarjetas de enrutamiento de personas/entidades
• aristas de relación estructuradas
• cobertura de clases de evidencia
• niveles de privacidad no públicos que necesitan revisión antes de usarse

Búsqueda y recuperación

memory-wiki admite dos backends de búsqueda:

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

También admite tres corpus:

• wiki
• memory
• all

Comportamiento importante:

• wiki_search y wiki_get usan resúmenes compilados como primera pasada cuando es posible
• los ID de afirmación pueden resolverse de vuelta a la página propietaria
• las afirmaciones disputadas/obsoletas/frescas influyen en la clasificación
• las etiquetas de procedencia pueden sobrevivir en los resultados
• el modo de búsqueda puede sesgar la clasificación para búsqueda de personas, enrutamiento de preguntas, evidencia de fuentes o afirmaciones sin procesar

Regla práctica:

• usa memory_search corpus=all para una pasada amplia de recuperación
• usa wiki_search + wiki_get cuando te importe la clasificación específica de wiki, la procedencia o la estructura de creencias a nivel de página

Modos de búsqueda:

• auto: valor predeterminado equilibrado
• find-person: potencia entidades tipo persona, alias, identificadores, redes sociales e ID canónicos
• route-question: potencia tarjetas de agente, pistas ask-for, pistas best-used-for y contexto de relaciones
• source-evidence: potencia páginas fuente y metadatos de evidencia estructurada
• raw-claim: potencia afirmaciones estructuradas coincidentes y devuelve metadatos de afirmación/evidencia en los resultados

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

Herramientas para agentes

El plugin registra estas herramientas:

• wiki_status
• wiki_search
• wiki_get
• wiki_apply
• wiki_lint

Qué hacen:

• wiki_status: modo de bóveda actual, salud, disponibilidad de la CLI de Obsidian
• wiki_search: busca páginas wiki y, cuando está configurado, corpus de memoria compartida; acepta mode para búsqueda de personas, enrutamiento de preguntas, evidencia de fuentes o desglose de afirmaciones sin procesar
• wiki_get: lee una página wiki por ID/ruta o recurre al corpus de memoria compartida
• wiki_apply: mutaciones acotadas de síntesis/metadatos sin cirugía libre de páginas
• wiki_lint: comprobaciones estructurales, vacíos de procedencia, contradicciones, preguntas abiertas

El Plugin también registra un suplemento de corpus de memoria no exclusivo, por lo que memory_search y memory_get compartidos pueden alcanzar la wiki cuando el Plugin de memoria activa admite la selección de corpus.

Comportamiento de prompt y contexto

Cuando context.includeCompiledDigestPrompt está habilitado, las secciones de prompt de memoria añaden una instantánea compilada compacta desde agent-digest.json.

Esa instantánea es intencionalmente pequeña y de alta señal:

• solo páginas principales
• solo afirmaciones principales
• recuento de contradicciones
• recuento de preguntas
• calificadores de confianza/frescura

Esto es optativo porque cambia la forma del prompt y es principalmente útil para motores de contexto o ensamblado de prompts heredado que consumen explícitamente suplementos de memoria.

Configuración

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

{  plugins: {    entries: {      "memory-wiki": {        enabled: true,        config: {          vaultMode: "isolated",          vault: {            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,          },          ingest: {            autoCompile: true,            maxConcurrentJobs: 1,            allowUrlIngest: true,          },          search: {            backend: "shared",            corpus: "wiki",          },          context: {            includeCompiledDigestPrompt: false,          },          render: {            preserveHumanBlocks: true,            createBacklinks: true,            createDashboards: true,          },        },      },    },  },}

Alternadores clave:

• vaultMode: isolated, bridge, unsafe-local
• vault.renderMode: native u obsidian
• bridge.readMemoryArtifacts: importar artefactos públicos del Plugin de memoria activa
• bridge.followMemoryEvents: incluir registros de eventos en modo puente
• search.backend: shared o local
• search.corpus: wiki, memory o all
• context.includeCompiledDigestPrompt: añadir una instantánea de resumen compacta a las secciones de prompt de memoria
• render.createBacklinks: generar bloques relacionados deterministas
• render.createDashboards: generar páginas de panel

Ejemplo: modo QMD + puente

Usa esto cuando quieras QMD para recuperación y memory-wiki para una capa de conocimiento mantenida:

{  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:

• QMD a cargo de la recuperación de memoria activa
• memory-wiki enfocado en páginas compiladas y paneles
• la forma del prompt sin cambios hasta que habilites intencionalmente los prompts de resumen compilado

CLI

memory-wiki también expone una superficie CLI de nivel superior:

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 la referencia completa de comandos.

Compatibilidad con Obsidian

Cuando vault.renderMode es obsidian, el Plugin escribe Markdown compatible con Obsidian y opcionalmente puede usar la CLI oficial obsidian.

Los flujos de trabajo compatibles incluyen:

• sondeo de estado
• búsqueda en bóveda
• apertura de una página
• invocación de un comando de Obsidian
• salto a la nota diaria

Esto es opcional. La wiki sigue funcionando en modo nativo sin Obsidian.

Flujo de trabajo recomendado

1. Conserva tu Plugin de memoria activa para recuperación/promoción/Dreaming.
2. Habilita memory-wiki.
3. Empieza con el modo isolated a menos que quieras explícitamente el modo puente.
4. Usa wiki_search / wiki_get cuando la procedencia importe.
5. Usa wiki_apply para síntesis acotadas o actualizaciones de metadatos.
6. Ejecuta wiki_lint después de cambios significativos.
7. Activa los paneles si quieres visibilidad de obsolescencia/contradicciones.

Documentación relacionada

• Resumen de memoria
• CLI: memory
• CLI: wiki
• Resumen del SDK de Plugin