Wiki della memoria

memory-wiki è un Plugin incluso che trasforma la memoria durevole in un vault di conoscenza compilato. Non sostituisce il Plugin Active Memory. Il Plugin Active Memory continua a gestire richiamo, promozione, indicizzazione e Dreaming. memory-wiki gli si affianca e compila la conoscenza durevole in una wiki navigabile con pagine deterministiche, dichiarazioni strutturate, provenienza, dashboard e digest leggibili dalle macchine. Usalo quando vuoi che la memoria si comporti più come un livello di conoscenza mantenuto e meno come una pila di file Markdown.

Cosa aggiunge

Un vault wiki dedicato con layout di pagina deterministico
Metadati strutturati per dichiarazioni ed evidenze, non solo prosa
Provenienza, attendibilità, contraddizioni e domande aperte a livello di pagina
Digest compilati per agenti e consumatori runtime
Strumenti nativi della wiki per ricerca/lettura/applicazione/lint
Modalità bridge opzionale che importa artefatti pubblici dal Plugin Active Memory
Modalità di rendering opzionale compatibile con Obsidian e integrazione CLI

Come si integra con la memoria

Pensa alla separazione così:

Livello	Gestisce
Plugin Active Memory (`memory-core`, QMD, Honcho, ecc.)	Richiamo, ricerca semantica, promozione, Dreaming, runtime della memoria
`memory-wiki`	Pagine wiki compilate, sintesi ricche di provenienza, dashboard, ricerca/lettura/applicazione specifiche della wiki

Se il Plugin Active Memory espone artefatti di richiamo condivisi, OpenClaw può cercare in entrambi i livelli in un solo passaggio con memory_search corpus=all. Quando ti servono ranking specifico della wiki, provenienza o accesso diretto alle pagine, usa invece gli strumenti nativi della wiki.

Pattern ibrido consigliato

Un buon valore predefinito per configurazioni local-first è:

QMD come backend Active Memory per richiamo e ricerca semantica ampia
memory-wiki in modalità bridge per pagine di conoscenza durevole sintetizzata

Questa separazione funziona bene perché ogni livello resta focalizzato:

QMD mantiene ricercabili note grezze, esportazioni di sessione e raccolte aggiuntive
memory-wiki compila entità stabili, dichiarazioni, dashboard e pagine sorgente

Regola pratica:

usa memory_search quando vuoi un unico passaggio di richiamo ampio sulla memoria
usa wiki_search e wiki_get quando vuoi risultati wiki consapevoli della provenienza
usa memory_search corpus=all quando vuoi che la ricerca condivisa copra entrambi i livelli

Se la modalità bridge segnala zero artefatti esportati, il Plugin Active Memory non sta ancora esponendo input bridge pubblici. Esegui prima openclaw wiki doctor, poi conferma che il Plugin Active Memory supporti artefatti pubblici. Quando la modalità bridge è attiva e bridge.readMemoryArtifacts è abilitato, openclaw wiki status, openclaw wiki doctor e openclaw wiki bridge import leggono attraverso il Gateway in esecuzione. Questo mantiene i controlli bridge della CLI allineati al contesto runtime del Plugin della memoria. Se bridge è disabilitato o le letture degli artefatti sono disattivate, quei comandi mantengono il loro comportamento locale/offline.

Modalità del vault

memory-wiki supporta tre modalità del vault:

`isolated`

Vault proprio, sorgenti proprie, nessuna dipendenza da memory-core. Usa questa modalità quando vuoi che la wiki sia il suo archivio di conoscenza curato.

`bridge`

Legge artefatti di memoria pubblici ed eventi di memoria dal Plugin Active Memory attraverso seam pubblici del plugin SDK. Usa questa modalità quando vuoi che la wiki compili e organizzi gli artefatti esportati dal Plugin della memoria senza accedere agli internals privati del Plugin. La modalità bridge può indicizzare:

artefatti di memoria esportati
report di dream
note giornaliere
file radice della memoria
log degli eventi di memoria

`unsafe-local`

Escape hatch esplicita per percorsi privati locali sulla stessa macchina. Questa modalità è intenzionalmente sperimentale e non portabile. Usala solo quando comprendi il confine di fiducia e ti serve specificamente accesso al filesystem locale che la modalità bridge non può fornire.

Layout del vault

Il Plugin inizializza un vault così:

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

Il contenuto gestito resta dentro blocchi generati. I blocchi di note umane sono preservati. I gruppi di pagine principali sono:

sources/ per materiale grezzo importato e pagine supportate da bridge
entities/ per cose durevoli, persone, sistemi, progetti e oggetti
concepts/ per idee, astrazioni, pattern e policy
syntheses/ per riepiloghi compilati e rollup mantenuti
reports/ per dashboard generate

Dichiarazioni strutturate ed evidenze

