Geheugenwiki

memory-wiki is een gebundelde plugin die duurzame kennis compileert tot een navigeerbare wiki: deterministische pagina's, gestructureerde beweringen met bewijs, herkomst, dashboards en machineleesbare samenvattingen.

Deze vervangt de Active Memory-plugin niet. Herinnering, promotie, indexering en Dreaming blijven de verantwoordelijkheid van de geconfigureerde geheugenbackend (memory-core, QMD, Honcho enzovoort). memory-wiki bevindt zich ernaast en compileert kennis tot een onderhouden wikilaag.

Praktische regel:

• memory_search voor één brede herinneringsronde in alle geconfigureerde corpora
• wiki_search / wiki_get wanneer je wikispecifieke rangschikking, herkomst of een geloofsstructuur op paginaniveau wilt
• memory_search corpus=all om beide lagen in één aanroep te doorzoeken, wanneer de Active Memory-plugin corpusselectie ondersteunt

Een gebruikelijke local-first-configuratie: QMD als de Active Memory-backend voor herinnering en memory-wiki in de modus bridge voor duurzame gesynthetiseerde pagina's. Zie het voorbeeld voor QMD + bridge-modus onder Configuratie.

Als de bridge-modus nul geëxporteerde artefacten meldt, stelt de Active Memory-plugin momenteel geen openbare bridge-invoer beschikbaar. Voer eerst openclaw wiki doctor uit en controleer vervolgens of de Active Memory-plugin openbare artefacten ondersteunt.

Kluismodi

• isolated (standaard): eigen kluis, eigen bronnen, geen afhankelijkheid van de Active Memory-plugin. Gebruik dit voor een zelfstandige, gecureerde kennisopslag.
• bridge: leest openbare geheugenartefacten en gebeurtenislogboeken van de Active Memory-plugin via openbare plugin-SDK-koppelingen. Gebruik dit om de geëxporteerde artefacten van de geheugenplugin te compileren zonder toegang tot interne privéonderdelen van de plugin.
• unsafe-local: expliciete ontsnappingsroute voor privépaden op dezelfde machine. Bewust experimenteel en niet-overdraagbaar; gebruik dit alleen wanneer je de vertrouwensgrens begrijpt en specifiek toegang tot het lokale bestandssysteem nodig hebt die de bridge-modus niet kan bieden.

Kluismodus en kluisbereik zijn afzonderlijke keuzes:

• vaultMode bepaalt waar wiki-invoer vandaan komt.
• vault.scope bepaalt of alle agents één kluis gebruiken of elke agent een onderliggende kluis krijgt.

vault.scope: "global" is de standaardinstelling en behoudt het bestaande gedrag met één kluis. Gebruik vault.scope: "agent" met de modus isolated of bridge wanneer agents geen wikipagina's, gecompileerde samenvattingen, zoekresultaten of schrijfbewerkingen mogen delen. Agentbereik kan niet worden gecombineerd met de modus unsafe-local, omdat die geconfigureerde privépaden geen invoer zijn waarvan de agent eigenaar is. Configuratievalidatie wijst deze combinatie af.

De bridge-modus kan, afhankelijk van de schakelopties in de bridge.*-configuratie, het volgende indexeren:

• geëxporteerde geheugenartefacten (indexMemoryRoot)
• dagelijkse notities (indexDailyNotes)
• Dreaming-rapporten (indexDreamReports)
• geheugengebeurtenislogboeken (followMemoryEvents)

Wanneer de bridge-modus actief is en bridge.readMemoryArtifacts is ingeschakeld, worden openclaw wiki status, openclaw wiki doctor en openclaw wiki bridge import via de actieve Gateway geleid, zodat ze dezelfde context van de Active Memory- plugin zien als het geheugen van agents en de runtime. Als bridge is uitgeschakeld of het lezen van artefacten is uitgeschakeld, behouden deze opdrachten hun lokale/offlinegedrag.

Kluisindeling

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

Beheerde inhoud blijft binnen gegenereerde blokken; blokken met menselijke notities blijven bij regeneratie behouden.

• sources/: geïmporteerd bronmateriaal en pagina's die door bridge/unsafe-local worden ondersteund
• entities/: duurzame zaken, personen, systemen, projecten, objecten
• concepts/: ideeën, abstracties, patronen, beleid (ook de bestemming voor OKF-importen)
• syntheses/: gecompileerde samenvattingen en onderhouden totalen
• reports/: gegenereerde dashboards

Importen in Open Knowledge Format

openclaw wiki okf import ./bundles/ga4

Importeer een uitgepakte Open Knowledge Format-bundel in wiki-conceptpagina's. Dit is geschikt wanneer een gegevenscatalogus, documentatiecrawler of verrijkingsagent al OKF produceert: behoud OKF als het overdraagbare uitwisselingsartefact en laat memory-wiki dit omzetten in systeemeigen OpenClaw-conceptpagina's en gecompileerde samenvattingen.

