OpenClaw Memoria QMD: Catch Silent Fallback

La risposta sicura è: Non trattare una ricerca di memoria OpenClaw con successo come prova che QMD è sano . Provi prima che il gateway possa risolvere il binario QMD e che il QMD non è stato il fallback di costruzione che ha servito la ricerca. Poi applicare i controlli di disponibilità richiesti dalla modalità di ricerca configurata, confermare che l'indice è fresco e recuperare un canario sintetico. Questa distinzione è importante perché OpenClaw torna deliberatamente al suo motore di memoria integrato se QMD fallisce. Il fallback conserva un comportamento di memoria utile, ma cambia il fatto che viene testato. Un risultato può essere valido in quanto OpenClaw ha trovato una memoria mentre è invalido in quanto il backend QMD configurato è pronto. La regola di funzionamento di questa guida è: QMD è sano solo quando la disponibilità eseguibile, il backend efficace, la freschezza degli aggiornamenti, la disponibilità specifica per la modalità e il recupero di canarie concordano. Questo e' piu' stretto che dimostrare che un agente si ricordava la cosa giusta in ogni situazione. Si tratta di un ricevimento di salute backend: prova che il percorso di recupero previsto è disponibile e sufficientemente attuale per il prossimo passo di memoria dipendente. Una query verde può nascondere il backend sbagliato Documentazione QMD di OpenClaw descrive QMD come un sidecar locale primo che combina BM25, ricerca vettoriale e rilancio. OpenClaw crea collezioni gestite, esegue aggiornamenti e quando le modalità semantiche ne hanno bisogno, mantiene le inserzioni. Essa documenta anche il retrocesso automatico al motore SQLite costruito quando QMD non può aprire. Il fallback è una ragionevole caratteristica di disponibilità. Non sono prove QMD. Consideriamo due versioni che recuperano la stessa frase sintetica: L'osservazione Correre A Corsa B Consigliato backend qmd qmd Query restituisce il canario Sì. Sì. Un backend efficace qmd builtin Verdetto della QMD candidato sano attivo a caduta Il testo restituito non può distinguere quelle corse. L'identità di backend deve avere maggiore priorità rispetto al successo del recupero. Inizia nell'ambiente che effettivamente lancia il gateway. Un guscio interattivo può avere un PATH diverso da un servizio: Il primo comando dovrebbe risolvere un eseguibile. Il secondo registra una versione. Il terzo chiede a OpenClaw di sondare lo stato della memoria piuttosto che fidarsi di un fallimento di chat in cache. Se qmd version funziona solo nel shell di accesso, le linee guida ufficiali per la risoluzione dei problemi raccomandano di inserire un memory.qmd.command assoluto e di verificare nuovamente dall'ambiente gateway. Non registrare l'intero ambiente di servizio per dimostrarlo. Una ricevuta utile richiede solo: La versione di cui sopra è un esempio dell'attuale istantanea di ricerca, non un requisito minimo. L'ultimo rilascio di QMD GitHub osservato per questo articolo è stato V2.5.3, pubblicato il 29 maggio 2026. OpenClaw mantiene percorsi di compatibilità per le vecchie forme di collezione QMD e MCP, quindi not latest non è automaticamente unhealthy. Registrare la versione perché la compatibilità, la diagnostica e i campi di uscita cambiano. Sul runner di pubblicazione utilizzato per questo articolo, è stato installato OpenClaw 2026.7.1 2 e il suo archivio di memoria di buildtin configurato è stato riportato pronto, mentre qmd version ha restituito command not found . Questo non era un test di interruzione QMD. Il corridore non era configurato come un dispiegamento QMD. Si trattava di un'utile osservazione dei confini: un sano comando di memoria OpenClaw e la disponibilità di QMD sono fatti separati. La preparazione dipende da searchMode QMD dispone di tre modalità di ricerca pertinenti nell'attuale contratto OpenClaw: search è BM25 lessico. vsearch utilizza prove vettoriali. query utilizza il percorso ibrido/modello e può includere un rilancio. La riferimento di configurazione della memoria indica esplicitamente che la search è solo BM25. OpenClaw salta le sonde di preparazione dei vettori semantici e inserisce la manutenzione in tale modalità. Pertanto, una regola generale come incorporazioni in sospeso significa che la memoria è malsana è sbagliata. Utilizzare questo gate di modalità: Modalità di ricerca Richiesta di raccolta fresca Non sono richieste embezzature in sospeso Canario richiesto search Sì. No Sì. vsearch Sì. Sì. Sì. query Sì. Sì. Sì. Questa non è un argomento per la ricerca lessica rispetto alla ricerca semantica. Essa impedisce a un verificatore sanitario di imporre una dipendenza che la modalità selezionata non utilizza. L'intervallo di aggiornamento QMD standard documentato di OpenClaw è di cinque minuti, mentre l'intervallo di inserimento è di sessanta minuti. Questi valori descrivono la pianificazione, non una soglia sanitaria universale. Costruire un contratto di noleggio di freschezza sulla base della vostra configurazione e della tolleranza operativa: Ad esempio, un intervallo di cinque minuti, un aggiornamento normale peggiore di novanta secondi e un margine di trenta secondi dà un contratto di locazione di sette minuti. In base a tale politica, l'età di aggiornamento di 421 secondi è obsoleta; 419 secondi sono ancora nel contratto di locazione. Non allungare in silenzio il contratto di locazione dopo un avviso. Se gli aggiornamenti superano regolarmente il limite, o fissare il carico di lavoro o rivedere la politica con prove registrate. Altrimenti un indice obsoleto diventa sempre verde. La prima query semantica può essere insolitamente lenta perché QMD può scaricare circa 2 GB di modelli GGUF per l'espansione della query e il rilancio. Ciò rende l'attesa della dipendenza documentata per la prima volta diversa da quella di permanenza. Metti una finestra di installazione o di riscaldamento limitata intorno alla prima sonda, quindi richiedi una prova di progresso o fermo. Costruire un canario che dimostri il percorso gestito Un canario deve essere sintetico, unico e sicuro da conservare. Non dovrebbe contenere un fatto del cliente, un prompt, una chiave API, un indirizzo e mail o una vera decisione di attività. Crea un file Markdown sotto una raccolta che OpenClaw gestisce effettivamenteper la raccolta di spazio di lavoro predefinita, cioè MEMORY.md o l'albero memory/ . Utilizzare un token come: Registrare il suo percorso di sorgente relativo e il hash di contenuto, permettere al ciclo di aggiornamento configurato di completare, quindi cercare il token esatto attraverso OpenClaw: La ricevuta dovrebbe stabilire: 1. il file sorgente appartiene alla raccolta gestita prevista; 2. l'ultimo aggiornamento di successo è stato effettuato nell'ambito del contratto di locazione di freschezza; 3. i vettori semantici sono pronti se la modalità ne ha bisogno; 4. il backend effettivo è QMD; 5. il canario esatto viene restituito dalla fonte attesa. Un risultato vuoto non dimostra immediatamente che il QMD è rotto. I contratti ufficiali indicano diverse spiegazioni più restrittive: percorsi nascosti vengono ignorati, la radice minore memory.md non è la stessa di MEMORY.md , la portata di gruppo/canale viene negata per impostazione predefinita e i modelli di percorso aggiuntivi possono escludere un file. Conserva quelle distinzioni in modo che la riparazione rimanga limitata. Evitare di invocare manualmente qmd update con directory XDG arbitrari. OpenClaw dà a ogni agente una casa QMD gestita in autonomia. Un comando diretto nell'ambiente sbagliato può testare un indice diverso e produrre un risultato verde convincente ma irrilevante. Allo stesso modo, non utilizzare un solo canario di successo per pretendere un'ampia qualità di richiamo. Il canario dimostra che un documento conosciuto ha attraversato il percorso attuale di ingestione e recupero. Un benchmark rappresentativo di richiamo, il test di continuità decisionale e la verifica dei risultati a valle rimangono separati. Riproduci il verdetto prima di inviare un allarme L'artefatto creato per questo articolo accetta una ricevuta JSON normalizzata e restituisce uno stato. La sua priorità è intenzionale: 1. config drift 2. qmd unavailable 3. fallback active 4. stale index 5. vector not ready 6. retrieval failed 7. healthy Ecco la decisione fondamentale: La riproduzione di sei casi ha prodotto sei verdetti attesi: Caso Importanti prove Verdicto BM25 con 27 incrustazioni in sospeso modo è search , canario trovato healthy Manca il binario QMD comando non risolto qmd unavailable Canaria trovata attraverso il builtin l'effettivo backend è costruito fallback active 721 anni di raccolta, 420 anni di locazione aggiornamento stale stale index Modalità di interrogazione con 14 inserimenti in sospeso Vettori incompleti vector not ready Modalità vettoriale fresca, senza canarie assente di recupero retrieval failed Questa riproduzione aggiunge due controlli utili. Innanzitutto, il builtin fallback non può prendere in prestito un risultato verde dallo strato di recupero. In secondo luogo, la ricerca BM25 non eredita una falsa dipendenza dalla manutenzione dei vettori. Ogni stato non sano ottiene una successiva azione: QMD non disponibile: risolvere il binario dall'ambiente gateway e rivedere la sonda. Fallback attivo: ispezionare il fallimento aperto di QMD; non disattivare il fallback solo per rendere il controllo rosso. Stale index: attendere o eseguire il percorso di aggiornamento gestito, quindi verificare un nuovo tempo di successo. Vettori non pronti: finitura di inserimento per il modello attivo e verifica la coerenza delle impronte digitali con le diagnosi QMD attuali. Retrieval fallito: ispezionare la portata della raccolta, il modello di file, le prove di aggiornamento e il token esatto prima di ricostruire qualsiasi cosa. Ricostruire ogni indice non è la riparazione predefinita. Aumenta il costo e distrugge le prove che potrebbero distinguere un errore di percorso da un errore di freschezza. Scadere la ricevuta e mantenere la conclusione stretta Una ricevuta sana è limitata a tempo. Immagazzinare il tempo di controllo, modalità configurata, versione QMD, backend efficace, ultima aggiornamento riuscito, conteggio di vettori in sospeso, se del caso, hash di sorgente canaria e verdetto. Scade quando il contratto di locazione della freschezza scade o uno di questi input cambia. La ricevuta dimostra: il QMD eseguibile previsto era raggiungibile; OpenClaw utilizzava QMD al momento del controllo; l'indice gestito è stato sufficientemente fresco; le dipendenze della modalità selezionata sono state pronte; un elemento sicuro conosciuto era recuperabile. Znot dimostra che ogni memoria è rilevante, che ogni decisione è sopravvissuta alla compressione, che i dati privati sono correttamente classificati o che un agente ha prodotto il prodotto destinato. Queste hanno bisogno di prove separate. La direzione del prodotto di Sidewisp è quella di rendere visibili i confini di salute come questi nei tempi di esecuzione degli agenti: identificare ciò che funziona, esporre le prove, distinguere l'attesa dal fallimento e preservare l'autorità umana sulle riparazioni. Sidewisp è attualmente in anteprima privata. L'adattatore e il motore di monitoraggio OpenClaw di produzione non sono generalmente spediti, quindi questa guida è un modello operativo che si può attuare ogginon è una affermazione che Sidewisp esegui già questi controlli QMD. Se un'attività dipendente dalla memoria è importante, richiedere la ricevuta prima dell'inizio dell'attività e verificare il risultato effettivo dell'attività in seguito. Ciò chiude entrambi i vuoti false green: la memoria ha funzionato senza QMD, e il QMD ha funzionato senza che il lavoro fosse svolto.