上海优化落户流程助力人才引进 长三角区域协同促创新创业发展 人才服务升级与产业政策联动效应显著 外籍人才长期便利措施成效凸显
来源：互联网 2026-05-08 20:47:08实践结论 从实际体验来看，目前qmd对英文的支持相当完善，但中文适配还有提升空间。建议先保持关注，等待后续版本更新优化。 QMD介绍 QMD（Quantum Memory Database）是Shopify联合创始人兼CEO Tobias Lütke开发的本地语义搜索引擎。这套系统的设计思路颇为巧妙
实践结论
从实际体验来看，目前qmd对英文的支持相当完善，但中文适配还有提升空间。建议先保持关注，等待后续版本更新优化。
长期稳定更新的攒劲资源： >>>点此立即查看<<<
QMD介绍
QMD（Quantum Memory Database）是Shopify联合创始人兼CEO Tobias Lütke开发的本地语义搜索引擎。这套系统的设计思路颇为巧妙——它不是简单粗暴地把整个文件塞给AI处理，而是先通过本地搜索精准定位最相关的片段（通常只有2-3句话），再将这精华内容传递给AI。
这种机制有效解决了传统记忆系统常见的“上下文爆炸”问题。以往的系统往往需要把整个MEMORY.md文件直接塞进上下文，不仅效率低下，还浪费大量资源。
实际使用中的效果相当显著：
- 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/qmd
- OpenClaw官网: https://openclaw.ai
前置条件
从OpenClaw 2026.2.2版本开始，系统内置了QMD（Quantum Memory Database）记忆后端。这套由Shopify联合创始人Tobias Lütke开发的本地语义搜索引擎，为AI工作流带来了全新的效率体验。
首先需要确认当前的OpenClaw版本：
openclaw -v
如果版本低于2026.2.2，就需要先更新到最新版本才能体验QMD功能。
安装QMD
1、安装QMD
推荐使用npm安装：
# 使用npm安装
npm install -g @tobilu/qmd
追求更快的安装速度？可以试试bun：
# 安装bun
curl -fsSL https://bun.sh/install | bash
# bun安装qmd
bun install -g github:tobi/qmd
安装完成后记得验证：
应该看到类似qmd 2.0.1 (bab86d5)的版本信息
# 查看QMD版本
qmd -v
2、安装SQLite
QMD需要支持vector扩展的SQLite环境：
# 更新包列表
sudo apt update
# 安装sqlite3
sudo apt install sqlite3 libsqlite3-dev
# 验证安装
sqlite3 --version
3、配置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 restart
5、验证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对话，询问关于之前聊天内容的问题，亲身感受响应速度是否有明显提升。
卸载QMD
1、修改配置
修改配置文件~/.openclaw/openclaw.json，改回sqlite：
{"memory": {"backend": "sqlite"// 改回默认的SQLite后端}}
或者直接删除memory配置块（默认就是SQLite）。
2、重启openclaw
# 重启Gateway
openclaw gateway restart
# 等待3秒后检查状态
sleep 3 && openclaw gateway status
3、卸载QMD包
# npm方式卸载
npm uninstall -g @tobilu/qmd
# 或bun方式卸载
bun uninstall -g @tobilu/qmd
4、清理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中的"安全检查"
常见问题排查
问题1：qmd命令未找到
which qmd
输出空
解决：
npm install -g @tobilu/qmd
问题2：Bun版本的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/
问题5：QMD更新失败
查看日志发现：warn memory {"subsystem":"memory"} qmd update failed
解决：
# 手动更新QMD
qmd update
# 重新嵌入
qmd embed -f
问题6：qmd: 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文件{}
侠游戏发布此文仅为了传递信息，不代表侠游戏网站认同其观点或证实其描述