• niet-gereserveerde .md-bestanden zijn conceptdocumenten
• elk geïmporteerd concept vereist een niet-leeg frontmatter-veld type; een ontbrekend type veroorzaakt een waarschuwing missing-type en het bestand wordt overgeslagen
• onbekende waarden voor type worden geaccepteerd als generieke concepten
• index.md en log.md zijn gereserveerd en worden nooit als concepten geïmporteerd
• defecte of externe Markdown-koppelingen blijven ongewijzigd

Geïmporteerde pagina's worden rechtstreeks onder concepts/ geplaatst, zodat bestaande processen voor compileren, zoeken, ophalen en dashboards ze zonder een tweede wikiboom kunnen gebruiken. Elke pagina behoudt de oorspronkelijke OKF-concept-ID, het bronpad, type, resource, tags, het tijdstempel en de volledige frontmatter van de producent. Interne OKF-koppelingen worden herschreven naar de gegenereerde wiki-conceptpagina's en leveren ook gestructureerde relationships-vermeldingen op met kind: okf-link.

Gestructureerde beweringen en bewijs

Pagina's bevatten gestructureerde claims-frontmatter, niet alleen vrije tekst. Elke bewering kan id, text, status, confidence, evidence[] en updatedAt bevatten. Elke bewijsvermelding kan kind, sourceId, path, lines, weight, confidence, privacyTier, note en updatedAt bevatten.

Hierdoor gedraagt de wiki zich als een geloofslaag en niet als een passieve verzameling notities. Beweringen kunnen worden gevolgd, beoordeeld, betwist en teruggeleid naar bronnen.

Entiteitsmetadata voor agents

Entiteitspagina's bevatten generieke routeringsmetadata die bruikbaar zijn voor personen, teams, systemen, projecten of elk ander entiteitstype:

• entityType: bijvoorbeeld person, team, system, project
• canonicalId: stabiele identiteitssleutel voor aliassen en importen
• aliases: namen, gebruikersnamen of labels die naar dezelfde pagina verwijzen
• privacyTier: vrije tekenreeks; public wordt behandeld als geen beoordeling nodig, elke andere waarde (bijvoorbeeld local-private, sensitive, confirm-before-use) wordt gemarkeerd in reports/privacy-review.md
• bestUsedFor / notEnoughFor: compacte routeringsaanwijzingen
• lastRefreshedAt: tijdstempel van bronvernieuwing, los van de bewerkingstijd van de pagina
• personCard: optionele persoonsgerichte routeringskaart (gebruikersnamen, sociale profielen, e-mailadressen, tijdzone, werkgebied, waarvoor te benaderen, waarvoor niet te benaderen, betrouwbaarheid, privacyniveau)
• relationships: getypeerde verbindingen naar gerelateerde pagina's (doel, soort, gewicht, betrouwbaarheid, bewijssoort, privacyniveau, notitie)

Begin voor een personenwiki met reports/person-agent-directory.md en open vervolgens de persoonspagina met wiki_get voordat je contactgegevens of afgeleide feiten gebruikt.

pageType: entityentityType: personid: entity.example-personcanonicalId: maintainer.example-personaliases:- Alex- example-handleprivacyTier: local-privatebestUsedFor:- Voorbeeldroutering voor ecosysteemnotEnoughFor:- juridische goedkeuringlastRefreshedAt: "2026-04-29T00:00:00.000Z"personCard:handles:  - "@example-handle"socials:  - "https://x.example/example-handle"emails:  - alex@example.comtimezone: America/Chicagolane: VoorbeeldecosysteemaskFor:  - Vragen over voorbeelduitrolavoidAskingFor:  - niet-gerelateerde factureringsbeslissingenconfidence: 0.8privacyTier: confirm-before-userelationships:- targetId: entity.other-person  targetTitle: Andere persoon  kind: collaborates-with  confidence: 0.7  evidenceKind: discrawl-statclaims:- id: claim.example.routing  text: Alex is nuttig voor routering binnen het voorbeeldecosysteem.  status: supported  confidence: 0.9  evidence:    - kind: maintainer-whois      sourceId: source.maintainers      privacyTier: local-private

Compilatiepijplijn

Compile leest wikipagina's, normaliseert samenvattingen en genereert stabiele machinegerichte artefacten onder:

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

Agents en runtimecode lezen deze samenvattingen in plaats van Markdown uit te lezen. Gecompileerde uitvoer ondersteunt ook de eerste fase van wiki-indexering voor zoeken/ophalen, het terugleiden van bewering-ID's naar de bijbehorende pagina's, compacte promptaanvullingen en het genereren van rapporten.

Dashboards en statusrapporten

Wanneer render.createDashboards is ingeschakeld, onderhoudt Compile dashboards onder reports/:

Zoeken en ophalen

Twee zoekbackends:

• shared: gebruik de gedeelde geheugenzoekstroom wanneer deze beschikbaar is
• local: doorzoek de wiki lokaal

Drie corpora: wiki, memory, all.

