上海优化落户流程助力人才引进 长三角区域协同促创新创业发展 人才服务升级与产业政策联动效应显著 外籍人才长期便利措施成效凸显

实践结论

从实际体验来看，目前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文件{}