search-memory

🧠 本地优先的智能记忆索引管家

Openclaw 本地记忆搜索工具,支持 Markdown 索引,保障隐私的同时实现极速查找。

收藏
5.7k
安装
1.7k
版本
v0.1.0
CLS 安全性认证2026-05-13
点击查看完整报告 >

使用说明

Search Memory 是 Openclaw 生态系统中专为本地知识管理设计的文档索引与检索技能。该工具采用本地优先架构,通过构建增量式索引缓存,帮助用户在海量 Markdown 笔记中实现毫秒级关键词检索,同时结合时间衰减算法优先展示近期内容,显著提升知识回溯效率。

核心用法方面,用户首先运行 scripts/index-memory.py 构建或更新索引,该脚本会自动扫描项目根目录的 MEMORY.mdmemory/**/*.md 文件,将内容建立倒排索引并存储于 memory/cache/ 目录。完成索引后,通过 scripts/search-memory.py "查询词" --top 5 即可执行检索,系统默认返回相关性最高的前5条结果。搜索算法不仅基于关键词匹配度评分,还引入最近性权重(过去30/90天的内容获得额外加分),确保用户优先看到最新的记忆片段。

显著优点体现在三个维度:首先是隐私安全性,纯本地运行设计意味着所有索引数据始终保存在用户设备,杜绝云端泄露风险;其次是智能排序机制,时间加权算法契合人类记忆规律,让近期活跃的内容自然浮出;最后是极简集成能力,作为 CLI 工具可轻松嵌入 Openclaw 的斜杠命令体系,实现无缝的工作流整合。

潜在局限需客观审视:目前仅支持 Markdown 格式文件,对 PDF、Word 等富文本文档无能为力;搜索逻辑依赖基础关键词匹配,缺乏语义理解或向量化检索能力;作为 Python 脚本方案,需要用户本地配置 Python 运行环境,对非技术用户存在门槛;此外,索引文件可能随笔记增长而膨胀,需定期维护缓存。

目标用户群体主要包括:注重数据主权的隐私敏感型用户、使用 Openclaw 进行知识管理的开发者、需要快速检索历史笔记内容的研究人员,以及希望建立本地化第二大脑系统的效率工具爱好者。

使用风险主要集中在操作层面:虽然 SKILL.md 本身为纯文档,但实际运行的 Python 脚本具备文件系统读写权限,建议审查 index-memory.pysearch-memory.py 的源码以避免恶意代码;索引缓存可能包含敏感文本片段,需确保 memory/cache/ 目录的访问权限设置正确;大规模索引构建可能短暂占用较高 CPU 资源,建议在闲时执行批量更新操作。

安全解读

核心用法

search-memory 是一个纯文档型 Skill,用于为 Openclaw 框架提供本地记忆文件的搜索与索引能力。其核心工作流分为两步:

1. 构建索引:通过 scripts/index-memory.pyMEMORY.mdmemory/**/*.md 进行增量索引,缓存存储于 memory/cache/
2. 执行搜索:通过 scripts/search-memory.py "查询词" --top 5 进行关键词检索,算法结合关键词匹配评分与近因加权(最近30/90天优先)

该 Skill 本身不包含可执行代码,仅提供功能规范和接口说明,需配合外部 Python 脚本使用。

显著优点

  • 本地优先设计:所有数据留存本地,无云端依赖,符合隐私敏感场景需求
  • 智能排序算法:关键词匹配结合时间衰减因子,让相关且近期的记忆优先呈现
  • 增量索引机制:避免全量重建,提升大规模记忆库的持续更新效率
  • 极低安全基线:纯 Markdown 文档,零可执行代码、零第三方依赖、零网络调用
  • 来源可信:出自 GitHub openclaw/skills 组织仓库,属 T2 级可信来源

潜在缺点与局限性

  • 外部脚本依赖:核心功能依赖的 index-memory.pysearch-memory.py 未包含在 Skill 包内,用户需自行获取或实现,存在"文档与执行分离"的断层风险
  • 功能完整性待验证:若用户从非官方渠道获取脚本,可能遭遇版本不匹配或安全漏洞
  • 隐私合规提示不足:虽涉及 ~/.claude/memory/ 目录访问,但 Skill 仅为文档,实际的隐私告知取决于外部脚本的实现
  • 无实时同步机制:索引需手动触发更新,无法自动感知记忆文件变更

适合人群

  • Openclaw 框架用户,需为 AI 助手构建可检索的长期记忆系统
  • 注重数据主权、偏好本地存储的隐私敏感型用户
  • 具备基本 Python 能力,能够审查或自行实现外部脚本的开发者
  • 希望为 CLI 或斜杠命令集成记忆查询功能的进阶用户

常规风险

| 风险项 | 说明 |
|--------|------|
| 外部脚本来源风险 | 需从可信渠道获取脚本,执行前建议审查代码 |
| 记忆目录访问 | 脚本将读取 `~/.claude/memory/`,需确认权限设置 |
| 索引缓存一致性 | 手动更新机制可能导致搜索结果与最新记忆状态滞后 |
| 无官方背书 | 安全认证不代表 Anthropic 官方保证 |

综合建议:适合技术背景用户作为记忆基础设施的参考规范,生产使用前务必验证外部脚本的安全性与功能完整性。

search-memory 内容

agents文件夹
手动下载zip · 1016 B
openai.yamltext/plain
请选择文件