Le pagine possono contenere frontmatter claims strutturati, non solo testo libero. Ogni dichiarazione può includere:

id
text
status
confidence
evidence[]
updatedAt

Le voci di evidenza possono includere:

kind
sourceId
path
lines
weight
confidence
privacyTier
note
updatedAt

Questo fa sì che la wiki agisca più come un livello di convinzioni che come un deposito passivo di note. Le dichiarazioni possono essere tracciate, valutate, contestate e ricondotte alle fonti.

Metadati di entità rivolti agli agenti

Le pagine entità possono anche contenere metadati di routing per l’uso da parte degli agenti. Questo è frontmatter generico, quindi funziona per persone, team, sistemi, progetti o qualsiasi altro tipo di entità. I campi comuni includono:

entityType: ad esempio person, team, system o project
canonicalId: chiave di identità stabile usata tra alias e importazioni
aliases: nomi, handle o etichette che devono risolversi alla stessa pagina
privacyTier: public, local-private, sensitive o confirm-before-use
bestUsedFor / notEnoughFor: indicazioni compatte di routing
lastRefreshedAt: timestamp di aggiornamento della sorgente separato dall’orario di modifica della pagina
personCard: scheda di routing opzionale specifica per persona con handle, social, email, fuso orario, corsia, chiedere-per, evitare-di-chiedere-per, attendibilità e privacy
relationships: archi tipizzati verso pagine correlate con destinazione, tipo, peso, attendibilità, tipo di evidenza, livello di privacy e nota

Per una wiki delle persone, l’agente dovrebbe di solito iniziare da reports/person-agent-directory.md, poi aprire la pagina della persona con wiki_get prima di usare dettagli di contatto o fatti inferiti. Esempio:

pageType: entity
entityType: person
id: entity.brad-groux
canonicalId: maintainer.brad-groux
aliases:
  - Brad
  - bgroux
privacyTier: local-private
bestUsedFor:
  - Microsoft Teams and Azure routing
notEnoughFor:
  - legal approval
lastRefreshedAt: "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-use
relationships:
  - targetId: entity.alice
    targetTitle: Alice
    kind: collaborates-with
    confidence: 0.7
    evidenceKind: discrawl-stat
claims:
  - 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

Pipeline di compilazione

Il passaggio di compilazione legge le pagine wiki, normalizza i riepiloghi ed emette artefatti stabili rivolti alle macchine sotto:

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

Questi digest esistono perché agenti e codice runtime non debbano estrarre informazioni dalle pagine Markdown. L’output compilato alimenta anche:

indicizzazione wiki di primo passaggio per flussi search/get
lookup degli ID delle dichiarazioni verso le pagine proprietarie
supplementi compatti per prompt
generazione di report/dashboard

Dashboard e report di salute

Quando render.createDashboards è abilitato, la compilazione mantiene dashboard sotto reports/. I report integrati includono:

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

Questi report tracciano aspetti come:

cluster di note di contraddizione
cluster di dichiarazioni concorrenti
dichiarazioni prive di evidenza strutturata
pagine e dichiarazioni a bassa attendibilità
freschezza obsoleta o sconosciuta
pagine con domande irrisolte
schede di routing persona/entità
archi di relazione strutturati
copertura delle classi di evidenza
livelli di privacy non pubblici che richiedono revisione prima dell’uso

Ricerca e recupero

memory-wiki supporta due backend di ricerca:

shared: usa il flusso di ricerca memoria condiviso quando disponibile
local: cerca localmente nella wiki

Supporta anche tre corpora:

wiki
memory
all

Comportamento importante:

wiki_search e wiki_get usano digest compilati come primo passaggio quando possibile
gli ID delle dichiarazioni possono risolversi alla pagina proprietaria
dichiarazioni contestate/obsolete/fresche influenzano il ranking
le etichette di provenienza possono sopravvivere nei risultati
la modalità di ricerca può orientare il ranking per ricerca persona, routing domande, evidenza sorgente o dichiarazioni grezze

Regola pratica:

usa memory_search corpus=all per un unico passaggio di richiamo ampio
usa wiki_search + wiki_get quando ti interessano ranking specifico della wiki, provenienza o struttura delle convinzioni a livello di pagina

Modalità di ricerca:

auto: valore predefinito bilanciato
find-person: dà priorità a entità simili a persone, alias, handle, social e ID canonici
route-question: dà priorità a schede agente, indicazioni ask-for, indicazioni best-used-for e contesto delle relazioni
source-evidence: dà priorità a pagine sorgente e metadati di evidenza strutturata
raw-claim: dà priorità alle dichiarazioni strutturate corrispondenti e restituisce metadati di dichiarazione/evidenza nei risultati

