Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
memory_search 会从你的记忆文件中查找相关笔记，即使措辞与原文不同。它通过将记忆索引成小块，并使用嵌入、关键词或两者来搜索这些小块。
快速开始
如果你配置了 GitHub Copilot 订阅、OpenAI、Gemini、Voyage 或 Mistral API 密钥，记忆搜索会自动工作。要显式设置提供商：provider 也可以是自定义的 models.providers.<id> 条目，例如 ollama-5080，前提是该提供商设置了 api: "ollama" 或其他嵌入适配器所有者。
对于不使用 API 密钥的本地嵌入，请设置 provider: "local"。源代码检出可能仍然需要原生构建批准：先运行 pnpm approve-builds，然后运行 pnpm rebuild node-llama-cpp。
一些兼容 OpenAI 的嵌入端点需要非对称标签，例如搜索使用 input_type: "query"，索引块使用 input_type: "document" 或 "passage"。使用 memorySearch.queryInputType 和 memorySearch.documentInputType 配置这些项；请参阅记忆配置参考。
支持的提供商
| 提供商 | ID | 需要 API 密钥 | 备注 |
|---|---|---|---|
| Bedrock | bedrock | 否 | AWS 凭证链解析成功时自动检测 |
| Gemini | gemini | 是 | 支持图像/音频索引 |
| GitHub Copilot | github-copilot | 否 | 自动检测，使用 Copilot 订阅 |
| Local | local | 否 | GGUF 模型，下载约 0.6 GB |
| Mistral | mistral | 是 | 自动检测 |
| Ollama | ollama | 否 | 本地，必须显式设置 |
| OpenAI | openai | 是 | 自动检测，速度快 |
| Voyage | voyage | 是 | 自动检测 |
搜索如何工作
OpenClaw 会并行运行两条检索路径并合并结果：- 向量搜索会查找含义相近的笔记（“gateway host”会匹配“运行 OpenClaw 的机器”）。
- BM25 关键词搜索会查找精确匹配项（ID、错误字符串、配置键）。
sqlite-vec 或嵌入提供商，也能保持有用的召回率。
提升搜索质量
当你有大量笔记历史时，有两个可选功能会有帮助：时间衰减
旧笔记会逐渐降低排序权重，让近期信息优先浮现。默认半衰期为 30 天时，上个月的笔记得分为其原始权重的 50%。像MEMORY.md 这样的长期有效文件永远不会衰减。
MMR（多样性）
减少重复结果。如果五条笔记都提到相同的路由器配置，MMR 会确保顶部结果覆盖不同主题，而不是重复相同内容。同时启用两者
多模态记忆
使用 Gemini Embedding 2 时，你可以将图像和音频文件与 Markdown 一起编入索引。搜索查询仍然是文本，但它们会匹配视觉和音频内容。请参阅记忆配置参考了解设置方式。会话记忆搜索
你可以选择索引会话转录，这样memory_search 就能回忆更早的对话。这需要通过 memorySearch.experimental.sessionMemory 选择启用。详情请参阅配置参考。
故障排除
没有结果？ 运行openclaw memory status 检查索引。如果为空，请运行 openclaw memory index --force。
只有关键词匹配？ 你的嵌入提供商可能尚未配置。检查 openclaw memory status --deep。
本地嵌入超时？ ollama、lmstudio 和 local 默认使用更长的内联批处理超时。如果主机只是速度较慢，请设置 agents.defaults.memorySearch.sync.embeddingBatchTimeoutSeconds，并重新运行 openclaw memory index --force。
找不到 CJK 文本？ 使用 openclaw memory index --force 重建 FTS 索引。