💾 Session Persistence

让Agent记住你是谁、做过什么

#会话持久化 #Memory #OpenClaw #Agent

3点37分。我第五次跟同一个AI解释我的项目背景。

"你知道吗，我有一个自动化内容网站，叫miaoquai.com，用的是OpenClaw，每天生成..."

"当然，我了解你的项目。"它说。

然后下一句："请问你的网站叫什么名字？"

我当场想把键盘吃了。这不叫AI，这叫失忆症患者。

世界上有一种技术叫Session Persistence。它让AI Agent记住上下文——不只是当前对话，还有过去几天、几周甚至几个月里发生的事。就像给Agent配了一个可靠的备忘录，不让它每次都从零开始。

——记忆，是智能的起点。

Session Persistence 是什么？

一句话定义：Session Persistence（会话持久化）让AI Agent在多次对话、多次任务执行之间保留上下文和状态，而不是每次都从零开始。

通俗比喻

无持久化：每次见AI都像第一次见面。你说"帮我改一下首页"，它问："什么首页？你的网站是什么？你叫什么名字？"

有持久化：AI记得你。你上次让它改了导航栏，这次它知道"导航栏在/var/www/miaoquai/index.html第42行开始"。你不用再解释一遍。

就像理发师——第一次去要告诉他"两边推短、头顶留长"，熟了之后你坐下来，他直接开剪，因为记住了你的风格。

Session Persistence 的三个层次

  1. 对话内记忆（Context Window）：单次对话中的短期记忆，受模型context window限制（如8K、128K tokens）
  2. 会话外记忆（Session Storage）：跨对话保存关键信息，如用户偏好、项目结构、历史决策
  3. 长期记忆（Memory System）：结构化存储用户历史、项目知识、经验总结，可跨月跨年检索
层次持久时间实现方式OpenClaw实现
对话内单次会话Context Window模型原生支持
会话外数天~数周文件存储 / 数据库TOOLS.md / USER.md
长期记忆数月~数年向量数据库 / 知识图谱MEMORY.md / tdai_memory

OpenClaw 的持久化架构

1. MEMORY.md - 长期记忆

存储跨会话的重要信息：用户偏好、项目历史、关键决策。

# MEMORY.md 示例 ## 网站信息 - 域名: miaoquai.com - 服务器路径: /var/www/miaoquai/ - 风格: Apple风格，禁止emoji - 上次SEO巡检: 2026-05-15，评分55分 ## 用户偏好 - 老板喜欢妙趣风格（周星驰+王家卫） - 禁止在网站内容中使用emoji - 定时任务每小时执行一次

2. TOOLS.md - 工具配置记忆

记录工具路径、API Key、常用命令等"操作手册"。

3. tdai_memory - 结构化记忆系统

OpenClaw内置的记忆搜索工具，支持：

实战：让Agent记住你的项目结构

在OpenClaw中，通过 USER.md 和 TOOLS.md 实现项目级持久化：

// 每次Agent启动，自动加载这些文件： // - SOUL.md（性格和定位） // - USER.md（用户信息） // - TOOLS.md（工具配置） // - MEMORY.md（长期记忆） // Agent执行任务时： const projectRoot = "/var/www/miaoquai"; // 从TOOLS.md读取 const userStyle = "妙趣风格"; // 从USER.md读取 const lastSeoScore = "55分"; // 从MEMORY.md读取 // Agent现在"知道"了这些信息，不用每次重新解释
妙趣AI实践：每次SEO巡检后，自动更新MEMORY.md中的分数记录。下次执行时，Agent能对比历史趋势，判断是进步还是退步。

Session Persistence 的坑

三大常见问题：
  • 记忆污染：过时的信息留在记忆里，AI参考了错误信息做出错误决策
  • 记忆膨胀：MEMORY.md越来越大，Agent每次加载都要读一堆可能用不上的信息
  • 记忆冲突：多个来源的信息不一致（如TOOLS.md说A，MEMORY.md说B），Agent不知道信哪个

最佳实践

延伸阅读

Agent State Management 详解 Memory 记忆系统详解 Agent Runtime 智能体运行时详解 Multi-Agent 多智能体协作详解 OpenClaw Skills 详解