基础分层持久记忆系统,解决跨会话遗忘与记忆检索问题。Use when 用户需要persistent-memory-engine-free相关功能时使用。不适用于超出本技能能力范围的复杂需求。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互,无需复杂配置即开即用。输出结果可直接使用,减少二次加工成本。
Memory
cross-session-memory
Try it给 AI agent/bot 做跨会话持久记忆的分层混合方案。当用户要"给 bot 加记忆""让 agent 记住之前的事""跨会话上下文持久化""记忆去重/断链/陈旧检查",或要搭一个有长期记忆的 agent 时使用。方案=markdown 真理源(人可读可手改) + SQLite 派生索引(选择性召回) + 生命周期检查(断链/重复/陈旧),纯标准库零依赖。
What it does
给 AI agent/bot 做跨会话持久记忆的分层混合方案。当用户要"给 bot 加记忆""让 agent 记住之前的事""跨会话上下文持久化""记忆去重/断链/陈旧检查",或要搭一个有长期记忆的 agent 时使用。方案=markdown 真理源(人可读可手改) + SQLite 派生索引(选择性召回) + 生命周期检查(断链/重复/陈旧),纯标准库零依赖。
The skill document
跨会话文件式记忆(分层混合)Skill
解决什么问题
纯文件记忆的召回是"全量读索引 + 凭关键词碰",事实一多就烧 context、漏召回、去重靠手、断链没人查、陈旧事实误导。本 Skill 把召回从"全量塞"变成"选择性取",并自动做生命周期维护。
三层架构
第一层:markdown 真理源(不动)
每个事实一个 .md,frontmatter 带 name / description / type / updated,正文写事实。
- 人能读、git 能 diff、可跨 bot 同步;
MEMORY.md是人看的索引(一行一个指针)。type取值:user(用户画像)/project(进行中工作,会过时)/reference(外部指针,较稳定)。
第二层:派生索引(脚本构建)
scripts/build_index.py 扫描 memory 目录,解析 frontmatter,写入 memory.db(SQLite,标准库)。
scripts/recall.py "<词1 词2 ...>" 做选择性召回:按词 AND 匹配 name+description+body,返回 top-k 文件路径,按需再 Read 全文。从全量塞 context 变成按需取。
第三层:生命周期检查(修三个老坑)
scripts/lint.py 一次输出三类问题:
- 断链:
[[name]]目标不存在; - 重复:description 相同的事实;
- 陈旧:
type: project且updated超过 N 个月 → 召回时附"【请先核实此事实是否仍成立,文件/函数/flag 可能已变】"。
工作流程
- 搭记忆目录:放若干
.md+ 一个MEMORY.md索引。 python scripts/build_index.py建索引。- 召回:
python scripts/recall.py "句法 GPT2" --k 5。 - 体检:
python scripts/lint.py --stale-months 3。 - 日常:增删事实后重跑 build(recall 检测到 .md 比 db 新会自动重建)。
关键原则
- 真理源始终是 .md:db 只是派生物,可随时删了重建,绝不手改 db。
- 召回后核实:对
type:project的陈旧事实,应用前先核实文件/函数/flag 是否还在。 - 零依赖:只用 Python 标准库(sqlite3),受限网络/不装包环境直接跑。
- 中文友好:召回用子串匹配(LIKE 语义),不做分词,中文不漏匹配。
使用样例
见 examples/sample-memory/。演示命令:
python scripts/build_index.py examples/sample-memory
python scripts/recall.py examples/sample-memory "句法 GPT2"
python scripts/lint.py examples/sample-memory --stale-months 3
Related skills
跨会话、跨 Agent 存储与检索结构化记忆
跨引擎记忆贯通总线:让规划/记忆/验证等四引擎共享同一份结构化记忆,实现跨引擎检索 与关联,使超级智能体一次长程任务内越跑越连贯。这是「四引擎端到端自主闭环」的关键拼图。
Cross-platform persistent memory system for AI agents: session continuity, task tracking, decision records, and project context across coding sessions. Free tier provides templates and adapter configurations. Paid tier enables cross-platform synchronization execution via clawtip verification.
为 AI agent 建立持久、可检索、可遗忘的六层记忆体系。不是堆更多 context——是把记忆按信息密度分层:L1 对话流、L2 索引(≤200行)、L3 主题文件、L4 技能固化、L5 状态追踪、L6 经验累积。含 REM 做梦(只读扫描发现模式)、SWS 巩固(写入长期记忆)、遗忘脚本(自动清理过期条目...
OpenClaw 版 Claude-Mem:自动扫描旧 Session 文件,AI 提炼决策、偏好、事实,追加写入 memory/;同步清理 .jsonl + .trajectory.jsonl,释放数百 MB 磁盘。提炼比清理先跑,记忆不丢失;提炼失败的文件自动 Quarantine 不删,避免静默丢数据。