← Back to Skills Marketplace
liangmu-git2

Local Memory

by liangmu-git2 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
401
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install local-memory
Description
本地向量记忆工具,替代内置 memory 工具。使用 ChromaDB + BGE-small-zh 实现完全离线的语义记忆存储和检索。使用场景:(1) 存储重要信息到长期记忆,(2) 语义搜索历史记忆,(3) 删除特定记忆。触发词:记住、记忆、recall、memory、forget。
README (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:删除语义最匹配的一条
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install local-memory
  3. After installation, invoke the skill by name or use /local-memory
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: ChromaDB + BGE-small-zh local vector memory for OpenClaw. Fully offline semantic memory store/recall/forget.
Metadata
Slug local-memory
Version 1.0.0
License MIT-0
All-time Installs 3
Active Installs 3
Total Versions 1
Frequently Asked Questions

What is Local Memory?

本地向量记忆工具,替代内置 memory 工具。使用 ChromaDB + BGE-small-zh 实现完全离线的语义记忆存储和检索。使用场景:(1) 存储重要信息到长期记忆,(2) 语义搜索历史记忆,(3) 删除特定记忆。触发词:记住、记忆、recall、memory、forget。 It is an AI Agent Skill for Claude Code / OpenClaw, with 401 downloads so far.

How do I install Local Memory?

Run "/install local-memory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Local Memory free?

Yes, Local Memory is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Local Memory support?

Local Memory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Local Memory?

It is built and maintained by liangmu-git2 (@liangmu-git2); the current version is v1.0.0.

💬 Comments