OpenClaw 系统架构详解

第8部分：Session Management & Memory System

💾 Session Management (会话管理) - 状态持久化

职责

• 维护对话历史
• 管理会话状态
• 支持会话压缩和清理

会话键格式

agent::

会话存储位置

~/.openclaw/agents//sessions/

会话特性

• 序列化运行：每个会话键序列化运行
• 状态一致性：保持会话历史一致
• 压缩机制：自动压缩长对话
• 清理策略：定期清理旧会话

会话生命周期

1. 创建会话
2. 加载会话历史
3. 执行代理循环
4. 更新会话状态
5. 压缩会话（如需要）
6. 持久化会话

🧠 Memory System (记忆系统) - 长期记忆

职责

• 存储重要信息和决策
• 支持语义搜索
• 跨会话保持上下文

记忆类型

MEMORY.md

• 长期记忆（主会话专用）
• 存储重要决策、偏好、规则
• 位置：workspace/MEMORY.md

memory/YYYY-MM-DD.md

• 每日笔记
• 记录当天发生的事件
• 位置：workspace/memory/YYYY-MM-DD.md

QMD 会话搜索

• 跨代理的会话转录搜索
• 支持语义搜索
• 可配置额外集合

记忆搜索

memory_search(query="重要决策")
memory_get(path="MEMORY.md", from=1, lines=10)

记忆维护

• 定期回顾每日笔记
• 提取重要信息到 MEMORY.md
• 清理过时信息
• 保持记忆结构化

记忆使用场景

• 记住用户偏好
• 记录重要决策
• 保存项目上下文
• 跟踪任务进度