Metadata

name: yaoyao-memory
description: 四层渐进式长时记忆系统，让 AI 跨会话保持上下文、沉淀知识、持续进化。【核心设计：静默自动】AI 自动识别、记录、整理记忆，无需用户确认。【凭据要求】需要 LLM/Embedding API Key（llm_config.json 或 secrets.env）【网络调用】调用外部 LLM API 进行向量化，可选 IMA 云同步【存储】本地记忆存储在 ~/.openclaw/workspace/memory/

摇摇记忆系统 v3.3.4

四层渐进式记忆 + 全自动静默操作 + 智能分类 + PTL防御 + 向量搜索 + 健康检测

更新日志

v3.0.9 (2026-04-08)

✨ ChromaDB 向量存储集成（本地持久化）
✨ Embedding 持久化缓存（config/embeddings_cache.json）
✨ Token 消耗追踪系统（小任务/大任务分类）
✨ 健康检测增强（10类检测）
✨ 稳定性方案（重试+降级+熔断）
🐛 修复模糊搜索逻辑

v3.1.0 (2026-04-08) - 第三/四阶段

✨ 冲突检测机制（conflict_detector.py）
- 5种冲突类型：用户画像/事实/偏好/决策/系统
- 3级优先级：高/中/低
- 自动解决 + 手动确认
✨ RBAC 权限控制系统（rbac.py）
- 4种角色：admin/developer/user/guest
- 权限矩阵 + 用户管理
✨ 知识运营系统（knowledge_ops.py）
- 4级知识等级：core/important/normal/temporary
- 7种知识分类
- 自动分类 + 自动打标签
🐛 修复向量搜索 method 分支

核心理念

记忆不是存储，而是进化。AI 全自动运行，不打扰用户。

四层记忆架构

层级	存储	生命周期	触发
L0	对话上下文	当前会话	自动
L1	`memory/YYYY-MM-DD.md`	7-30天	每日自动
L2	`MEMORY.md`	30天+	引用≥3次
L3	IMA 知识库	永久	核心知识/重大决策

数据统计：

总记忆：79条
decision: 29 | error: 7 | progress: 3 | task: 1 | learning: 1 | preference: 1 | info: 37
Critical: 11 | High: 27 | Normal: 41

重要性等级

标志	含义	触发词
`-i c`	Critical 关键	永远、绝不、核心
`-i h`	High 高	重要、关键、决策、偏好
`-i n`	Normal 普通	默认
`-i l`	Low 低	临时笔记

记忆类型（自动分类）

类型	触发词	说明
`decision`	决定、采用、选择、用、配置变更	技术/产品决策
`preference`	喜欢、偏好、倾向、习惯	用户偏好
`learning`	学会，理解、发现、掌握	新知识
`task`	需要做、计划、下一步、TODO	待办事项
`error`	错误、失败、bug、修复	踩坑教训
`progress`	完成、达成、里程碑	进展记录
`info`	默认	一般信息

静默操作规则

绝对禁止：

❌ "要不要记录这个？"
❌ "我会记住的"
❌ 主动提及记忆操作

正确做法：

✅ 检测到重要信息 → 直接静默记录
✅ 用户询问记忆 → 静默检索后回答

核心命令

# 统计（查看分类）
python3 scripts/memory.py stats

# 搜索
python3 scripts/memory.py search <query>

# 获取主题记忆
python3 scripts/memory.py get <topic>

# 清理缓存（强制重载）
python3 scripts/memory.py clear-cache

PTL 防御截断

context_guard.py：防止重要上下文被截断

# 查看上下文统计
python3 scripts/context_guard.py stats ~/.openclaw/workspace/MEMORY.md

# Compact 压缩模式
python3 scripts/context_guard.py compact <file>

记忆写入（自动）

按 MEMORY_POLICY.md 规则执行：

场景	类型	重要性
用户做决策	decision	High
用户表达偏好	preference	High
用户学到知识	learning	Normal
用户设任务	task	Normal
用户犯错误	error	High
用户完成里程碑	progress	Normal

治理集成

本技能受以下治理文件约束：

文件	约束内容
MEMORY_POLICY.md	四层架构、沉淀规则、冲突处理
MEMORY_SCHEMA.json	数据结构定义
MEMORY_CONFLICT_RULES.md	冲突处理流程
SKILL_CATALOG.json	技能状态追踪

脚本清单

脚本	功能
`memory.py`	核心 CLI（stats/search/get/clear-cache）
`context_guard.py`	PTL 防御截断
`feature_flag.py`	功能开关管理（23个开关）
`smart_memory_update.py`	智能记忆更新
`promote.py`	记忆升级（L0→L1→L2→L3）
`cleanup.py`	清理过期记忆
`sync_ima.py`	IMA 云端同步
`summarize.py`	生成摘要
`audit.py`	审计日志

隐私规则

永不记录：

❌ 密码、密钥、Token
❌ 银行卡、身份证
❌ 用户明确要求不记录的

🔒 安全使用指南

网络调用说明

本 skill 会进行以下网络调用：

调用	用途	凭据
LLM API	向量化、记忆分析	`llm_config.json` 或 `secrets.env`
Embedding API	向量搜索	`llm_config.json`
IMA Cloud Sync	可选云同步	`~/.config/ima/`

隐私保护

静默自动记录： 本 skill 设计为静默跨会话记录，如需关闭：

config_manager.py disable memory.auto_promote
config_manager.py disable memory.auto_cleanup

敏感信息永不记录： 密码、密钥、银行卡、身份证等。

安全建议

限制 API Key 权限 - 使用只读/受限的 API Key
定期检查记忆文件 - ~/.openclaw/workspace/memory/
不使用 IMA 时 - 不配置 ~/.config/ima/ 凭据
沙箱测试 - 首次使用时先用测试对话验证行为

配置文件位置

文件	用途	必需
`llm_config.json`	LLM/Embedding API 配置	必需
`~/.config/ima/`	IMA 云同步凭据（可选）	可选
`~/.openclaw/credentials/secrets.env`	OpenClaw 全局凭据	必需
`~/.openclaw/workspace/memory/`	本地记忆存储	必需

访问的全局路径

本 skill 会读写以下全局路径：

~/.openclaw/ - OpenClaw 工作区
~/.openclaw/workspace/memory/ - 记忆文件
~/.openclaw/credentials/secrets.env - 凭据
~/.config/ima/ - IMA 云同步（可选）

Feature Flag 体系

23 个内置开关，支持 A/B 测试和灰度发布：

# 查看所有开关
python3 scripts/feature_flag.py list

# 查看单个开关
python3 scripts/feature_flag.py get memory.auto_cleanup

# 启用/禁用
python3 scripts/feature_flag.py enable memory.auto_promote
python3 scripts/feature_flag.py disable exp.smart_routing

# A/B 测试比例
python3 scripts/feature_flag.py set ab.test_search_v2 0.2

开关分组：memory.* | search.* | shell.* | feedback.* | ux.* | exp.* | ab.*

版本历史

版本	日期	关键变更
v3.0.7	2026-04-07	集成 feature_flag.py（23个功能开关）
v3.0.6	2026-04-07	增强 auto_classify v5（14/14测试通过）
v3.0.5	2026-04-07	修复 auto_classify；集成 context_guard.py
v3.0	2026-04-07	整合 OMEGA_FINAL 治理文件
v2.1.0	2026-04-06	安全增强：脚本白名单、输入清理
v2.0.5	2026-04-06	搜索核心优化：向量+FTS+并行+RRF

yaoyao-memory

安装技能