openclaw - 💡(How to fix) Fix QMD collection name mismatch causes memory search failures on boot [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#71783Fetched 2026-04-26 05:08:26
View on GitHub
Comments
0
Participants
1
Timeline
0
Reactions
0
Participants

Error Message

  1. The error should surface more clearly as a name conflict rather than silently falling through to failed searches.

Root Cause

QMD had the collection registered under the name life-main (likely from a prior manual setup or earlier OpenClaw version), but OpenClaw's config expects it as life. The name mismatch causes every search to fail and triggers a stuck agent session.

Fix Action

Workaround

qmd collection remove life-main

Allows OpenClaw to re-register and re-index under the correct name on next boot.

Code Example

qmd collection add /Users/clark/life --name life --glob **/*.md failed (code 1):
A collection already exists for this path and pattern:
  Name: life-main (qmd://life-main/)

---

qmd collection remove life-main
RAW_BUFFERClick to expand / collapse

Bug Summary

Symptom

On boot, OpenClaw fails to add the life memory collection and all QMD memory searches fail with Collection not found: life. Log output:

qmd collection add /Users/clark/life --name life --glob **/*.md failed (code 1):
A collection already exists for this path and pattern:
  Name: life-main (qmd://life-main/)

Root Cause

QMD had the collection registered under the name life-main (likely from a prior manual setup or earlier OpenClaw version), but OpenClaw's config expects it as life. The name mismatch causes every search to fail and triggers a stuck agent session.

Workaround

qmd collection remove life-main

Allows OpenClaw to re-register and re-index under the correct name on next boot.

Suggested Fix

Either:

  1. OpenClaw's boot-time collection registration should detect and reconcile an existing collection at the same path/pattern regardless of name, or
  2. The error should surface more clearly as a name conflict rather than silently falling through to failed searches.

extent analysis

TL;DR

Remove the existing life-main collection using qmd collection remove life-main to allow OpenClaw to re-register and re-index under the correct name on next boot.

Guidance

  • Verify the collection name mismatch by checking the QMD collection list and OpenClaw's config.
  • Run qmd collection remove life-main to remove the conflicting collection.
  • Restart OpenClaw to re-register and re-index the life collection.
  • Consider implementing a detection mechanism in OpenClaw to handle name conflicts and reconcile existing collections.

Example

qmd collection remove life-main

This command removes the conflicting life-main collection, allowing OpenClaw to re-register the life collection on next boot.

Notes

This workaround assumes that the life-main collection is no longer needed and can be safely removed. If the collection is still required, an alternative solution will be needed.

Recommendation

Apply workaround: Remove the existing life-main collection using qmd collection remove life-main, as this is a straightforward and effective solution to resolve the name conflict and allow OpenClaw to function correctly.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix QMD collection name mismatch causes memory search failures on boot [1 participants]