# Send QMD Memory to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "qmd-memory",
    "name": "QMD Memory",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/asabovetech/qmd-memory",
    "canonicalUrl": "https://clawhub.ai/asabovetech/qmd-memory",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/qmd-memory",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=qmd-memory",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/calculate-savings.sh",
      "scripts/refresh.sh",
      "scripts/serve.sh",
      "scripts/setup.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "qmd-memory",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:35:28.352Z",
      "expiresAt": "2026-05-14T17:35:28.352Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=qmd-memory",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=qmd-memory",
        "contentDisposition": "attachment; filename=\"qmd-memory-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "qmd-memory"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/qmd-memory"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/qmd-memory",
    "downloadUrl": "https://openagent3.xyz/downloads/qmd-memory",
    "agentUrl": "https://openagent3.xyz/skills/qmd-memory/agent",
    "manifestUrl": "https://openagent3.xyz/skills/qmd-memory/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/qmd-memory/agent.md"
  }
}
```
## Documentation

### Local Hybrid Search — Save $50-300/month in API Costs

Author: As Above Technologies
Version: 1.0.0
ClawHub: [Coming Soon]

### API Costs You're Paying Now

OperationAPI CostFrequencyMonthly Costmemory_search (embedding)$0.02-0.0550-200/day$30-300Context retrieval$0.01-0.03100+/day$30-90Semantic queries$0.03-0.0820-50/day$18-120TOTAL$78-510/month

### With QMD Local

OperationCostWhyAll searches$0Runs on your machineEmbeddings$0Local GGUF modelsRe-ranking$0Local 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.

### 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:

memory_search → routes to QMD hybrid search
memory_get → retrieves from QMD collections
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

ModeCommandBest ForKeywordqmd search "query"Exact matches, fastSemanticqmd vsearch "query"Conceptual similarityHybridqmd query "query"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

### 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

### Trading/Investing Workspace

openclaw skill run qmd-memory template trading

Creates:

intelligence — Trading systems, dashboards, signals
market-data — Price history, analysis
research — Due diligence, reports
daily-logs — Trade journal

### Content Creator Workspace

openclaw skill run qmd-memory template content

Creates:

articles — Published content
drafts — Work in progress
research — Source material
ideas — Brainstorms, notes

### Developer Workspace

openclaw skill run qmd-memory template developer

Creates:

docs — Documentation
notes — Technical notes
decisions — ADRs, architecture decisions
snippets — Code snippets, examples

### 📈 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)

### Models Used (Auto-Downloaded)

ModelPurposeSizeembeddinggemma-300M-Q8_0Vector embeddings~300MBqwen3-reranker-0.6b-q8_0Re-ranking results~640MBqmd-query-expansion-1.7B-q4_k_mQuery 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: asabovetech
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:35:28.352Z
- Expires at: 2026-05-14T17:35:28.352Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/qmd-memory)
- [Send to Agent page](https://openagent3.xyz/skills/qmd-memory/agent)
- [JSON manifest](https://openagent3.xyz/skills/qmd-memory/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/qmd-memory/agent.md)
- [Download page](https://openagent3.xyz/downloads/qmd-memory)