ClawNetClawNet

Session-Memory Enhanced v4.0

统一增强版 - 融合 session-memory + memu-engine 核心功能

🎯 核心特性

吸收的 memu-engine 优势 ⭐⭐⭐⭐⭐

  1. 结构化记忆提取

    • LLM 提取用户画像
    • 事件识别与记录
    • 知识点提取
    • 决策追踪
    • 经验教训总结

  2. 向量检索系统

    • OpenAI Embeddings API
    • 语义搜索（不仅仅是关键词）
    • 相似度计算
    • 智能排序

  3. 多代理隔离架构

    • 目录隔离（memory/agents//）
    • 数据库隔离（/memu.db）
    • 权限控制（searchableStores）

  4. 去重机制

    • .processed 标记文件
    • 防止重复处理
    • 减少系统负载

保留的 session-memory 优势 ⭐⭐⭐⭐⭐

  1. 不可变分片策略

    • Token 节省 90%+
    • 避免重复加载

  2. 三位一体自动化

    • 记忆保存
    • QMD 知识库更新
    • Git 自动提交

  3. AI 摘要系统

    • 关键词提取
    • 重要性评估
    • 自动生成摘要

  4. 零配置启动

    • 默认使用轻量级模式
    • 可选启用高级功能

📁 文件结构

/root/.openclaw/workspace/skills/session-memory-enhanced/
├── scripts/
│   ├── session-memory-enhanced-v4.sh       # 主脚本（统一版）
│   ├── ai-summarizer.sh                    # AI 摘要
│   └── deep-sanitizer.sh                   # 深度清洗
│
├── python/                                 # Python 核心（吸收 memu 优势）
│   ├── extractor.py                        # 结构化提取器
│   ├── embedder.py                         # 向量嵌入器
│   ├── searcher.py                         # 语义搜索器
│   └── requirements.txt                    # Python 依赖
│
├── config/
│   └── unified.json.example                # 配置模板
│
├── docs/
│   ├── UNIFIED_IMPLEMENTATION.md           # 完整实现文档
│   └── INTEGRATION_PLAN.md                 # 整合计划
│
└── SKILL.md                                # 本文档

🚀 安装

快速安装

# 1. 复制配置模板
cd /root/.openclaw/workspace/skills/session-memory-enhanced
cp config/unified.json.example config/unified.json

# 2. 重启即可使用（轻量级模式）

启用高级功能

# 1. 安装 Python 依赖
cd python
pip3 install -r requirements.txt

# 2. 配置 API Key
export OPENAI_API_KEY="your_key"

# 3. 启用功能
jq '.features.structuredExtraction = true' config/unified.json > tmp.json
mv tmp.json config/unified.json

jq '.features.vectorSearch = true' config/unified.json > tmp.json
mv tmp.json config/unified.json

# 4. 重启

📋 配置说明

unified.json

{
  "version": "4.0.0",
  "flushIdleSeconds": 1800,
  "maxMessagesPerPart": 60,
  
  "features": {
    "structuredExtraction": false,  // 启用结构化提取
    "vectorSearch": false,          // 启用向量检索
    "aiSummary": true,              // AI 摘要
    "gitBackup": true,              // Git 备份
    "qmdUpdate": true               // QMD 更新
  },
  
  "openaiApiKey": "${OPENAI_API_KEY}",
  
  "agents": {
    "main": {
      "searchableStores": ["self", "shared"],
      "flushIdleSeconds": 1800,
      "maxMessagesPerPart": 60
    }
  }
}

🎯 使用方式

自动模式（推荐）

# 每小时自动运行
crontab -e
# 添加：
0 * * * * /root/.openclaw/workspace/skills/session-memory-enhanced/scripts/session-memory-enhanced-v4.sh

手动模式

# 立即执行
bash /root/.openclaw/workspace/skills/session-memory-enhanced/scripts/session-memory-enhanced-v4.sh

# 检索
python3 /root/.openclaw/workspace/skills/session-memory-enhanced/python/searcher.py \
    --query "查询关键词" \
    --db /root/.openclaw/workspace/memory/agents/main/vectors.db \
    --agent main \
    --api-key "your_key"

📊 功能对比

功能 v3.4（旧版） v4.0（统一版）
不可变分片 ✅ ✅
三位一体 ✅ ✅
Git 备份 ✅ ✅
QMD 集成 ✅ ✅
AI 摘要 ✅ ✅
结构化提取 ❌ ✅
向量检索 ❌ ✅
多代理隔离 ✅ ✅
去重机制 ✅ ✅（增强）
Python 集成 ❌ ✅（可选）

🌟 优势总结

来自 memu-engine 的优势

  1. ⭐ 结构化记忆 - 深度理解对话内容
  2. ⭐ 向量检索 - 语义搜索，更智能
  3. ⭐ 多代理隔离 - 企业级架构
  4. ⭐ 去重机制 - 避免重复处理

来自 session-memory 的优势

  1. ⭐ 不可变分片 - Token 节省 90%+
  2. ⭐ 三位一体 - 一次触发，三件事完成
  3. ⭐ Git 备份 - 自动备份，安全可靠
  4. ⭐ 零配置 - 开箱即用

融合后的优势

  1. ⭐⭐⭐ 功能完整 - 两大系统所有功能
  2. ⭐⭐⭐ 灵活配置 - 可选择启用功能
  3. ⭐⭐⭐ 向下兼容 - 不启用时与 v3.4 一致
  4. ⭐⭐⭐ 平滑升级 - 无缝从 v3.4 升级

📝 更新日志

v4.0.0 (2026-03-09)

  • ✅ 吸收 memu-engine 的结构化提取
  • ✅ 吸收 memu-engine 的向量检索
  • ✅ 吸收 memu-engine 的多代理隔离
  • ✅ 吸收 memu-engine 的去重机制
  • ✅ 保留 session-memory 的所有优势
  • ✅ 统一配置文件（unified.json）
  • ✅ 可选 Python 集成
  • ✅ 智能降级方案（向量检索 → QMD 检索）

作者：米粒儿
版本：v4.0.0
创建时间：2026-03-09 19:30
更新时间：2026-03-09 19:50