elite-longterm-memory-local

name	elite-longterm-memory-local
version	1.1.0
description	Local vector memory system with LanceDB + Pure JS embedding. No native modules or external APIs required.
author	Kimi Claw
keywords	["memory","ai-agent","long-term-memory","vector-search","lancedb","pure-javascript","local-embedding","openclaw"]
metadata	{"openclaw":{"emoji":"🧠","requires":{"env":[],"plugins":[]}}}

Elite Longterm Memory (Local Edition) 🧠

基于 LanceDB + Pure JavaScript Embedding 的本地向量记忆系统，无需外部 API。

核心特性

• ✅ 纯本地运行 — Pure JavaScript embedding，零外部依赖
• ✅ WAL 协议 — 写前日志，防数据丢失
• ✅ LanceDB 向量搜索 — 语义召回相关记忆
• ✅ 三层存储 — Hot/Warm/Cold 分层管理
• ✅ 无需配置 — 无需 Ollama 或 OpenAI API key
• ✅ 自动召回/捕获 — 智能注入相关上下文

架构

┌─────────────────────────────────────────────────────────────────┐
│                    ELITE LONGTERM MEMORY                        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐             │
│  │   HOT RAM   │  │  WARM STORE │  │  COLD STORE │             │
│  │             │  │             │  │             │             │
│  │ SESSION-    │  │  LanceDB    │  │  Git-Notes  │             │
│  │ STATE.md    │  │  Vectors    │  │  Knowledge  │             │
│  │             │  │             │  │  Graph      │             │
│  │ (survives   │  │ (semantic   │  │ (permanent  │             │
│  │  compaction)│  │  search)    │  │  decisions) │             │
│  └─────────────┘  └─────────────┘  └─────────────┘             │
│         │                │                │                     │
│         └────────────────┼────────────────┘                     │
│                          ▼                                      │
│                  ┌─────────────┐                                │
│                  │  MEMORY.md  │  ← Curated long-term           │
│                  │  + daily/   │    (human-readable)            │
│                  └─────────────┘                                │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

五层记忆系统

层级	文件/系统	用途	持久化
1. Hot RAM	SESSION-STATE.md	活跃任务上下文	survived compaction
2. Warm Store	LanceDB Vectors	语义搜索	自动召回
3. Cold Store	Git-Notes	结构化决策	永久保存
4. Archive	MEMORY.md + daily/	人类可读	精选归档
5. Embedding	Ollama	本地向量模型	纯本地

快速开始

1. 安装依赖

# 确保 Ollama 已安装并运行
ollama --version

# 拉取向量模型
ollama pull nomic-embed-text

# 安装 Node 依赖
cd skills/elite-longterm-memory
npm install

2. 初始化记忆系统

node bin/init.js

这会创建：

• SESSION-STATE.md — 热内存
• MEMORY.md — 长期记忆
• memory/ — 每日日志目录
• memory/vectors/ — LanceDB 数据库

3. 使用记忆工具

# 存储记忆
node bin/memory.js store "用户喜欢深色模式" --importance 0.9 --category preference

# 搜索记忆
node bin/memory.js search "用户界面偏好"

# 查看统计
node bin/memory.js stats

# 删除记忆
node bin/memory.js forget --query "深色模式"

OpenClaw 集成

启用插件

在 ~/.openclaw/openclaw.json 中添加：

{
  "plugins": {
    "entries": {
      "elite-longterm-memory": {
        "enabled": true,
        "config": {
          "ollamaUrl": "http://localhost:11434",
          "embeddingModel": "nomic-embed-text",
          "dbPath": "./memory/vectors",
          "autoRecall": true,
          "autoCapture": false
        }
      }
    }
  }
}

使用记忆工具

启用后，OpenClaw 会自动提供以下工具：

• memory_recall — 搜索相关记忆
• memory_store — 存储重要信息
• memory_forget — 删除记忆

智能提示词

在 AGENTS.md 或 SOUL.md 中添加：

## 记忆协议

### 会话开始时
1. 读取 SESSION-STATE.md — 获取热上下文
2. 使用 memory_recall 搜索相关历史
3. 检查 memory/YYYY-MM-DD.md 了解近期活动

### 对话中
- 用户给出具体细节？→ 先写入 SESSION-STATE.md，再回复
- 重要决策？→ 使用 memory_store 存储
- 表达偏好？→ memory_store --importance 0.9 --category preference

### 会话结束时
1. 更新 SESSION-STATE.md 最终状态
2. 重要内容移至 MEMORY.md
3. 创建/更新 memory/YYYY-MM-DD.md

WAL 协议（关键）

写前日志：先写状态，再回复。

触发条件	动作
用户表达偏好	写入 SESSION-STATE.md → 然后回复
用户做出决策	写入 SESSION-STATE.md → 然后回复
用户给出期限	写入 SESSION-STATE.md → 然后回复
用户纠正你	写入 SESSION-STATE.md → 然后回复

为什么？ 如果先回复再保存，崩溃/压缩会导致上下文丢失。WAL 确保数据持久。

维护命令

# 查看向量记忆统计
node bin/memory.js stats

# 搜索所有记忆
node bin/memory.js search "*" --limit 50

# 清理重复记忆
node bin/memory.js dedup

# 导出记忆
node bin/memory.js export --format json > memories.json

# 备份记忆
node bin/memory.js backup ./backups/memory-$(date +%Y%m%d).zip

故障排查

Ollama 连接失败 → 检查 ollama serve 是否运行 → 检查 OLLAMA_HOST 环境变量

向量搜索无结果 → 检查 LanceDB 路径是否正确 → 确认已存储记忆：node bin/memory.js stats

内存占用过高 → 运行 node bin/memory.js compact 压缩向量 → 清理旧记忆：node bin/memory.js cleanup --before 30d

为什么本地 Embedding？

对比	OpenAI API	Ollama 本地
费用	按 token 收费	免费
延迟	网络依赖	本地毫秒级
隐私	数据出域	完全本地
离线	不可用	可用
质量	text-embedding-3	nomic-embed-text

对于个人使用，nomic-embed-text 的质量足够，且完全免费。

链接

• Ollama: https://ollama.com
• LanceDB: https://lancedb.github.io (npm: vectordb)
• nomic-embed-text: https://ollama.com/library/nomic-embed-text

---

本地优先，隐私至上。