How QMD Makes AI Assistant Credits Go 5x Further
How ClawOps uses QMD as the OpenClaw memory and document index so your assistant can search files, sessions, and learned context without loading everything into the model.
“How Can Included Credits Be Enough?”
It’s the first question people ask. Included AI usage sounds thin until you understand what’s running under the hood.
The answer is QMD, the local document index ClawOps uses with OpenClaw. QMD keeps searchable context on your own VPS, so your assistant can look up the relevant parts of your files, session history, and learned notes before it asks an AI model to answer.
That matters because the expensive part of an AI assistant is not just the final answer. It is all the context you send with the question.
The Problem: Full-Context Loading
When you ask an AI assistant about a document, the naive approach is to load the entire thing into the model’s context window. Your 50-page knowledge base? That can be tens of thousands of tokens just to answer one question.
Do that often enough and your credits vanish into repeated context loading instead of useful reasoning.
This is how many document workflows still work: find the file, stuff most or all of it into the prompt, hope the model finds the answer. It works, but it is wasteful.
The Fix: Search First, Model Second
QMD changes the flow.
- Your assistant searches QMD first. The index lives on your VPS.
- QMD returns the matching context. That might be a few relevant passages from files, session notes, learned rules, or a companion’s private collection.
- Only the useful context goes to the model. The assistant answers with a much smaller prompt.
The model still does the reasoning. QMD does the retrieval.
That is the core savings: ClawOps avoids sending a whole document, folder, or memory archive when a handful of focused passages will do.
What Changed Since We First Wrote This
The original version of this article described QMD mostly as a standalone local search tool. That was true early on, but OpenClaw has moved since then.
Today, ClawOps configures OpenClaw’s native QMD memory backend. QMD is not just an optional helper skill anymore. It is part of how the assistant remembers, searches, and avoids re-reading the same context over and over.
Current ClawOps deployments use QMD for:
- Session transcripts so the assistant can recover useful context from earlier conversations.
- Agent learnings so rules learned from past mistakes are searchable.
- User files in
~/files, especially markdown and text output saved by the assistant. - Companion memory such as Entertainment Buddy’s taste profile and recommendation notes.
- User-added collections when you ask the bot to index a folder.
QMD itself is installed as the current npm package, @tobilu/qmd. Older setup notes that mention Bun or manual indexing are outdated for ClawOps users.
Two Layers: Keyword Index and Embeddings
The ClawOps dashboard exposes the two important pieces:
- Keyword index for fast exact and fuzzy text matching.
- Embeddings for semantic search when the wording does not match exactly.
On current ClawOps instances, indexing is automatic. The dashboard shows whether auto-indexing is active, how many collections and documents QMD sees, and when the index last updated.
You can also click Update Now to run a manual refresh. That triggers both:
qmd update
qmd embedYou do not need to run those yourself; the dashboard does it over the secure management connection to your VPS.
Real-World Savings
The exact savings vary by document size and model, but the shape is consistent:
| Scenario | Naive approach | QMD-backed approach |
|---|---|---|
| Ask about a long note archive | Send large chunks repeatedly | Search and send the matching passages |
| Ask what happened in an old session | Load broad history | Retrieve the relevant transcript snippets |
| Ask for recommendations from a companion | Load the whole profile | Search the companion’s QMD collection |
| Update a saved report | Re-read everything manually | Search by path/topic, then edit the target file |
For document-heavy workflows, this is often the difference between “AI credits disappear quickly” and “included credits are enough for real daily use.”
We still avoid pretending the number is magic. QMD does not make model calls free. It reduces the context you need to send to the model, and that is where the savings come from.
What You See in the Dashboard
Open Dashboard -> Content -> Documents and you will see the QMD status panel:
- Collections: the named indexes available to your assistant.
- Documents: total files currently indexed.
- Last Indexed: when the index last refreshed.
- Auto-indexing: whether automatic refreshes are active.
- Update Now: a manual refresh button.
Collections may include built-in memory collections, saved files, companion data, and any folders you have asked the bot to index.
Examples:
Index all markdown files in ~/my-notes
Search my docs for information about AI models
What’s in my workspace about configuration?
The point is not that you learn a new command. The point is that your assistant can use search before it spends model context.
Privacy and Scope
QMD runs on your dedicated ClawOps VPS. Your indexed files and collections stay on that server.
When a model needs to answer, it receives the selected snippets your assistant sends as context. That is still an AI model request through your configured provider, usually OpenRouter on ClawOps, but it is much smaller than sending the full source material.
That is the privacy and cost story in one sentence: local retrieval first, external model only for the focused answer.
Credit Where It’s Due
QMD is open source, created by Tobias Lutke. OpenClaw made QMD a first-class memory backend, and ClawOps ships it configured, monitored, and wired into the dashboard.
ClawOps is built on open-source tools like QMD, OpenClaw, Tailwind CSS, Astro, Node.js, and more. We take that seriously: 1% of subscription revenue goes back to open-source projects every quarter. Read more in our open-source commitment post.
Try It Yourself
Every ClawOps bot comes with QMD installed and configured. Your document index is visible in the dashboard, and you can add collections by asking your bot in chat.
If you are self-hosting OpenClaw instead, start with the OpenClaw memory/QMD docs and the QMD project itself: github.com/tobi/qmd.