structured-vector-memory（结构化向量存储器）

Structured Vector Memory (SVM)

三层高效记忆存储法

架构概览

┌─────────────────────────────────────────────┐
│        Structured Vector Memory (SVM)       │
│         三层记忆 × LanceDB Pro              │
├─────────────────────────────────────────────┤
│                                             │
│  🔴 热层（每次加载）                         │
│  ├── MEMORY.md（人类可读索引，≤8KB）         │
│  ├── SOUL/USER/AGENTS.md                    │
│  └── autoRecall（LanceDB 向量注入 top-N）   │
│                                             │
│  🟡 暖层（自动维护）                         │
│  ├── autoCapture → LanceDB（实时抓取）      │
│  ├── Micro Sync → 验证+标注 scope           │
│  ├── Daily Wrapup → markdown 摘要           │
│  └── 去重：向量相似度 >0.85 跳过            │
│                                             │
│  🔵 冷层（按需查询）                         │
│  ├── archive/（从热层退休的 markdown）       │
│  ├── LanceDB 全量（向量搜索可达）           │
│  └── second-brain/（深度报告）              │
│                                             │
├─────────────────────────────────────────────┤
│  Weekly Compound：                          │
│  ├── MEMORY.md 减脂（蒸馏压缩）             │
│  ├── LanceDB 清理低价值记忆                 │
│  └── Scope 审计（检查标签正确性）            │
└─────────────────────────────────────────────┘

双引擎分工

简单说：LanceDB 做实时引擎，三层记忆做管理策略。

安装

前置条件

• OpenClaw 已安装
• memory-lancedb-pro 插件已安装（clawhub install memory-lancedb-pro）
• Jina API Key（embedding + rerank）

1. 创建目录结构

mkdir -p ~/.openclaw/workspace/memory/archive
mkdir -p ~/.openclaw/workspace/second-brain/summaries

2. 配置 LanceDB Pro

确保 openclaw.json 中：

{
  "plugins": {
    "entries": {
      "memory-lancedb-pro": {
        "enabled": true,
        "config": {
          "autoCapture": true,
          "autoRecall": true
        }
      }
    }
  }
}

3. 安装 cron 脚本

cp scripts/micro-sync.sh ~/.openclaw/shared/
cp scripts/daily-wrapup.sh ~/.openclaw/shared/
cp scripts/weekly-compound.sh ~/.openclaw/shared/
chmod +x ~/.openclaw/shared/*.sh

4. 配置 cron

crontab -e
0 10,13,16,19,22 * * * ~/.openclaw/shared/micro-sync.sh >> ~/.openclaw/logs/micro-sync.log 2>&1
0 1 * * * ~/.openclaw/shared/daily-wrapup.sh >> ~/.openclaw/logs/daily-wrapup.log 2>&1
0 3 * * 0 ~/.openclaw/shared/weekly-compound.sh >> ~/.openclaw/logs/weekly-compound.log 2>&1

5. 在 AGENTS.md 中加入规则

参考 references/agents-rules.md。

排程总览

每日记忆整理（原 daily-memory skill）

触发时机

• 自动： Micro Sync cron（每天 5 次）
• 自动： Daily Wrapup cron（每天 01:00）
• 手动： 用户说「整理记忆」时

当日记录格式

# YYYY-MM-DD Daily Memory

## 主题1
- 要点

## 主题2
- 要点

什么值得记录

✅ 架构决策、踩过的坑、用户偏好变化、重要项目里程碑、新规则 ❌ 日常对话细节、一次性任务、临时调试记录、闲聊

Micro Sync 执行规则

1. sessions_list 查最近 3 小时活跃 session
2. sessions_history 逐个扫描
3. 决策过滤：只记确定的决策、新规则、架构变更、「记住 XXX」指令
4. 去重：memory_recall 查重，相似 >70% 则 memory_update 不新建
5. Scope 标注：按内容分配 scope
6. LanceDB 审核：检查 autoCapture 最近抓的记忆，删除垃圾/闲聊
7. 写入 memory/YYYY-MM-DD.md（APPEND）
8. 完成后删除 HEARTBEAT 对应段落

记忆蒸馏（原 memory-distill skill）

触发时机

• 自动： Weekly Compound cron（每周日 03:00）
• 手动： 用户说「蒸馏记忆」「压缩上下文」时

蒸馏流程

Step 1: 量体

cd ~/.openclaw/workspace
wc -c AGENTS.md SOUL.md TOOLS.md USER.md IDENTITY.md MEMORY.md HEARTBEAT.md

MEMORY.md 安全线：≤8KB

Step 2: 备份（铁律）

mkdir -p _backup/$(date +%Y-%m-%d)
cp MEMORY.md AGENTS.md _backup/$(date +%Y-%m-%d)/

Step 3: 识别冗余

• [ ] 跨文件重复 — 同一信息出现在多个文件
• [ ] 过时信息 — 已完成的待办、已解决的问题
• [ ] 冗长表述 — 能一行说清的别用一段
• [ ] LanceDB 低价值记忆 — 清理无用向量

Step 4: 精简

优先级：MEMORY.md > AGENTS.md > TOOLS.md > USER.md/IDENTITY.md SOUL.md 绝对不动。 过时内容搬到 memory/archive/，不删除。

Step 5: 验证

蒸馏后冒烟测试：

• 用户身份信息还在？
• 架构分层还清楚？
• 安全红线还知道？
• 关键项目信息还在？

回滚

cp _backup/YYYY-MM-DD/* ~/.openclaw/workspace/

Scope 隔离规则

实体与关系管理（原 structured-memory Relationship 层）

用 memory_store 的 entity category 管理人物、公司、服务等实体关系：

memory_store(text="...", category="entity", scope="global")

适用于：公司注册信息、人物关系、外部服务配置、供应商信息等。 查询：memory_recall(query="...", category="entity")

去重规则（memory_store 前必做）

存 memory_store 之前必须先 memory_recall 查重：

• 相似度 >70% → memory_update 更新旧记忆，不新建
• 部分重叠 → 合并信息后 memory_update
• 无相似 → memory_store 新建
• 记录去重动作（跳过/合并/新建）

Daily Wrap Up 摘要格式

# YYYY-MM-DD 每日摘要
## Decisions（确定的决策）
## Action Items（待办事项）
## Key Conversations（关键对话摘要）
## Technical Notes（技术笔记/踩坑）
## Pending（未完成/待续）
## Tomorrow（明天要做的事）