Memory 搜索
memory_search 可以从你的 memory 文件中找到相关笔记，即使措辞与原始文本不同也是如此。它的工作方式是将 memory 索引为小块，然后使用嵌入、关键词或两者结合进行搜索。
快速开始
如果你已配置 OpenAI、Gemini、Voyage 或 Mistral API 密钥，memory 搜索会自动工作。要显式设置提供商：
{
agents: {
defaults: {
memorySearch: {
provider: "openai", // or "gemini", "local", "ollama", etc.
},
},
},
}
provider: "local"（需要 node-llama-cpp）。
支持的提供商
| 提供商 | ID | 需要 API 密钥 | 说明 |
|---|
| OpenAI | openai | 是 | 自动检测，速度快 |
| Gemini | gemini | 是 | 支持图像/音频索引 |
| Voyage | voyage | 是 | 自动检测 |
| Mistral | mistral | 是 | 自动检测 |
| Bedrock | bedrock | 否 | 当 AWS 凭证链可解析时自动检测 |
| Ollama | ollama | 否 | 本地，必须显式设置 |
| Local | local | 否 | GGUF 模型，下载约 0.6 GB |
搜索如何工作
OpenClaw 会并行运行两条检索路径，并合并结果：
- 向量搜索 会查找含义相近的笔记（“Gateway 网关主机”可匹配“运行 OpenClaw 的机器”）。
- BM25 关键词搜索 会查找精确匹配项（ID、错误字符串、配置键）。
如果只有一条路径可用（没有嵌入或没有 FTS），则仅运行另一条路径。
提升搜索质量
当你有大量笔记历史时，有两个可选功能会很有帮助：
时间衰减
旧笔记会逐渐失去排序权重，因此最近的信息会优先显示。使用默认的 30 天半衰期时，上个月的笔记得分会降至原始权重的 50%。像 MEMORY.md 这样的常青文件永远不会衰减。
如果你的智能体积累了数月的每日笔记，而过时信息总是排在最近上下文之前，请启用时间衰减。
MMR（多样性）
减少重复结果。如果有五条笔记都提到同一个路由器配置，MMR 会确保顶部结果覆盖不同主题，而不是重复同类内容。
如果 memory_search 总是从不同的每日笔记中返回近似重复的片段，请启用 MMR。
同时启用两者
{
agents: {
defaults: {
memorySearch: {
query: {
hybrid: {
mmr: { enabled: true },
temporalDecay: { enabled: true },
},
},
},
},
},
}
多模态 memory
借助 Gemini Embedding 2，你可以将图像和音频文件与 Markdown 一起建立索引。搜索查询仍然是文本，但会匹配视觉和音频内容。有关设置，请参阅Memory 配置参考。
会话 memory 搜索
你还可以选择为会话转录建立索引，这样 memory_search 就可以回忆更早的对话。这是通过 memorySearch.experimental.sessionMemory 选择启用的。详情请参阅配置参考。
故障排除
没有结果？ 运行 openclaw memory status 检查索引。如果为空，运行 openclaw memory index --force。
只有关键词匹配？ 你的嵌入提供商可能尚未配置。请检查 openclaw memory status --deep。
找不到 CJK 文本？ 使用 openclaw memory index --force 重建 FTS 索引。
延伸阅读
