Yaoyao Memory Plugin

🎲 搭载摇摇记忆引擎的四层记忆系统 — 让 AI 拥有真正的长时记忆。

19 个工具 · 3 个 Hook · FTS5 + sqlite-vec 混合搜索 · 情感分析 · 心理学模型 · L4 反馈学习 · 90 单元测试

架构

L0 — 每日对话日志        (memory/YYYY-MM-DD.md)     ← 自动捕获
L1 — 结构化记忆索引      (.yaoyao.db FTS5 + vec)    ← 混合搜索
L2 — 场景分组            (scene_blocks/)             ← LLM 管线
L3 — 用户画像            (persona.md)                ← LLM 提炼
     ├─ PersonaStateMachine — mood/energy/trust 计算
     ├─ Mood 趋势预测 + 置信度衰减
     ├─ 自适应引导 (tone/verbosity/autonomy)
     └─ L4 反馈学习层 (FeedbackTracker)

工具 (19 个)

心理学模型

插件内置 AI 状态计算引擎 PersonaStateMachine，自动追踪用户的交互状态：

全部 try-catch 兜底，失效不影响主流程。

L4 反馈学习层

自动监听用户纠错，记录到 .feedback.jsonl：

• 纠错检测："不对"/"不是"/"错了"/"太啰嗦"/"语气不对" 等模式匹配
• 反馈统计：按标签分组（memory / tone / relevance / timing）
• memory_optimize 工具：手动触发分析，输出优化建议
• FeedbackTracker.learn()：自动从历史反馈中学习模式

测试

87 个单元测试 · 38 个 describe · 14 个测试模块 · 全零依赖

心理学模型

性能基准

在 500 条数据下：

DB 大小：~204KB（500 条条目）。

运行：npm run benchmark

快速开始

# ClawHub
openclaw plugins install yaoyao-memory

# 或从 GitHub 手动安装
git clone https://github.com/taobaoaz/yaoyao-plugin.git
cd yaoyao-plugin
openclaw plugins install .

配置

{
  "enabled": true,
  "config": {
    // L0 自动捕获
    "capture": { "enabled": true },

    // L1 自动召回
    "recall": { "enabled": true, "maxResults": 3 },

    // 向量搜索（可选，开启后支持混合搜索）
    "embedding": {
      "enabled": false,
      "baseUrl": "https://api.openai.com/v1",
      "apiKey": "sk-xxx",
      "model": "text-embedding-3-small",
      "dimensions": 1024
    },

    // LLM 管线（可选，L1→L2→L3）
    // 💡 如果已配置 embedding，LLM 会自动复用 embedding 的 apiKey/baseUrl
    //    无需额外配置！插件启动时会自动检测并输出提示。
    //    如需关闭，设置 llm: { enabled: false }
    //    如需自定义，设置下方的 apiKey / baseUrl / model
    "llm": {
      "apiKey": "",
      "baseUrl": "https://api.deepseek.com",
      "model": "deepseek-chat"
    },

    // 自动清理
    "cleanup": {
      "enabled": true,
      "l0l1RetentionDays": 30
    },

    // 排除的 session 标签
    "blockLabels": [],

    // 多模态记忆：AI 自动保存图片描述到记忆（默认关闭）
    "autoSaveImage": false
  }
}

数据存储

特性

• 中文友好 — FTS5 无法匹配 CJK 时自动降级 LIKE 模糊搜索
• 心情环 — 情感分析引擎，对话情绪一目了然
• 心理学模型 — 状态追踪 + 趋势分析 + 自适应引导
• L4 反馈学习 — 自动监听纠错、统计模式、生成优化建议
• 零依赖 — 仅 node:sqlite + sqlite-vec，无 Python 无额外 npm
• 101 测试全绿 — 全零依赖，node:test 原生运行

要求

• OpenClaw ^2026.3.x
• Node.js ^22（原生 sqlite 支持）
• 可选：embedding API key 用于向量搜索
• 可选：LLM API key 用于记忆提取管线