OpenClaw 的“记忆”(Memory)本质上是让代理在回答前,能从你的长期笔记里检索到相关片段并引用,从而减少“失忆”和重复沟通成本。默认后端通常能用,但当你的 MEMORY.md、daily notes(memory//*.md)逐渐变多后,你会遇到两个典型问题:要么检索命中不稳定(语义像但关键词不对),要么命中内容杂(关键词命中但语义不相关)。
这篇文章给出一套通用落地流程:把 OpenClaw 的 memory_search 检索后端从内置实现切换到 QMD sidecar,实现“关键词 BM25 + 向量语义 + 重排 rerank”的混合检索,并保留可灰度、可回退的运维路径。
官方/指南入口(强烈建议对照阅读,后续也会引用其中关键点):
AI-Skills:OpenClaw 启用 QMD 记忆后端指南(混合检索 + 重排)
QMD 的价值在于:把检索拆成更可靠的三段式链路。
- BM25(关键词):对专有名词、命令、报错文本非常稳;
- 向量语义(embedding):对“描述相近但关键词不完全一致”的内容更友好;
- 重排(rerank):在候选集合里把真正相关的片段排前面,减少“看似命中但没用”的噪声。
但你必须知道:在 OpenClaw 文档中,QMD 标记为 experimental(实验性)。这意味着它可能在版本升级时出现行为变化(模型下载、索引结构、性能参数等)。所以本文强调:先灰度跑通,再逐步调优;同时要保留“随时一键回退”的开关。
如果你习惯“让代理自己做运维”,下面这段提示词可以直接丢给 OpenClaw(或你日常用的代理执行环境)。它会按顺序完成:检查 OpenClaw 状态 → 安装 QMD → 修改配置 → 重启 gateway → 按 XDG 对齐构建索引 → 验证与回退预案。
请注意:这段提示词会涉及安装依赖与编辑配置文件,属于“会改系统状态”的操作。建议你明确要求代理在执行每个命令前先展示命令并等待你确认。
GPT plus 代充 只需 145
如果你更喜欢手动可控(尤其是在服务器上),继续看下一节。
你需要已安装并能使用 OpenClaw,至少能确认 gateway 的状态管理命令可用:
讯享网
在修改任何配置前,建议先备份:
方式 A:npm(通用,推荐)
讯享网
方式 B:bun(部分环境更顺)
安装完成后验证:
讯享网
如果 qmd / node-llama-cpp 提示需要从源码编译(无预编译包),你需要补齐编译工具链(下面按发行版列出常用包名)。
Debian / Ubuntu:
RHEL / CentOS / Fedora:
讯享网
Alpine:
Arch:
讯享网
编辑 ,在合适的位置加入/修改以下配置(保持为合法 JSON,不要加注释):
使用 OpenClaw 内置命令重启 gateway:
讯享网
这一步是全流程最容易踩坑的地方:OpenClaw 在跑 QMD 时会“改写/指定”QMD 的 XDG 目录,而你在 shell 里手动运行 qmd 时,默认会写到 。如果两边不对齐,就会出现“OpenClaw 读不到你刚建的索引”,表现为 Indexed=0 或 unable to open database file。
先查看(若你的环境提供该命令):
然后在同一套 XDG 目录下执行 collection/update/embed(把 替换为你 status 输出中的值):
讯享网
重启并完成 qmd embed 后,再看一次状态(若命令可用):
任何时候想回退到 builtin(或暂时禁用 QMD),做两件事:
- 编辑 :删除或注释掉 ;
- 重启 gateway:
讯享网
迁移时要分清两层:
- 事实源(必须迁移):workspace 里的 与 ;
- 索引(可迁移,但不强依赖):QMD 在 里的 SQLite/缓存。
本文涉及的 QMD 记忆后端在 OpenClaw 生态中属于实验性能力,可能随版本更新出现行为变化。请优先在可回退、可验证的灰度方式下启用,并在生产/长期运行环境中自行评估风险与维护成本。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/211959.html