← 返回 Skills 市场
Local Memory
作者
liangmu-git2
· GitHub ↗
· v1.0.0
· MIT-0
401
总下载
0
收藏
3
当前安装
1
版本数
在 OpenClaw 中安装
/install local-memory
功能描述
本地向量记忆工具,替代内置 memory 工具。使用 ChromaDB + BGE-small-zh 实现完全离线的语义记忆存储和检索。使用场景:(1) 存储重要信息到长期记忆,(2) 语义搜索历史记忆,(3) 删除特定记忆。触发词:记住、记忆、recall、memory、forget。
使用说明 (SKILL.md)
Local Memory
本地向量记忆工具,使用 ChromaDB + BGE-small-zh-v1.5 实现完全离线的语义记忆存储和检索。
首次使用
运行安装脚本(约需 5-10 分钟下载模型和依赖):
python scripts/setup.py
数据存储位置
skill 目录下的 data/ 子目录(自动创建)。
脚本用法
所有脚本位于 scripts/ 目录,输出均为 JSON 格式。
存储记忆
python scripts/memory_store.py --text "要记住的内容" [--category fact|preference|decision|entity|other] [--importance 0.7]
--text(必填):记忆内容--category(可选,默认 other):分类--importance(可选,默认 0.7):重要性 0-1
搜索记忆
python scripts/memory_recall.py --query "搜索关键词" [--limit 5]
--query(必填):语义搜索词--limit(可选,默认 5):返回条数
删除记忆
python scripts/memory_forget.py --id "记忆ID"
python scripts/memory_forget.py --query "搜索关键词"
--id:按 ID 精确删除--query:删除语义最匹配的一条
安全使用建议
This skill appears to implement a local semantic memory using ChromaDB and a Chinese BGE model, and the scripts act only on a local data/ folder. However, before installing or running it: (1) inspect or ask about the HF mirror (https://hf-mirror.com) — the scripts force model downloads from that endpoint instead of the usual Hugging Face hosts; an untrusted mirror could supply tampered models. (2) Run setup in an isolated environment (virtualenv / container) because it runs pip installs (no version pins) and downloads models. (3) If you truly require offline operation, skip running setup and supply the model files locally and remove or override the HF_ENDPOINT lines in the scripts. (4) Prefer pinning package versions or reviewing pip install outputs. If you cannot validate the mirror or are uncomfortable with remote downloads, treat this as risky and do not run setup on sensitive machines.
功能分析
Type: OpenClaw Skill
Name: local-memory
Version: 1.0.0
The skill bundle provides a legitimate local vector memory system using ChromaDB and the BGE-small-zh-v1.5 embedding model. The scripts (memory_store.py, memory_recall.py, memory_forget.py) implement standard semantic storage and retrieval logic, while setup.py handles dependency installation and model downloading. No evidence of data exfiltration, malicious execution, or prompt injection was found; the use of a Hugging Face mirror (hf-mirror.com) is a common practice for users in restricted network environments.
能力评估
Purpose & Capability
The skill's name/description promise a '完全离线' (fully offline) memory tool, but the provided scripts and SKILL.md require network activity: pip installs and a model download. That initial download can be legitimate, but the scripts also force HF_ENDPOINT to https://hf-mirror.com instead of the standard Hugging Face endpoints, which is unexpected and not justified by the documentation.
Instruction Scope
Runtime instructions and the Python scripts operate only on the skill's data/ directory and print JSON; they do not read unrelated system files or request external credentials. However, the scripts and setup perform network operations (pip installs and model download via SentenceTransformer), so the agent will contact external servers at runtime.
Install Mechanism
There is no registry 'install' spec, but scripts/setup.py uses pip to install torch, chromadb, sentence-transformers and to pre-download the model. Using pip is common but downloads arbitrary packages from PyPI (no version pins), which is a moderate risk. The model pre-download step relies on SentenceTransformer to fetch the model from the network.
Credentials
The skill declares no required env vars, yet each script sets HF_ENDPOINT to https://hf-mirror.com and overrides REQUESTS_CA_BUNDLE/SSL_CERT_FILE to certifi. Overriding cert bundle is benign; overriding HF_ENDPOINT to an unexplained mirror is disproportionate and potentially risky because it redirects model/package retrieval to a third-party endpoint not documented in SKILL.md.
Persistence & Privilege
The skill does not request 'always: true' or any elevated platform privileges and only creates/uses a local data/ directory within the skill. It does not modify other skills or system-wide agent settings.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install local-memory - 安装完成后,直接呼叫该 Skill 的名称或使用
/local-memory触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release: ChromaDB + BGE-small-zh local vector memory for OpenClaw. Fully offline semantic memory store/recall/forget.
元数据
常见问题
Local Memory 是什么?
本地向量记忆工具,替代内置 memory 工具。使用 ChromaDB + BGE-small-zh 实现完全离线的语义记忆存储和检索。使用场景:(1) 存储重要信息到长期记忆,(2) 语义搜索历史记忆,(3) 删除特定记忆。触发词:记住、记忆、recall、memory、forget。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 401 次。
如何安装 Local Memory?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install local-memory」即可一键安装,无需额外配置。
Local Memory 是免费的吗?
是的,Local Memory 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Local Memory 支持哪些平台?
Local Memory 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Local Memory?
由 liangmu-git2(@liangmu-git2)开发并维护,当前版本 v1.0.0。
推荐 Skills