【LLM】Clawbot的memory记忆机制

note

一、Clawbot的memory记忆机制

【Clawbot的memory记忆机制】设计理念以透明化（Markdown格式可编辑）、搜索优先（按需调取记忆）、持久化存储（关键信息落盘）、混合搜索（语义+关键词）为核心设计理念。核心机制7个。

1）上下文与记忆区分：上下文是单请求临时数据（含系统提示、对话历史等，受模型token限制），记忆是磁盘存储的持久化数据（Markdown文件+会话记录，无界且低成本）。

2）双层存储结构：Layer1为每日日志（ memory/YYYY-MM-DD.md ，记录日常笔记），Layer2为长期记忆（ MEMORY.md ，存储关键决策、偏好等）。

3）记忆读写工具：通过 memory_search （语义+关键词混合搜索）和 memory_get （读取指定内容）调取记忆，借助标准 write/edit 工具写入，支持手动编辑。

4）索引与搜索逻辑：文件变更后分块嵌入向量，存储于SQLite（含sqlite-vec和FTS5），搜索结果按70%语义得分+30%关键词得分加权计算。

5）多代理隔离：不同代理（如个人/工作）拥有独立工作区和索引，默认无跨代理记忆访问。

6）优化机制：通过压缩（会话超token限制时总结旧内容）、记忆刷新（压缩前保存关键信息）、修剪（清理旧工具输出）避免信息丢失和成本浪费。

7）会话生命周期：支持每日/闲置超时/混合模式重置，新会话可通过钩子保存历史上下文。

Reference

[1] https://manthanguptaa.in/posts/clawdbot_memory/