-
-
Notifications
You must be signed in to change notification settings - Fork 69.4k
bug: QMD backend fails silently when qmd binary is not installed #25910
Copy link
Copy link
Closed as not planned
Closed as not planned
Copy link
Labels
staleMarked as stale due to inactivityMarked as stale due to inactivity
Description
Problem
When memory.backend is set to "qmd" but the qmd binary is not installed (or not on PATH), OpenClaw silently falls back to the builtin provider with only a log.warn message. There is no user-facing indication that their configured memory backend is not working.
This means users who configure QMD with custom paths (e.g., an Obsidian vault) may believe their vault is being indexed and searched, when in reality it's silently using the builtin provider which only indexes memory/*.md files.
Reproduction
- Set
memory.backend: "qmd"with custom paths inopenclaw.json - Do not install
qmd - Start gateway — no error, no warning in chat
- Use memory search — returns results from builtin only, vault content is never indexed
openclaw doctordoes not flag this
Expected Behavior
openclaw doctorshould check ifqmdis on PATH whenmemory.backend: "qmd"is configured, and warn if missing- Gateway startup should surface a visible warning (not just a subsystem log) when QMD fallback activates
openclaw models statusor a newopenclaw memory statuscommand should show the effective backend and whether it's in fallback mode
Environment
- OpenClaw v2026.2.23 (also confirmed on v2026.2.24 fork build)
which qmdreturns empty- Config:
memory.backend: "qmd"withqmd.pathspointing at an Obsidian vault - Fallback activates silently on every gateway restart
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
staleMarked as stale due to inactivityMarked as stale due to inactivity
Type
Fields
Give feedbackNo fields configured for issues without a type.