Motore di memoria QMD

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Cosa aggiunge rispetto al motore integrato

• Reranking ed espansione delle query per un richiamo migliore.
• Indicizzazione di directory aggiuntive — documentazione di progetto, note del team, qualsiasi cosa su disco.
• Indicizzazione delle trascrizioni delle sessioni — richiama conversazioni precedenti.
• Completamente locale — funziona con il pacchetto runtime opzionale node-llama-cpp e scarica automaticamente i modelli GGUF.
• Fallback automatico — se QMD non è disponibile, OpenClaw torna senza interruzioni al motore integrato.

​

Per iniziare

​

Prerequisiti

• Installa QMD: npm install -g @tobilu/qmd o bun install -g @tobilu/qmd
• Build di SQLite che consenta le estensioni (brew install sqlite su macOS).
• QMD deve essere nel PATH del gateway.
• macOS e Linux funzionano subito. Windows è supportato al meglio tramite WSL2.

​

Abilitazione

{
  memory: {
    backend: "qmd",
  },
}

​

Come funziona il sidecar

• OpenClaw crea raccolte dai file di memoria del tuo workspace e da qualsiasi memory.qmd.paths configurato, poi esegue qmd update quando il gestore QMD viene aperto e periodicamente in seguito (predefinito: ogni 5 minuti). Questi aggiornamenti passano attraverso sottoprocessi QMD, non tramite una scansione del filesystem in-process. Anche le modalità semantiche eseguono qmd embed.
• La raccolta predefinita del workspace traccia MEMORY.md più l’albero memory/. memory.md in minuscolo non viene indicizzato come file di memoria radice.
• Lo scanner di QMD ignora i percorsi nascosti e le comuni directory di dipendenze/build come .git, .cache, node_modules, vendor, dist e build. L’avvio del Gateway non inizializza QMD per impostazione predefinita, quindi un avvio a freddo evita di importare il runtime della memoria o di creare il watcher di lunga durata prima che la memoria venga usata per la prima volta.
• Se vuoi comunque un aggiornamento all’avvio del Gateway, imposta memory.qmd.update.startup su idle o immediate. L’aggiornamento all’avvio opzionale usa un percorso di sottoprocesso QMD one-shot invece di creare il watcher completo di lunga durata in-process.
• Le ricerche usano il searchMode configurato (predefinito: search; supporta anche vsearch e query). search è solo BM25, quindi OpenClaw salta i probe di prontezza vettoriale semantica e la manutenzione degli embedding in quella modalità. Se una modalità fallisce, OpenClaw riprova con qmd query.
• Con le versioni di QMD che dichiarano filtri multi-raccolta, OpenClaw raggruppa raccolte con la stessa sorgente in un’unica invocazione di ricerca QMD. Le versioni QMD più vecchie mantengono il fallback compatibile per raccolta.
• Se QMD fallisce completamente, OpenClaw torna al motore SQLite integrato. Tentativi ripetuti durante i turni di chat applicano un breve backoff dopo un errore di apertura, così un binario mancante o una dipendenza del sidecar rotta non crea una tempesta di tentativi; openclaw memory status e i probe CLI one-shot ricontrollano comunque QMD direttamente.

​

Prestazioni di ricerca e compatibilità

qmd search "router notes" --json -n 10 -c memory-root-main -c memory-dir-main

qmd --help | grep -i collection

​

Override dei modelli

export QMD_EMBED_MODEL="hf:Qwen/Qwen3-Embedding-0.6B-GGUF/Qwen3-Embedding-0.6B-Q8_0.gguf"
export QMD_RERANK_MODEL="/absolute/path/to/reranker.gguf"
export QMD_GENERATE_MODEL="/absolute/path/to/generator.gguf"

​

Indicizzazione di percorsi aggiuntivi

{
  memory: {
    backend: "qmd",
    qmd: {
      paths: [{ name: "docs", path: "~/notes", pattern: "**/*.md" }],
    },
  },
}

​

Indicizzazione delle trascrizioni di sessione

{
  memory: {
    backend: "qmd",
    qmd: {
      sessions: { enabled: true },
    },
  },
}

​

Ambito di ricerca

{
  memory: {
    qmd: {
      scope: {
        default: "deny",
        rules: [{ action: "allow", match: { chatType: "direct" } }],
      },
    },
  },
}

​

Citazioni

​

Quando usarlo

• Reranking per risultati di qualità più alta.
• Cercare documentazione o note di progetto fuori dal workspace.
• Richiamare conversazioni di sessioni passate.
• Ricerca completamente locale senza chiavi API.

​

Risoluzione dei problemi

{
  memory: {
    backend: "qmd",
    qmd: {
      command: "/absolute/path/to/qmd",
    },
  },
}

​

Configurazione

​

Correlati

• Panoramica della memoria
• Motore di memoria integrato
• Memoria Honcho