Механизм памяти QMD

​

Что он добавляет по сравнению со встроенным движком

• Переранжирование и расширение запросов для лучшей полноты поиска.
• Индексирование дополнительных каталогов — документация проекта, заметки команды, любые файлы на диске.
• Индексирование транскриптов сессий — поиск по прошлым разговорам.
• Полностью локально — работает с официальным Plugin провайдера 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",
  },
}

​

Как работает сайдкар

• OpenClaw создает коллекции из файлов памяти вашей рабочей области и любых настроенных memory.qmd.paths, затем запускает qmd update, когда менеджер QMD открывается, и периодически после этого (по умолчанию каждые 5 минут). Эти обновления выполняются через подпроцессы QMD, а не через обход файловой системы внутри процесса. Семантические режимы также запускают qmd embed.
• Коллекция рабочей области по умолчанию отслеживает MEMORY.md и дерево memory/. memory.md в нижнем регистре не индексируется как корневой файл памяти.
• Собственный сканер QMD игнорирует скрытые пути и распространенные каталоги зависимостей/сборки, такие как .git, .cache, node_modules, vendor, dist и build. Запуск Gateway по умолчанию не инициализирует QMD, поэтому холодный старт не импортирует runtime памяти и не создает долгоживущий наблюдатель до первого использования памяти.
• Если вы все же хотите инициализировать QMD при запуске Gateway, задайте memory.qmd.update.startup как idle или immediate. С memory.qmd.update.onBoot: true запуск выполняет начальное обновление. С onBoot: false запуск пропускает это немедленное обновление, но все равно открывает долгоживущий менеджер, когда настроены интервалы обновления или embedding, чтобы QMD мог владеть своим обычным наблюдателем и таймерами.
• Поиски используют настроенный searchMode (по умолчанию: search; также поддерживаются vsearch и query). search использует только BM25, поэтому OpenClaw пропускает проверки готовности семантических векторов и обслуживание embedding в этом режиме. Если режим завершается ошибкой, OpenClaw повторяет попытку с qmd query.
• Когда searchMode равен query, задайте memory.qmd.rerank как false, чтобы использовать гибридный путь запросов QMD без переранжировщика. OpenClaw передает --no-rerank в прямой CLI-путь QMD и rerank: false в MCP-инструмент запросов QMD. Для этой опции требуется QMD 2.1 или новее.
• В выпусках QMD, которые объявляют фильтры по нескольким коллекциям, OpenClaw группирует коллекции из одного источника в один вызов поиска QMD. Более старые выпуски QMD сохраняют совместимый резервный путь с поиском по каждой коллекции.
• Если QMD полностью отказывает, OpenClaw переключается на встроенный движок SQLite. Повторные попытки в ходе чат-ходов ненадолго откладываются после ошибки открытия, чтобы отсутствующий бинарный файл или сломанная зависимость сайдкара не создавали шквал повторов; openclaw memory status и одноразовые CLI-проверки все равно напрямую перепроверяют QMD.

​

Производительность поиска и совместимость

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

qmd --help | grep -i collection

​

Переопределение моделей

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" }],
    },
  },
}

​

Индексирование транскриптов сессий

{
  agents: {
    defaults: {
      memorySearch: {
        experimental: { sessionMemory: true },
        sources: ["memory", "sessions"],
      },
    },
  },
  memory: {
    backend: "qmd",
    qmd: {
      sessions: { enabled: true },
    },
  },
}

​

Область поиска

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

​

Цитаты

​

Когда использовать

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

​

Устранение неполадок

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

​

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

​

Связанные материалы

• Обзор памяти
• Встроенный движок памяти
• Память Honcho