From 1977213e1c08071ca03ac1d1f72c97d2921ec1de Mon Sep 17 00:00:00 2001
From: "openclaw-docs-sync[bot]"
 <openclaw-docs-sync[bot]@users.noreply.github.com>
Date: Mon, 6 Apr 2026 00:32:26 +0000
Subject: [PATCH] chore(sync): mirror docs from
 openclaw/openclaw@098f4eeebbede828e994a10c4973b4d60cf529f4

---
 .openclaw-sync/source.json      |  4 ++--
 docs/concepts/memory-qmd.md     | 18 +++++++++++++++++-
 docs/reference/memory-config.md |  9 +++++++++
 3 files changed, 28 insertions(+), 3 deletions(-)

diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 1fb5d756c..0fe704357 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "ca462fb9285834f256704c23656c8984dd42ee4a",
-  "syncedAt": "2026-04-06T00:32:11.248Z"
+  "sha": "098f4eeebbede828e994a10c4973b4d60cf529f4",
+  "syncedAt": "2026-04-06T00:32:26.256Z"
 }
diff --git a/docs/concepts/memory-qmd.md b/docs/concepts/memory-qmd.md
index 3c68baeaf..82a67ed2c 100644
--- a/docs/concepts/memory-qmd.md
+++ b/docs/concepts/memory-qmd.md
@@ -25,7 +25,7 @@ binary, and can index content beyond your workspace memory files.
 
 ### Prerequisites
 
-- Install QMD: `bun install -g @tobilu/qmd`
+- Install QMD: `npm install -g @tobilu/qmd` or `bun install -g @tobilu/qmd`
 - SQLite build that allows extensions (`brew install sqlite` on macOS).
 - QMD must be on the gateway's `PATH`.
 - macOS and Linux work out of the box. Windows is best supported via WSL2.
@@ -43,6 +43,8 @@ binary, and can index content beyond your workspace memory files.
 OpenClaw creates a self-contained QMD home under
 `~/.openclaw/agents/<agentId>/qmd/` and manages the sidecar lifecycle
 automatically -- collections, updates, and embedding runs are handled for you.
+It prefers current QMD collection and MCP query shapes, but still falls back to
+legacy `--mask` collection flags and older MCP tool names when needed.
 
 ## How the sidecar works
 
@@ -59,6 +61,20 @@ The first search may be slow -- QMD auto-downloads GGUF models (~2 GB) for
 reranking and query expansion on the first `qmd query` run.
 </Info>
 
+## Model overrides
+
+QMD model environment variables pass through unchanged from the gateway
+process, so you can tune QMD globally without adding new OpenClaw config:
+
+```bash
+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"
+```
+
+After changing the embedding model, rerun embeddings so the index matches the
+new vector space.
+
 ## Indexing extra paths
 
 Point QMD at additional directories to make them searchable:
diff --git a/docs/reference/memory-config.md b/docs/reference/memory-config.md
index 76cb60ef7..93c3959cb 100644
--- a/docs/reference/memory-config.md
+++ b/docs/reference/memory-config.md
@@ -377,6 +377,15 @@ Set `memory.backend = "qmd"` to enable. All QMD settings live under
 | `sessions.retentionDays` | `number`  | --       | Transcript retention                         |
 | `sessions.exportDir`     | `string`  | --       | Export directory                             |
 
+OpenClaw prefers the current QMD collection and MCP query shapes, but keeps
+older QMD releases working by falling back to legacy `--mask` collection flags
+and older MCP tool names when needed.
+
+QMD model overrides stay on the QMD side, not OpenClaw config. If you need to
+override QMD's models globally, set environment variables such as
+`QMD_EMBED_MODEL`, `QMD_RERANK_MODEL`, and `QMD_GENERATE_MODEL` in the gateway
+runtime environment.
+
 ### Update schedule
 
 | Key                       | Type      | Default | Description                           |