• wiki_search / wiki_get gebruiken waar mogelijk gecompileerde samenvattingen als eerste fase
• bewering-ID's verwijzen terug naar de bijbehorende pagina
• betwiste/verouderde/actuele beweringen beïnvloeden de rangschikking
• herkomstlabels blijven behouden in resultaten

Zoekmodi (--mode / toolparameter mode):

Wanneer een resultaat overeenkomt met een gestructureerde bewering, retourneert wiki_search matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds en evidenceSourceIds in de detailpayload. Tekstuitvoer bevat waar beschikbaar compacte regels Bewering: en Bewijs:.

Agenttools

De plugin registreert ook een niet-exclusieve aanvulling op het geheugencorpus, zodat gedeelde memory_search en memory_get de wiki kunnen bereiken wanneer de actieve geheugenplugin corpusselectie ondersteunt.

Gedrag van prompts en context

Wanneer context.includeCompiledDigestPrompt is ingeschakeld, voegen geheugenpromptsecties een compacte gecompileerde momentopname uit agent-digest.json toe: alleen de belangrijkste pagina's, alleen de belangrijkste beweringen, het aantal tegenstrijdigheden, het aantal vragen en kwalificaties voor betrouwbaarheid/actualiteit. Dit is optioneel omdat het de promptstructuur wijzigt; het is vooral relevant voor contextengines of promptassemblage die expliciet geheugenaanvullingen gebruiken.

Configuratie

Plaats de configuratie onder 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,          },        },      },    },  },}

Belangrijkste schakelaars:

Kluizen per agent

Stel vault.scope in op agent om elke geconfigureerde agent een afzonderlijke wiki te geven. Binnen dit bereik is vault.path een bovenliggende map en voegt OpenClaw de genormaliseerde agent-id toe:

{  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,          },        },      },    },  },}

Dit wordt herleid tot ~/.openclaw/wiki/support en ~/.openclaw/wiki/marketing. Als vault.path in agentbereik wordt weggelaten, is de bovenliggende map standaard ~/.openclaw/wiki. De standaardagent main behoudt daardoor het bestaande pad ~/.openclaw/wiki/main.

Agenttools, gecompileerde promptdigests en de wiki-aanvulling die via memory_search / memory_get beschikbaar wordt gesteld, herleiden de kluis vanuit de context van de actieve agent. Geef voor CLI- en Gateway-aanroepen in een configuratie met meerdere geconfigureerde agents de agent expliciet op met openclaw wiki --agent <agentId> ... of via agentId in de Gateway-aanvraag. Eén geconfigureerde agent blijft de standaard wanneer geen id wordt opgegeven.

In brugmodus accepteren imports met agentbereik een openbaar geheugenartefact alleen wanneer de geselecteerde agent in de bijbehorende agentIds staat. Artefacten die eigendom zijn van een andere agent, geen eigendomsmetagegevens hebben of een onbekende eigenaar hebben, worden overgeslagen. Globaal bereik behoudt het bestaande gedrag voor gedeelde artefacten.

Voorbeeld: QMD + brugmodus

Gebruik dit wanneer je QMD wilt gebruiken voor het terughalen van informatie en memory-wiki voor een beheerde kennislaag. Elke laag houdt een eigen focus: QMD houdt ruwe notities, sessie-exports en aanvullende verzamelingen doorzoekbaar, terwijl memory-wiki stabiele entiteiten, beweringen, dashboards en bronpagina's compileert.

{  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,          },        },      },    },  },}

Hierdoor blijft QMD verantwoordelijk voor het terughalen uit het actieve geheugen, blijft memory-wiki gericht op gecompileerde pagina's en dashboards en blijft de promptstructuur ongewijzigd totdat je gecompileerde digestprompts bewust inschakelt.

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

Zie CLI: wiki voor de volledige opdrachtreferentie, waaronder wiki okf import, wiki apply metadata, wiki unsafe-local import, wiki chatgpt import / wiki chatgpt rollback en de volledige reeks subopdrachten van wiki obsidian.

Ondersteuning voor Obsidian

Wanneer vault.renderMode is ingesteld op obsidian, schrijft de plugin voor Obsidian geschikte Markdown en kan deze optioneel de officiële obsidian-CLI gebruiken voor het controleren van de status, doorzoeken van de kluis, openen van een pagina, aanroepen van een opdracht en navigeren naar de dagelijkse notitie. Dit is optioneel; de wiki werkt ook zonder Obsidian in de native modus.

Kluizen met agentbereik kunnen nog steeds voor Obsidian geschikte Markdown gebruiken, maar de configuratievalidatie weigert obsidian.useOfficialCli: true in combinatie met vault.scope: "agent". De huidige instelling obsidian.vaultName is globaal en kan niet voor elke agent een afzonderlijke Obsidian-kluis selecteren. Gebruik in plaats daarvan de wikitools en CLI-bewerkingen, of houd een door Obsidian beheerde wiki binnen globaal bereik.

Aanbevolen werkwijze

Gerelateerde documentatie

• Overzicht van geheugen
• CLI: geheugen
• CLI: wiki
• Overzicht van de Plugin-SDK