Silnik pamięci 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.

​

Co dodaje względem wbudowanego rozwiązania

• Ponowne rankingowanie i rozszerzanie zapytań dla lepszego przywoływania wyników.
• Indeksowanie dodatkowych katalogów — dokumentacji projektu, notatek zespołu, wszystkiego na dysku.
• Indeksowanie transkrypcji sesji — przywoływanie wcześniejszych rozmów.
• W pełni lokalne — działa z opcjonalnym pakietem runtime node-llama-cpp i automatycznie pobiera modele GGUF.
• Automatyczne przełączenie awaryjne — jeśli QMD jest niedostępne, OpenClaw płynnie wraca do wbudowanego silnika.

​

Pierwsze kroki

​

Wymagania wstępne

• Zainstaluj QMD: npm install -g @tobilu/qmd albo bun install -g @tobilu/qmd
• Kompilacja SQLite pozwalająca na rozszerzenia (brew install sqlite w macOS).
• QMD musi znajdować się w PATH Gateway.
• macOS i Linux działają od razu. Windows jest najlepiej obsługiwany przez WSL2.

​

Włączanie

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

​

Jak działa proces pomocniczy

• OpenClaw tworzy kolekcje z plików pamięci Twojego obszaru roboczego oraz wszystkich skonfigurowanych memory.qmd.paths, a następnie uruchamia qmd update, gdy menedżer QMD zostaje otwarty, i okresowo później (domyślnie co 5 minut). Te odświeżenia przebiegają przez podprocesy QMD, a nie przez wewnątrzprocesowe skanowanie systemu plików. Tryby semantyczne uruchamiają też qmd embed.
• Domyślna kolekcja obszaru roboczego śledzi MEMORY.md oraz drzewo memory/. memory.md zapisany małymi literami nie jest indeksowany jako główny plik pamięci.
• Własny skaner QMD ignoruje ukryte ścieżki i typowe katalogi zależności/kompilacji, takie jak .git, .cache, node_modules, vendor, dist i build. Uruchomienie Gateway domyślnie nie inicjuje QMD, więc zimny start unika importowania runtime pamięci lub tworzenia długotrwałego obserwatora przed pierwszym użyciem pamięci.
• Jeśli mimo to chcesz odświeżania przy starcie Gateway, ustaw memory.qmd.update.startup na idle albo immediate. Opcjonalne odświeżanie przy starcie używa jednorazowej ścieżki podprocesu QMD zamiast tworzyć pełny długotrwały obserwator wewnątrz procesu.
• Wyszukiwania używają skonfigurowanego searchMode (domyślnie: search; obsługuje też vsearch i query). search działa wyłącznie na BM25, więc OpenClaw pomija semantyczne sondy gotowości wektorów i utrzymanie osadzeń w tym trybie. Jeśli tryb zawiedzie, OpenClaw ponawia próbę z qmd query.
• W wydaniach QMD, które deklarują filtry wielu kolekcji, OpenClaw grupuje kolekcje z tego samego źródła w jedno wywołanie wyszukiwania QMD. Starsze wydania QMD zachowują zgodne przełączenie awaryjne na pojedyncze kolekcje.
• Jeśli QMD całkowicie zawiedzie, OpenClaw wraca do wbudowanego silnika SQLite. Powtarzające się próby w turach czatu wycofują się na krótko po błędzie otwarcia, aby brakujący plik binarny lub uszkodzona zależność procesu pomocniczego nie stworzyły burzy ponowień; openclaw memory status i jednorazowe sondy CLI nadal sprawdzają QMD bezpośrednio.

​

Wydajność wyszukiwania i zgodność

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

qmd --help | grep -i collection

​

Nadpisania modeli

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"

​

Indeksowanie dodatkowych ścieżek

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

​

Indeksowanie transkrypcji sesji

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

​

Zakres wyszukiwania

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

​

Cytowania

​

Kiedy używać

• Ponownego rankingowania dla wyników wyższej jakości.
• Wyszukiwania dokumentacji projektu lub notatek poza obszarem roboczym.
• Przywoływania rozmów z poprzednich sesji.
• W pełni lokalnego wyszukiwania bez kluczy API.

​

Rozwiązywanie problemów

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

​

Konfiguracja

​

Powiązane

• Omówienie pamięci
• Wbudowany silnik pamięci
• Pamięć Honcho