目录摘要1. 引言 - 为什么需要语义搜索1.1 传统搜索的局限1.2 语义搜索的优势1.3 memory_search 核心能力2. memory_search 工具详解2.1 工具签名2.2 参数详解2.3 返回格式2.4 相关性分数解读3. 搜索策略优化3.1 查询优化技巧3.2 参数调优策略3.3 搜索场景与参数建议4. 实战应用场景4.1 场景一用户偏好查询4.2 场景二历史决策追溯4.3 场景三问题解决方案检索4.4 场景四任务进度查询5. 高级搜索技巧5.1 组合查询5.2 时间范围限定5.3 多轮搜索5.4 搜索结果后处理6. 搜索性能优化6.1 索引优化6.2 查询优化6.3 结果优化7. 常见问题与解决Q1搜索结果不准确怎么办Q2搜索结果太多怎么办Q3搜索结果太少怎么办Q4搜索速度慢怎么办8. 最佳实践总结8.1 搜索策略清单8.2 参数配置建议8.3 下一步参考资料摘要本文深入探讨 OpenClaw 框架中的 memory_search 语义搜索功能。从向量搜索原理、工具参数详解、搜索策略优化到实战应用场景全面解析如何高效检索记忆内容。通过实际案例演示用户偏好查询、历史决策追溯、问题解决方案检索等典型场景帮助开发者构建具有智能记忆检索能力的 AI 应用实现过目不忘的效果。1. 引言 - 为什么需要语义搜索1.1 传统搜索的局限问题说明示例关键词匹配只能匹配精确词搜偏好找不到喜好无语义理解不理解查询意图搜怎么解决找不到解决方案结果排序差无法按相关性排序最相关的结果排在后面上下文缺失无法关联相关内容找不到上下文相关的信息1.2 语义搜索的优势传统搜索查询关键词匹配返回结果查询向量化相似度计算排序返回结果1.3 memory_search 核心能力能力说明效果语义理解理解查询的真实意图搜不喜欢能找到偏好模糊匹配容忍拼写和表达差异搜飞书能找到Feishu相关性排序按相似度排序结果最相关的排在最前多源检索同时搜索多个记忆文件一次查询所有日志2. memory_search 工具详解2.1 工具签名memory_search(query:str,# 搜索查询文本maxResults:int5,# 最大返回结果数minScore:float0.5# 最小相关性分数阈值)2.2 参数详解参数类型默认值说明querystring必填搜索查询文本maxResultsint5返回的最大结果数量minScorefloat0.5最小相关性分数0-12.3 返回格式{results:[{path:MEMORY.md,lines:10-15,content:用户偏好简洁表达风格,score:0.95},{path:memory/2026-04-10.md,lines:20-25,content:用户要求文章不要太长,score:0.82}],provider:none,citations:auto,mode:fts-only}2.4 相关性分数解读分数范围含义建议0.9-1.0高度相关直接使用0.7-0.9相关可参考使用0.5-0.7弱相关需要进一步判断 0.5不相关通常不返回3. 搜索策略优化3.1 查询优化技巧技巧说明示例使用关键词提取核心关键词“用户偏好” 而非 “用户有什么偏好”组合查询组合多个关键词“文章 结构 决策”使用同义词尝试不同表达“偏好” 或 “喜好” 或 “倾向”添加上下文提供更多上下文“Gateway 启动失败 解决方案”3.2 参数调优策略太少太多合适低高是否开始搜索结果数量降低 minScore提高 minScore完成相关性如何优化查询词是否遗漏增加 maxResults3.3 搜索场景与参数建议场景maxResultsminScore说明精确查找30.7只需要最相关的结果广泛搜索100.4需要尽可能多的结果决策追溯50.6查找历史决策问题检索50.5查找类似问题4. 实战应用场景4.1 场景一用户偏好查询用户问题我之前说过喜欢什么样的文章风格AI 内部调用memory_search(query用户 文章 风格 偏好,maxResults5,minScore0.5)返回结果{results:[{path:MEMORY.md,lines:15-18,content:## 沟通偏好\n- 表达风格简洁直接不喜欢啰嗦\n- 文章格式表格 代码块 图表,score:0.92},{path:memory/2026-04-10.md,lines:5-8,content:用户反馈文章太长了希望更简洁,score:0.78}]}AI 回复根据记忆你喜欢简洁直接的文章风格不喜欢啰嗦。文章格式方面你偏好表格 代码块 图表的组合形式。之前你也提过文章不要太长。4.2 场景二历史决策追溯用户问题我们为什么选择 5 阶段的文章结构AI 内部调用memory_search(query文章结构 阶段 决策 原因,maxResults3,minScore0.6)返回结果{results:[{path:memory/2026-03-14.md,lines:20-30,content:## 重要决策\n### 决策文章采用 5 阶段结构\n- 选择方案 B\n- 原因\n 1. 由浅入深更符合学习曲线\n 2. 读者可以按阶段学习\n 3. 便于后续扩展,score:0.89}]}AI 回复根据 2026-03-14 的决策记录选择 5 阶段结构的原因是由浅入深更符合学习曲线- 读者可以循序渐进读者可以按阶段学习- 不同水平的读者找到适合自己的阶段便于后续扩展- 可以方便地增加新阶段4.3 场景三问题解决方案检索用户问题之前 Gateway 启动失败是怎么解决的AI 内部调用memory_search(queryGateway 启动失败 解决,maxResults5,minScore0.5)返回结果{results:[{path:memory/2026-04-05.md,lines:10-20,content:## 遇到的问题\n### 问题Gateway 启动失败\n- 原因端口 18800 被占用\n- 解决kill -9 PID 后重启,score:0.91},{path:memory/2026-03-20.md,lines:15-18,content:Gateway 启动报错检查配置文件路径,score:0.65}]}AI 回复根据历史记录Gateway 启动失败有两种情况情况一最相关原因端口 18800 被占用解决方案检查端口占用lsof -i :18800终止占用进程kill -9 PID重新启动openclaw gateway start情况二原因配置文件路径错误解决方案检查 openclaw.yaml 路径是否正确4.4 场景四任务进度查询用户问题我们的文章项目进度怎么样了AI 内部调用memory_search(query文章 项目 进度 完成,maxResults3,minScore0.5)返回结果{results:[{path:MEMORY.md,lines:10-12,content:## 项目上下文\n- 目标完成100篇技术文章\n- 已完成42篇\n- 完成率42%,score:0.88},{path:memory/2026-04-13.md,lines:5-10,content:## 项目进度\n- 总目标100篇文章\n- 已完成42篇\n- 今日完成第41、42篇,score:0.82}]}AI 回复根据最新记录文章项目进度如下项目数值总目标100 篇文章已完成42 篇完成率42%今日完成第41、42篇5. 高级搜索技巧5.1 组合查询# 搜索用户关于文章的所有反馈memory_search(query用户 文章 反馈 意见 建议,maxResults10,minScore0.4)5.2 时间范围限定# 先确定日期范围再搜索# 搜索最近7天的记录foriinrange(7):datetoday-timedelta(daysi)# 可以先读取文件再进行本地搜索contentread(fmemory/{date}.md)# 或使用 memory_search 自动覆盖所有文件5.3 多轮搜索是否是否第一轮搜索结果满意?返回结果优化查询第二轮搜索结果满意?扩大范围第三轮搜索5.4 搜索结果后处理defprocess_search_results(results):对搜索结果进行后处理processed[]forresultinresults:# 提取关键信息item{source:result[path],content:result[content],relevance:result[score],date:extract_date(result[path])}processed.append(item)# 按相关性排序processed.sort(keylambdax:x[relevance],reverseTrue)returnprocessed6. 搜索性能优化6.1 索引优化优化项说明效果定期重建索引更新向量索引提高搜索准确性分块存储大文件分块索引减少搜索范围缓存热点缓存常用查询加快响应速度6.2 查询优化优化项说明效果精简查询使用关键词而非长句提高匹配精度避免重复缓存查询结果减少重复计算批量查询合并多个查询减少API调用6.3 结果优化优化项说明效果结果去重合并重复内容减少冗余智能摘要提取关键信息提高可读性上下文补充补充前后文提高理解度7. 常见问题与解决Q1搜索结果不准确怎么办解决方案优化查询关键词调整 minScore 阈值尝试不同的表达方式使用更具体的查询Q2搜索结果太多怎么办解决方案提高 minScore 阈值减少 maxResults使用更精确的查询添加更多关键词Q3搜索结果太少怎么办解决方案降低 minScore 阈值增加 maxResults使用更宽泛的查询尝试同义词Q4搜索速度慢怎么办解决方案减少搜索范围使用缓存优化查询复杂度定期清理旧日志8. 最佳实践总结8.1 搜索策略清单使用关键词而非长句根据场景调整参数多轮搜索逐步优化对结果进行后处理缓存常用查询结果8.2 参数配置建议场景maxResultsminScore查询策略精确查找30.7关键词组合广泛搜索100.4单个关键词决策追溯50.6决策相关词问题检索50.5问题解决8.3 下一步第44篇OpenClaw 记忆维护自动整理与归档第45篇OpenClaw 上下文管理Token 优化策略参考资料OpenClaw 官方文档OpenClaw GitHub向量搜索原理