chore(i18n): refresh zh-CN translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
31a1991965
commit
a86a754a78
@ -2,39 +2,39 @@
|
||||
read_when:
|
||||
- 你想了解 `memory_search` 的工作原理
|
||||
- 你想选择一个嵌入提供商
|
||||
- 你想调优搜索质量
|
||||
- 你想调整搜索质量
|
||||
summary: 内存搜索如何使用嵌入和混合检索来查找相关笔记
|
||||
title: 内存搜索
|
||||
x-i18n:
|
||||
generated_at: "2026-04-09T16:29:12Z"
|
||||
generated_at: "2026-04-12T17:37:51Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: ca0237f4f1ee69dcbfb12e6e9527a53e368c0bf9b429e506831d4af2f3a3ac6f
|
||||
source_hash: 71fde251b7d2dc455574aa458e7e09136f30613609ad8dafeafd53b2729a0310
|
||||
source_path: concepts/memory-search.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# 内存搜索
|
||||
|
||||
`memory_search` 会从你的内存文件中查找相关笔记，即使措辞与原始文本不同也能找到。它的工作方式是将内存索引为小块，然后使用嵌入、关键词或两者结合进行搜索。
|
||||
`memory_search` 会从你的内存文件中查找相关笔记，即使措辞与原文不同也可以。它的工作方式是先将内存索引为较小的分块，然后使用嵌入、关键词或两者结合来搜索这些分块。
|
||||
|
||||
## 快速开始
|
||||
|
||||
如果你已配置 OpenAI、Gemini、Voyage 或 Mistral API 密钥，内存搜索会自动工作。要显式设置提供商：
|
||||
如果你已配置 OpenAI、Gemini、Voyage 或 Mistral 的 API 密钥，内存搜索会自动工作。要显式设置提供商：
|
||||
|
||||
```json5
|
||||
{
|
||||
agents: {
|
||||
defaults: {
|
||||
memorySearch: {
|
||||
provider: "openai", // or "gemini", "local", "ollama", etc.
|
||||
provider: "openai", // 或 "gemini"、"local"、"ollama" 等
|
||||
},
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
对于不使用 API 密钥的本地嵌入，请使用 `provider: "local"`（需要 `node-llama-cpp`）。
|
||||
如果要在没有 API 密钥的情况下使用本地嵌入，请使用 `provider: "local"`（需要 `node-llama-cpp`）。
|
||||
|
||||
## 支持的提供商
|
||||
|
||||
@ -46,7 +46,7 @@ x-i18n:
|
||||
| Mistral | `mistral` | 是 | 自动检测 |
|
||||
| Bedrock | `bedrock` | 否 | 当 AWS 凭证链可解析时自动检测 |
|
||||
| Ollama | `ollama` | 否 | 本地，必须显式设置 |
|
||||
| Local | `local` | 否 | GGUF 模型，下载大小约 0.6 GB |
|
||||
| Local | `local` | 否 | GGUF 模型，约需下载 0.6 GB |
|
||||
|
||||
## 搜索如何工作
|
||||
|
||||
@ -66,23 +66,25 @@ flowchart LR
|
||||
- **向量搜索** 会查找语义相近的笔记（“gateway host” 可以匹配 “the machine running OpenClaw”）。
|
||||
- **BM25 关键词搜索** 会查找精确匹配项（ID、错误字符串、配置键）。
|
||||
|
||||
如果只有一条路径可用（没有嵌入或没有 FTS），则只运行另一条路径。
|
||||
如果只有一条路径可用（没有嵌入或没有 FTS），则仅运行另一条路径。
|
||||
|
||||
当嵌入不可用时，OpenClaw 仍会对 FTS 结果使用词法排序，而不是仅退回到原始精确匹配顺序。这种降级模式会提升那些对查询词覆盖更强、文件路径更相关的分块，因此即使没有 `sqlite-vec` 或嵌入提供商，也能保持不错的召回效果。
|
||||
|
||||
## 提升搜索质量
|
||||
|
||||
当你有大量笔记历史时，有两个可选功能可以提供帮助：
|
||||
当你有大量笔记历史时，有两个可选功能会很有帮助：
|
||||
|
||||
### 时间衰减
|
||||
|
||||
旧笔记的排名权重会逐渐降低，因此较新的信息会优先显示。使用默认的 30 天半衰期时，上个月的笔记得分会降为原始权重的 50%。像 `MEMORY.md` 这样的常青文件永远不会衰减。
|
||||
旧笔记的排名权重会逐渐降低，因此最近的信息会优先显示。默认半衰期为 30 天，这意味着上个月的笔记得分会降到原始权重的 50%。像 `MEMORY.md` 这样的常青文件永远不会衰减。
|
||||
|
||||
<Tip>
|
||||
如果你的智能体拥有数月的每日笔记，且过时信息总是排在最近上下文之前，请启用时间衰减。
|
||||
如果你的智能体积累了数月的每日笔记，并且过时信息总是排在最近上下文之前，请启用时间衰减。
|
||||
</Tip>
|
||||
|
||||
### MMR（多样性）
|
||||
|
||||
可减少重复结果。如果五条笔记都提到了相同的路由器配置，MMR 会确保顶部结果覆盖不同主题，而不是重复相同内容。
|
||||
可减少重复结果。如果五条笔记都提到同一个路由器配置，MMR 会确保顶部结果覆盖不同主题，而不是反复重复。
|
||||
|
||||
<Tip>
|
||||
如果 `memory_search` 总是从不同的每日笔记中返回几乎重复的片段，请启用 MMR。
|
||||
@ -109,22 +111,22 @@ flowchart LR
|
||||
|
||||
## 多模态内存
|
||||
|
||||
使用 Gemini Embedding 2 时，你可以在 Markdown 之外一并索引图像和音频文件。搜索查询仍然是文本，但会与视觉和音频内容进行匹配。有关设置，请参阅 [内存配置参考](/zh-CN/reference/memory-config)。
|
||||
借助 Gemini Embedding 2，你可以在 Markdown 之外一并索引图像和音频文件。搜索查询仍然是文本，但可以匹配视觉和音频内容。有关设置，请参阅 [内存配置参考](/zh-CN/reference/memory-config)。
|
||||
|
||||
## 会话内存搜索
|
||||
|
||||
你还可以选择为会话转录建立索引，这样 `memory_search` 就能回忆更早的对话。这是通过 `memorySearch.experimental.sessionMemory` 选择启用的。详情请参阅[配置参考](/zh-CN/reference/memory-config)。
|
||||
你还可以选择为会话转录建立索引，这样 `memory_search` 就能回忆更早的对话。这是通过 `memorySearch.experimental.sessionMemory` 选择启用的。详见 [配置参考](/zh-CN/reference/memory-config)。
|
||||
|
||||
## 故障排除
|
||||
|
||||
**没有结果？** 运行 `openclaw memory status` 检查索引。如果为空，运行 `openclaw memory index --force`。
|
||||
**没有结果？** 运行 `openclaw memory status` 检查索引。如果为空，请运行 `openclaw memory index --force`。
|
||||
|
||||
**只有关键词匹配？** 你的嵌入提供商可能尚未配置。检查 `openclaw memory status --deep`。
|
||||
**只有关键词匹配？** 你的嵌入提供商可能尚未配置。请检查 `openclaw memory status --deep`。
|
||||
|
||||
**找不到 CJK 文本？** 使用 `openclaw memory index --force` 重建 FTS 索引。
|
||||
**找不到 CJK 文本？** 请使用 `openclaw memory index --force` 重建 FTS 索引。
|
||||
|
||||
## 延伸阅读
|
||||
|
||||
- [Active Memory](/zh-CN/concepts/active-memory) -- 用于交互式聊天会话的子智能体内存
|
||||
- [内存](/zh-CN/concepts/memory) -- 文件布局、后端、工具
|
||||
- [内存配置参考](/zh-CN/reference/memory-config) -- 所有配置选项
|
||||
- [Active Memory](/zh-CN/concepts/active-memory) —— 用于交互式聊天会话的子智能体内存
|
||||
- [Memory](/zh-CN/concepts/memory) —— 文件布局、后端、工具
|
||||
- [Memory configuration reference](/zh-CN/reference/memory-config) —— 所有配置项
|
||||
|
||||
Loading…
Reference in New Issue
Block a user