install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/asabovetech/qmd-memory" ~/.claude/skills/clawdbot-skills-qmd-memory && rm -rf "$T"
manifest:
skills/asabovetech/qmd-memory/SKILL.mdsource content
QMD Memory Skill for OpenClaw
Local Hybrid Search — Save $50-300/month in API Costs
Author: As Above Technologies Version: 1.0.0 ClawHub: [Coming Soon]
💰 THE VALUE PROPOSITION
API Costs You're Paying Now
| Operation | API Cost | Frequency | Monthly Cost |
|---|---|---|---|
| memory_search (embedding) | $0.02-0.05 | 50-200/day | $30-300 |
| Context retrieval | $0.01-0.03 | 100+/day | $30-90 |
| Semantic queries | $0.03-0.08 | 20-50/day | $18-120 |
| TOTAL | $78-510/month |
With QMD Local
| Operation | Cost | Why |
|---|---|---|
| All searches | $0 | Runs on your machine |
| Embeddings | $0 | Local GGUF models |
| Re-ranking | $0 | Local LLM |
Your savings: $50-300+/month
One-time setup. Forever free searches.
🚀 QUICK START
# Install the skill clawhub install asabove/qmd-memory # Run setup (installs QMD, configures collections) openclaw skill run qmd-memory setup # That's it. Your memory is now supercharged.
WHAT YOU GET
1. Automatic Collection Setup
Based on your workspace structure, we create optimized collections:
✓ workspace — Core agent files (MEMORY.md, SOUL.md, etc.) ✓ daily-logs — memory/*.md daily logs ✓ intelligence — intelligence/*.md (if exists) ✓ projects — projects/**/*.md (if exists) ✓ documents — Any additional doc folders you specify
2. Smart Context Descriptions
We add context to each collection so QMD understands what's where:
qmd://workspace → "Agent identity and configuration files" qmd://daily-logs → "Daily work logs and session history" qmd://intelligence → "Analysis, research, and reference documents"
3. Pre-configured Cron Jobs
# Auto-update index (nightly at 3am) 0 3 * * * qmd update && qmd embed # Keep your memory fresh without thinking about it
4. OpenClaw Integration
Memory search now uses QMD automatically:
→ routes to QMD hybrid searchmemory_search
→ retrieves from QMD collectionsmemory_get- Results include collection context
5. Multi-Agent MCP Server (Optional)
# Start shared memory server openclaw skill run qmd-memory serve # All your agents can now query collective memory # Forge, Thoth, Axis — shared knowledge base
📊 SEARCH MODES
| Mode | Command | Best For |
|---|---|---|
| Keyword | | Exact matches, fast |
| Semantic | | Conceptual similarity |
| Hybrid | | Best quality (recommended) |
Example Queries
# Find exact mentions qmd search "Charlene" -n 5 # Find conceptually related content qmd vsearch "how should we handle customer complaints" # Best quality — expansion + reranking qmd query "what decisions did we make about pricing strategy" # Search specific collection qmd search "API keys" -c workspace
🔧 CONFIGURATION
Add Custom Collections
openclaw skill run qmd-memory add-collection ~/Documents/research --name research
Add Context
openclaw skill run qmd-memory add-context qmd://research "Market research and competitive analysis"
Refresh Index
openclaw skill run qmd-memory refresh
💡 TEMPLATES
Trading/Investing Workspace
openclaw skill run qmd-memory template trading
Creates:
— Trading systems, dashboards, signalsintelligence
— Price history, analysismarket-data
— Due diligence, reportsresearch
— Trade journaldaily-logs
Content Creator Workspace
openclaw skill run qmd-memory template content
Creates:
— Published contentarticles
— Work in progressdrafts
— Source materialresearch
— Brainstorms, notesideas
Developer Workspace
openclaw skill run qmd-memory template developer
Creates:
— Documentationdocs
— Technical notesnotes
— ADRs, architecture decisionsdecisions
— Code snippets, examplessnippets
📈 COST SAVINGS CALCULATOR
Run this to see your estimated savings:
openclaw skill run qmd-memory calculate-savings
Output:
Your Current API Memory Costs (estimated): memory_search calls/day: ~75 Average cost per call: $0.03 Monthly API cost: $67.50 With QMD Local: Monthly cost: $0.00 YOUR MONTHLY SAVINGS: $67.50 YOUR ANNUAL SAVINGS: $810.00 ROI on skill purchase: 40x (if skill was $20)
🛠️ TECHNICAL DETAILS
Models Used (Auto-Downloaded)
| Model | Purpose | Size |
|---|---|---|
| embeddinggemma-300M-Q8_0 | Vector embeddings | ~300MB |
| qwen3-reranker-0.6b-q8_0 | Re-ranking results | ~640MB |
| qmd-query-expansion-1.7B-q4_k_m | Query expansion | ~1.1GB |
Total: ~2GB (one-time download)
System Requirements
- Node.js >= 22
- ~3GB disk space (models + index)
- ~2GB RAM during embedding (then minimal)
Where Data is Stored
~/.cache/qmd/ ├── index.sqlite # Search index ├── models/ # GGUF models └── mcp.pid # MCP server PID (if running)
🤝 SUPPORT
Questions?
- GitHub Issues: github.com/asabove/qmd-memory-skill
- Discord: As Above community
- Email: support@asabove.tech
Found it valuable?
- Star us on ClawHub
- Share with other OpenClaw users
- Subscribe to our newsletter for more agent optimization tips
📜 LICENSE
MIT — Use freely, modify as needed.
QMD itself is created by Tobi Lütke (github.com/tobi/qmd). This skill provides easy OpenClaw integration.
"Stop paying for memory. Start compounding knowledge."
As Above Technologies — Agent Infrastructure for Humans