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

No reemplaza al plugin de memoria activa. La recuperación, promoción, indexación y Dreaming siguen perteneciendo al backend de memoria que esté configurado (memory-core, QMD, Honcho, etc.). memory-wiki se ubica junto a él y compila conocimiento en una capa wiki mantenida.

Regla práctica:

• memory_search para una pasada amplia de recuperación en los corpus que estén configurados
• wiki_search / wiki_get cuando quieras ranking específico de wiki, procedencia o estructura de creencias a nivel de página
• memory_search corpus=all para abarcar ambas capas en una llamada, cuando el plugin de memoria activa admite selección de corpus

Una configuración local-first común: QMD como backend de memoria activa para recuperación y memory-wiki en modo bridge para páginas sintetizadas duraderas. Consulta el ejemplo de modo QMD + bridge en Configuración.

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

Modos de bóveda

• isolated (predeterminado): bóveda propia, fuentes propias, sin dependencia del plugin de memoria activa. Usa esto para un almacén de conocimiento curado autónomo.
• bridge: lee artefactos públicos de memoria y registros de eventos desde el plugin de memoria activa mediante puntos de unión públicos del SDK de plugins. Usa esto para compilar los artefactos exportados del plugin de memoria sin acceder a sus componentes internos privados.
• unsafe-local: vía de escape explícita en la misma máquina para rutas privadas locales. Intencionadamente experimental y no portable; úsala solo cuando entiendas el límite de confianza y necesites específicamente acceso al sistema de archivos local que el modo bridge no puede proporcionar.

El modo bridge puede indexar, según el selector de configuración bridge.*:

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

Cuando el modo bridge 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 memoria activa que la memoria de agente/runtime. Si bridge está deshabilitado o las lecturas de artefactos están desactivadas, esos comandos mantienen el comportamiento local/sin conexión.

Diseño de la bóveda

<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 preservan entre regeneraciones.

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

Importaciones de Open Knowledge Format

openclaw wiki okf import ./bundles/ga4

Importa un paquete Open Knowledge Format desempaquetado en páginas de conceptos wiki. Encaja bien cuando un catálogo de datos, rastreador de documentación o agente de enriquecimiento ya produce OKF: conserva OKF como artefacto de intercambio portable, deja 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 concepto
• cada concepto importado requiere un campo de frontmatter type no vacío; si falta type, se produce 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 aplanan bajo concepts/ para que los flujos existentes de compilación, búsqueda, obtención y paneles las vean sin un segundo árbol wiki. Cada página conserva el ID de concepto OKF original, la ruta fuente, type, resource, tags, la marca de tiempo y el frontmatter completo del productor. Los enlaces internos OKF se reescriben a las páginas de conceptos wiki generadas y también emiten entradas estructuradas relationships con kind: okf-link.

Afirmaciones estructuradas y evidencia

Las páginas llevan frontmatter claims estructurado, 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 se comporte como una capa de creencias, no como un volcado pasivo de notas. Las afirmaciones se pueden rastrear, puntuar, impugnar y resolver de vuelta a las fuentes.

Metadatos de entidad orientados a agentes

Las páginas de entidad llevan metadatos de enrutamiento genéricos 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 trata como sin revisión, cualquier otro valor (por ejemplo local-private, sensitive, confirm-before-use) se marca en reports/privacy-review.md
• bestUsedFor / notEnoughFor: pistas compactas de enrutamiento
• lastRefreshedAt: marca de tiempo de actualización de fuente, separada del momento de edición de la página
• personCard: tarjeta opcional de enrutamiento específica de persona (identificadores, redes sociales, correos, zona horaria, carril, pedir por, evitar pedir por, confianza, nivel de privacidad)
• relationships: aristas tipadas a páginas relacionadas (destino, tipo, peso, confianza, tipo de evidencia, nivel de privacidad, nota)

Para una wiki de personas, empieza con reports/person-agent-directory.md, 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:- Example ecosystem routingnotEnoughFor:- legal approvallastRefreshedAt: "2026-04-29T00:00:00.000Z"personCard:handles:  - "@example-handle"socials:  - "https://x.example/example-handle"emails:  - alex@example.comtimezone: America/Chicagolane: Example ecosystemaskFor:  - Example rollout questionsavoidAskingFor:  - unrelated billing decisionsconfidence: 0.8privacyTier: confirm-before-userelationships:- targetId: entity.other-person  targetTitle: Other Person  kind: collaborates-with  confidence: 0.7  evidenceKind: discrawl-statclaims:- id: claim.example.routing  text: Alex is useful for example-ecosystem routing.  status: supported  confidence: 0.9  evidence:    - kind: maintainer-whois      sourceId: source.maintainers      privacyTier: local-private

Canalización de compilación

La 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

Los agentes y el código runtime leen estos resúmenes en lugar de raspar Markdown. La salida compilada también impulsa la indexación wiki de primera pasada para búsqueda/obtención, la búsqueda de ID de afirmación de vuelta a las páginas propietarias, suplementos compactos de prompt y generación de informes.

Paneles e informes de salud

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

Búsqueda y recuperación

Dos backends de búsqueda:

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

Tres corpus: wiki, memory, all.

• wiki_search / wiki_get usan resúmenes compilados como primera pasada cuando es posible
• los ID de afirmación se resuelven de vuelta a la página propietaria
• las afirmaciones impugnadas/obsoletas/frescas influyen en el ranking
• las etiquetas de procedencia sobreviven en los resultados

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

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

Herramientas orientadas a agentes

El plugin también registra un suplemento de corpus de memoria no exclusivo, para que memory_search y memory_get compartidos puedan alcanzar la wiki cuando el plugin de memoria activa admita selección de corpus.

Comportamiento de prompt y contexto

Cuando context.includeCompiledDigestPrompt está habilitado, las secciones del prompt de memoria añaden una instantánea compilada compacta desde agent-digest.json: solo páginas principales, solo afirmaciones principales, recuento de contradicciones, recuento de preguntas y calificadores de confianza/frescura. Esto es opcional porque cambia la forma del prompt; importa principalmente para motores de contexto o ensamblado de prompts 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,          },          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 clave:

Ejemplo: QMD + modo puente

Usa esto cuando quieras QMD para recuperación y memory-wiki para una capa de conocimiento mantenida. Cada capa se mantiene enfocada: QMD conserva notas sin procesar, exportaciones de sesión y colecciones adicionales buscables, mientras que memory-wiki compila entidades estables, afirmaciones, paneles y páginas fuente.

{  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 memoria activa, memory-wiki enfocado en páginas compiladas y paneles, y la forma del prompt sin cambios hasta que habilites intencionalmente 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 la referencia completa de 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 usar la CLI oficial obsidian para sondeos de estado, búsqueda en la bóveda, apertura de una página, invocación de un comando y salto a la nota diaria. Esto es opcional; la wiki sigue funcionando en modo nativo sin Obsidian.

Flujo de trabajo recomendado

Documentos relacionados

• Descripción general de memoria
• CLI: memory
• CLI: wiki
• Descripción general del SDK de Plugin