​

Рушій пам’яті QMD

​

Що він додає порівняно з вбудованим

• Переранжування та розширення запиту для кращого охоплення.
• Індексація додаткових каталогів — документація проєкту, нотатки команди, будь-що на диску.
• Індексація транскриптів сесій — відтворення попередніх розмов.
• Повністю локальний — працює через Bun + node-llama-cpp, автоматично завантажує моделі GGUF.
• Автоматичне резервне перемикання — якщо QMD недоступний, OpenClaw безшовно повертається до вбудованого рушія.

​

Початок роботи

​

Передумови

• Установіть QMD: npm install -g @tobilu/qmd або bun install -g @tobilu/qmd
• Збірка SQLite, яка дозволяє розширення (brew install sqlite на macOS).
• QMD має бути в PATH Gateway.
• macOS і Linux працюють одразу. Windows найкраще підтримується через WSL2.

​

Увімкнення

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

​

Як працює sidecar

• OpenClaw створює колекції з файлів пам’яті вашого робочого простору та будь-яких налаштованих memory.qmd.paths, потім запускає qmd update + qmd embed під час запуску і періодично (типово кожні 5 хвилин).
• Типова колекція робочого простору відстежує MEMORY.md і дерево memory/. memory.md у нижньому регістрі залишається резервним варіантом для початкового налаштування, а не окремою колекцією QMD.
• Оновлення під час запуску виконується у фоновому режимі, щоб не блокувати запуск чату.
• Пошук використовує налаштований searchMode (типово: search; також підтримуються vsearch і query). Якщо режим завершується помилкою, OpenClaw повторює спробу з qmd query.
• Якщо QMD повністю виходить з ладу, OpenClaw повертається до вбудованого рушія SQLite.

​

Перевизначення моделей

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"

​

Індексація додаткових шляхів

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

​

Індексація транскриптів сесій

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

​

Область пошуку

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

​

Цитування

​

Коли варто використовувати

• Переранжування для вищої якості результатів.
• Шукати в документації проєкту або нотатках за межами робочого простору.
• Відтворювати попередні розмови із сесій.
• Повністю локальний пошук без API-ключів.

​

Усунення несправностей

​

Конфігурація