OpenClaw配置QMD降低token消耗

实践结论当前qmd只对英文友好对中文的支持不太友好等更新吧。QMD介绍QMD (Quantum Memory Database)是 Shopify 联合创始人兼 CEO Tobias Lütke (Tobi) 开发的本地语义搜索引擎。QMD不是整个文件塞给 AI而是先用本地搜索找到最相关的片段通常只有 2-3 句话再把这些精准内容传给 AI。QMD解决传统记忆系统把整个 MEMORY.md 文件直接塞进上下文导致的上下文爆炸问题使用QMD效果✅ Token 削减60-97%平均 95% 以上✅ 响应速度提升5-50 倍✅ 成本降低90-99%✅ 精准度93%纯语义搜索仅 59%QMD特性✅ 完全免费✅ 完全本地运行 - 数据、模型、索引都不上云数据永远不出你的电脑✅ 混合搜索 - BM25 向量语义 LLM 重排序✅ 不消耗任何 API 配额 - 自带模型✅ Agent 友好 - 支持 MCP 协议专为 AI 工作流设计底层技术基于 TypeScript Bun 开发使用 node-llama-cpp 运行本地模型三层混合检索BM25 全文搜索 向量语义搜索 LLM 重排序所有模型在本地运行GGUF 格式完全离线相关链接QMD GitHub: https://github.com/tobi/qmdOpenClaw 官网: https://openclaw.ai前置条件OpenClaw 从 2026.2.2 版本开始内置了 QMDQuantum Memory Database 记忆后端。这是 Shopify 联合创始人兼 CEO Tobias Lütke (Tobi) 开发的本地语义搜索 引擎。查看openclaw版本openclaw -v如果版本低于 2026.2.2需要先更新到最新版本。安装 QMD1、安装QMDnpm安装推荐# 使用 npm 安装 npm install -g tobilu/qmdbun安装更快# 安装bun curl -fsSL https://bun.sh/install | bash # bun安装qmd bun install -g github:tobi/qmd验证安装应显示类似qmd 2.0.1 (bab86d5)# 查看QMD版本 qmd -v2、安装SQLiteQMD 需要支持 vector 扩展的 SQLite。# 更新包列表 sudo apt update # 安装sqlite3 sudo apt install sqlite3 libsqlite3-dev # 验证安装 sqlite3 --version3、配置QMD修改配置~/.openclaw/openclaw.json 相关内容先备份cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak再修改{ memory: { backend: qmd, qmd: { limits: { timeoutMs: 8000 } } } }配置说明backend: qmd- 切换到 QMD 记忆后端timeoutMs: 8000- 设置超时时间为 8 秒默认 4 秒可能不够4、重启openclaw重启后OpenClaw 会自动使用 QMD 进行记忆检索。如果 QMD 出现问题会自动回退到内置的 SQLite 记忆系统。不影响正常使用# 重启 OpenClaw Gateway 服务 openclaw gateway restart5、验证QMD是否正常方法1查看 OpenClaw 日志确认 QMD 后端已启用# 查看 OpenClaw 日志 openclaw logs --follow # 查看 OpenClaw 与 qmd 相关的日志 openclaw logs | grep qmd查找包含qmd memory的日志行info gateway {subsystem:gateway} qmd memory startup initialization armed for agent main方法2检查QMD状态# 查看 QMD 状态 qmd status正常输出示例会有一段如下提示这不是错误是正常运行提示QMD 在首次运行时会尝试 GPU 加速 - 编译 llama.cpp with Vulkan 支持编译失败 - 因为你的系统缺少 Vulkan 驱动自动回退 - 使用 CPU 模式运行falling back to no GPU这是预期的行为QMD 现在可以正常工作。如果需要更快的速度可以安装 Vulkan 驱动# Ubuntu/Debian sudo apt install vulkan-tools libvulkan-dev # 然后重启 qmd它会自动重新编译方法3实际测试与 OpenClaw 对话询问关于之前聊天内容的问题观察响应速度是否有明显提升。卸载QMD1、修改配置修改配置文件~/.openclaw/openclaw.json改成sqlite{ memory: { backend: sqlite // 改回默认的 SQLite 后端 } }或直接删除memory配置块默认就是 SQLite。2、重启openclaw# 重启 Gateway openclaw gateway restart # 等待 3 秒后检查状态 sleep 3 openclaw gateway status3、卸载QMD包# npm方式卸载 npm uninstall -g tobilu/qmd # 或 bun方式卸载 bun uninstall -g tobilu/qmd4、清理qmd数据可选但建议删除 qmd 创建的索引数据和缓存文件释放磁盘空间。# 查看 qmd 数据占用 du -sh ~/.openclaw/agents/main/qmd/ # 删除 qmd 数据目录 rm -rf ~/.openclaw/agents/main/qmd/ # 验证删除 ls -la ~/.openclaw/agents/main/ | grep qmd # 应无输出目录已不存在5、验证执行 memory_search 测试确认回退到默认模式。# 方法 1使用 OpenClaw CLI openclaw memory search 测试关键词 # 方法 2在对话中让 AI 执行 # 发送消息帮我搜索 memory 中的 安全检查常见问题排查问题 1qmd 命令未找到which qmd输出空解决npm install -g tobilu/qmd问题 2Bun 版本的 QMD 报错错误信息/home/zilong/.bun/bin/qmd: 29: exec: bun: not found解决切换到 npm 版本# 备份 bun 版本 mv ~/.bun/bin/qmd ~/.bun/bin/qmd.bun.bak # 创建符号链接到 npm 版本 ln -s ~/.nvm/versions/node/v25.8.0/bin/qmd ~/.bun/bin/qmd # 验证 qmd --version问题 3缺少 C 编译器错误信息ERROR OMG C Compiler toolset is not available. Install proper compiler toolset with your package manager, eg. sudo apt-get install g.解决# Ubuntu/Debian sudo apt install build-essential g或忽略CPU 模式仍可工作 QMD 会自动回退到 CPU 模式只是速度较慢。问题 4首次启动慢现象第一次使用 QMD 时需要下载模型约 2GB耗时较长。解决 - 等待完成后续使用会很快 - 模型下载位置~/.cache/qmd/models/问题 5QMD 更新失败查看日志发现warn memory {subsystem:memory} qmd update failed解决# 手动更新 QMD qmd update # 重新嵌入 qmd embed -f问题6qmd: 22: exec: node: not found问题原因OpenClaw 以守护进程运行没有加载 nvm 的环境变量所以找不到 node。解决方案在系统路径创建 node 符号链接指向 v22需要 sudo。请在终端手动执行# 在系统路径创建 node 符号链接指向 v22 sudo ln -s /home/zilong/.nvm/versions/node/v22.22.1/bin/node /usr/local/bin/node # 重启openclaw openclaw gateway restart问题7找不到config.json文件问题描述error [tools] read failed: ENOENT: no such file or directory, access /home/zilong/.openclaw/agents/main/qmd/config.json问题原因~/.openclaw/agents/main/qmd/config.json 文件缺失解决方法创建了一个空的 JSON 文件 {}