Il wiki della memoria di OpenClaw

Le semplici note di memoria rispondono alla domanda su cosa ricorda l’agente; non dicono quanto ne è sicuro, da dove viene un fatto o quali due note si contraddicono. Il plugin memory-wiki incluso in OpenClaw aggiunge questo livello. Compila la conoscenza duratura in un wiki navigabile fatto di pagine deterministiche, affermazioni strutturate con evidenze, provenienza, dashboard e digest leggibili dalle macchine, e si affianca al plugin di memoria attivo invece di sostituirlo: richiamo, promozione, indicizzazione e dreaming restano al plugin di memoria configurato. Ecco le modalità del vault, la struttura, il modello delle affermazioni, la pipeline di compilazione, i report, gli strumenti e le avvertenze sui vault per agente.

Modalità, ambito, struttura

• Tre modalità del vault: isolated, quella predefinita, con vault e fonti propri e nessuna dipendenza dal plugin di memoria; bridge, che legge gli artefatti di memoria pubblici e i log degli eventi dal plugin di memoria attivo attraverso i punti di aggancio pubblici dell’SDK dei plugin, indicizzando, secondo i singoli interruttori, gli artefatti esportati, le note giornaliere, i report di dreaming e i log degli eventi di memoria; e unsafe-local, una via di fuga esplicita sulla stessa macchina per percorsi privati, sperimentale e non portabile.
• L’ambito del vault è una scelta separata: global, quello predefinito, mantiene un unico vault condiviso, mentre l’ambito agent dà a ogni agente un vault figlio, così gli agenti non possono condividere pagine, digest, risultati di ricerca o scritture; l’ambito agent non si può combinare con la modalità unsafe-local, e la validazione lo rifiuta.
• Il vault contiene le note di primo livello per l’agente e per il wiki, un indice e un’inbox, e le cartelle per entità, concetti, sintesi, fonti, report, allegati e viste; il contenuto gestito resta all’interno dei blocchi generati e i blocchi di note scritti a mano sopravvivono alla rigenerazione.
• I bundle in Open Knowledge Format vengono importati come pagine di concetto, conservando il frontmatter originale con id del concetto, tipo, risorsa, tag, timestamp e producer, con i link interni riscritti verso le pagine del wiki ed emessi come relazioni strutturate.

Così il wiki si comporta come un livello di convinzioni, non come un deposito passivo di note.

Affermazioni, entità, compilazione

Le pagine riportano affermazioni strutturate nel frontmatter, ciascuna con un id, un testo, uno stato, un livello di confidenza, voci di evidenza e un orario di aggiornamento, dove ogni evidenza riporta un tipo, un id della fonte, un percorso, le righe, un peso, una confidenza, un livello di privacy e una nota; le affermazioni possono essere tracciate, valutate, contestate e ricondotte alle fonti. Le pagine delle entità aggiungono metadati di instradamento utilizzabili per persone, team, sistemi o progetti: un tipo di entità, un id canonico, alias, un livello di privacy in cui tutto ciò che non è public viene segnalato per la revisione, i suggerimenti best-used-for e not-enough-for, un timestamp di aggiornamento, una scheda persona facoltativa con handle, profili social, email, fuso orario, lane e gli elenchi ask-for e avoid-asking-for, e relazioni tipizzate. La compilazione legge le pagine, normalizza i riepiloghi e salva uno snapshot destinato alle macchine nello stato condiviso dei plugin di OpenClaw su SQLite; la preparazione dei prompt in fase di esecuzione carica quello snapshot in modo asincrono e non estrae mai dati dal Markdown né legge file di cache, le modifiche alle fonti diventano visibili alle macchine solo dopo la compilazione successiva, e una pubblicazione della compilazione con concatenazione causale permette a un aggiornamento del ciclo di vita di rifiutare uno snapshot proveniente da uno stato più recente poi annullato con un rollback. Le cache compilate si possono ricostruire e vengono sostituite, non migrate.

Report, ricerca, strumenti

• Con le dashboard attivate, la compilazione mantiene report su domande aperte, contraddizioni, pagine e affermazioni a bassa confidenza, affermazioni prive di evidenze strutturate, pagine obsolete, la rubrica di persone e agenti, il grafo delle relazioni, la copertura della provenienza e una revisione della privacy dei livelli non pubblici.
• La ricerca ha un backend condiviso, che usa il flusso di ricerca della memoria quando è disponibile, e uno locale che cerca solo nel wiki, tre corpora (wiki, memory e all) e cinque modalità: auto, find-person, route-question, source-evidence e raw-claim; un risultato su un’affermazione strutturata restituisce l’id dell’affermazione, lo stato, la confidenza, i tipi di evidenza e gli id delle fonti, e le affermazioni contestate, obsolete o recenti influenzano l’ordinamento.
• Cinque strumenti per gli agenti: wiki status, wiki search, wiki get, wiki apply per sintesi mirate e modifiche ai metadati senza interventi a mano libera sulle pagine, e wiki lint per controlli strutturali, lacune nella provenienza, contraddizioni e domande aperte; il plugin registra anche un supplemento di corpus non esclusivo, così la ricerca e il get della memoria condivisa raggiungono il wiki quando il plugin di memoria supporta la selezione del corpus.

La guida alla memoria di OpenClaw descrive il livello accanto a cui si colloca questo plugin, e la ricerca nella memoria di OpenClaw è l’unico passaggio di richiamo ampio che la documentazione consiglia ancora di fare per primo.

L’interfaccia e le avvertenze

La Control UI permette di sfogliare il wiki compilato dalla pagina della memoria, nelle schede Dreams e Diary: raggruppa le pagine di sintesi, di entità e di concetto con i conteggi per pagina, apre il contenuto in linea attraverso la stessa ricerca usata dallo strumento get, limita ogni dashboard alle 2.500 schede più recenti e non scansiona mai le pagine grezze del vault né attende una compilazione completa. Il digest compilato può essere aggiunto alle sezioni di memoria del prompt, con le pagine e le affermazioni principali e i conteggi di contraddizioni e domande, ma è facoltativo perché cambia la forma del prompt. Cambiare l’ambito del vault non copia né divide un vault esistente, e i vault per agente sono un confine di conoscenza all’interno dello stesso processo, non un confine del sistema operativo, perché gli strumenti fuori dalla sandbox con accesso al filesystem dell’host possono comunque leggere la directory di un altro agente. Il dreaming di OpenClaw è il consolidamento proprio del plugin di memoria che la modalità bridge può indicizzare, e il sandboxing di OpenClaw il confine a cui rimanda la documentazione quando gli agenti non si fidano l’uno dell’altro.

Su Diali

Su Diali il plugin è incluso nell’immagine del motore, e una volta attivato il suo vault finisce sul volume persistente dell’assistente, nella directory di stato; il confine per agente conta meno qui, perché ogni istanza esegue il proprio assistente. OpenClaw ospitato su Diali è l’assistente e la guida ai plugin di OpenClaw spiega come si attivano i plugin inclusi.

• Un livello di convinzioni accanto alla memoria, non un suo sostituto.
• Affermazioni con evidenze, compilate in SQLite, riportate nelle dashboard.
• Isolated per impostazione predefinita; bridge per indicizzare ciò che la memoria esporta.