Quando un risultato corrisponde a una dichiarazione strutturata, wiki_search può restituire matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds e evidenceSourceIds nel suo payload di dettagli. L’output testuale include anche righe compatte Claim: ed Evidence: quando disponibili.

Strumenti per agenti

Il Plugin registra questi strumenti:

wiki_status
wiki_search
wiki_get
wiki_apply
wiki_lint

Cosa fanno:

wiki_status: modalità vault corrente, salute, disponibilità della CLI Obsidian
wiki_search: cerca pagine wiki e, quando configurato, corpora di memoria condivisi; accetta mode per ricerca persona, routing domande, evidenza sorgente o drilldown su dichiarazioni grezze
wiki_get: legge una pagina wiki per id/percorso o ripiega sul corpus di memoria condiviso
wiki_apply: mutazioni mirate di sintesi/metadati senza interventi liberi sulla pagina
wiki_lint: controlli strutturali, lacune di provenienza, contraddizioni, domande aperte

Il Plugin registra anche un supplemento di corpus di memoria non esclusivo, così memory_search e memory_get condivisi possono raggiungere la wiki quando il Plugin Active Memory supporta la selezione del corpus.

Comportamento di prompt e contesto

Quando context.includeCompiledDigestPrompt è abilitato, le sezioni del prompt di memoria aggiungono uno snapshot compilato compatto da agent-digest.json. Quello snapshot è intenzionalmente piccolo e ad alto segnale:

solo pagine principali
solo dichiarazioni principali
conteggio delle contraddizioni
conteggio delle domande
qualificatori di attendibilità/freschezza

È opt-in perché cambia la forma del prompt ed è utile principalmente per motori di contesto o assemblaggio legacy di prompt che consumano esplicitamente supplementi di memoria.

Configurazione

Metti la configurazione sotto 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,
          },
        },
      },
    },
  },
}

Opzioni principali:

vaultMode: isolated, bridge, unsafe-local
vault.renderMode: native o obsidian
bridge.readMemoryArtifacts: importa gli artefatti pubblici del Plugin Active Memory
bridge.followMemoryEvents: include i log degli eventi in modalità bridge
search.backend: shared o local
search.corpus: wiki, memory o all
context.includeCompiledDigestPrompt: aggiungi lo snapshot del digest compatto alle sezioni del prompt di memoria
render.createBacklinks: genera blocchi correlati deterministici
render.createDashboards: genera pagine dashboard

Esempio: QMD + modalità bridge

Usalo quando vuoi QMD per il richiamo e memory-wiki per un livello di conoscenza mantenuto:

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

Questo mantiene:

QMD responsabile del richiamo di Active Memory
memory-wiki focalizzato su pagine compilate e dashboard
la forma del prompt invariata finché non abiliti intenzionalmente i prompt con digest compilato

CLI

memory-wiki espone anche una superficie CLI di primo livello:

openclaw wiki status
openclaw wiki doctor
openclaw wiki init
openclaw wiki ingest ./notes/alpha.md
openclaw wiki compile
openclaw wiki lint
openclaw wiki search "alpha"
openclaw wiki get entity.alpha
openclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alpha
openclaw wiki bridge import
openclaw wiki obsidian status

Consulta CLI: wiki per il riferimento completo dei comandi.

Supporto Obsidian

Quando vault.renderMode è obsidian, il Plugin scrive Markdown compatibile con Obsidian e può facoltativamente usare la CLI ufficiale obsidian. I flussi di lavoro supportati includono:

verifica dello stato
ricerca nel vault
apertura di una pagina
invocazione di un comando Obsidian
passaggio alla nota giornaliera

Questo è facoltativo. La wiki funziona comunque in modalità nativa senza Obsidian.

Flusso di lavoro consigliato

Mantieni il tuo Plugin Active Memory per richiamo/promozione/dreaming.
Abilita memory-wiki.
Inizia con la modalità isolated a meno che tu non voglia esplicitamente la modalità bridge.
Usa wiki_search / wiki_get quando la provenienza è importante.
Usa wiki_apply per sintesi mirate o aggiornamenti dei metadati.
Esegui wiki_lint dopo modifiche significative.
Attiva le dashboard se vuoi visibilità su contenuti obsoleti o contraddizioni.

Documentation Index

​Cosa aggiunge

​Come si integra con la memoria

​Pattern ibrido consigliato

​Modalità del vault

​isolated

​bridge

​unsafe-local

​Layout del vault

​Dichiarazioni strutturate ed evidenze

​Metadati di entità rivolti agli agenti

​Pipeline di compilazione

​Dashboard e report di salute

​Ricerca e recupero

​Strumenti per agenti

​Comportamento di prompt e contesto

​Configurazione

​Esempio: QMD + modalità bridge

​CLI

​Supporto Obsidian

​Flusso di lavoro consigliato

​Documentazione correlata