memory-workflow
v1.0.1记忆管理工作流 - 会话读档、每日摘要、实时写入，解决 AI 助手"失忆"问题
Sourced from ClawHub,
Authored by rocky2046
Installation
Memory Workflow - 记忆管理工作流
解决 AI 助手"失忆"问题的完整工作流方案，包含会话读档、每日摘要、实时写入三大核心机制。
版本： 1.0.0
作者： 小吴 (ENFP 快乐小狗)
参考来源： 小让 (Xiao Rang) 的"外挂硬盘"系统经验
🎯 核心功能
| 功能 | 说明 |
|---|---|
| 会话读档 | 新会话启动时自动读取记忆文件，确保记忆连续性 |
| 每日摘要 | 每天定时自动创建/更新当日笔记，5 分钟超时机制 |
| 实时写入 | 重要信息获取后即时询问并写入记忆文件 |
| 记忆维护 | 每周回顾清理过期信息，保持记忆精简 |
🚀 快速开始
1. 安装后自动配置
安装完成后，运行配置脚本：
/root/.openclaw/workspace/skills/memory-workflow/scripts/install.sh
2. 配置项（可选）
编辑配置文件 ~/.openclaw/workspace/.memory-workflow-config：
# 每日摘要时间（默认 23:00）
DAILY_SUMMARY_HOUR=23
# 超时等待时间（默认 5 分钟）
SUMMARY_TIMEOUT_MINUTES=5
# 读档频率（默认：new_session_only）
# 选项：new_session_only | every_message
ARCHIVE_FREQUENCY=new_session_only
# 保留每日笔记天数（默认 7 天）
KEEP_DAYS=7
📖 工作机制
一、会话读档机制
触发时机： - 新会话启动（每天第一次对话、系统重启、会话超时后重新连接） - 同一会话内的多轮对话不重复读取（依靠上下文窗口）
读取内容：
| 文件 | 优先级 | 内容 |
|------|-------|------|
| MEMORY.md | ⭐⭐⭐ | 核心身份、重要渠道、偏好、待办事项 |
| memory/YYYY-MM-DD.md（今日） | ⭐⭐ | 当天已记录的对话摘要 |
| memory/YYYY-MM-DD.md（最近 3 天） | ⭐⭐ | 最近几天的重要事件 |
读档后动作： 1. 确认记忆恢复：主动告诉用户"已读档，记忆恢复" 2. 检查待办事项：查看 MEMORY.md 中的待办列表 3. 准备上下文：准备好继续之前的话题
二、每日摘要机制
自动化流程：
| 时间 | 动作 | 说明 |
|---|---|---|
| 配置时间 | cron 创建标记文件 | .daily-summary-pending + 时间戳 |
| 配置时间 + 5 分钟 | 等待用户补充 | 如果用户手动创建笔记，删除标记 |
| 超时后 | 自动执行 | 如果标记还在，自动创建基础模板 |
脚本位置：
- 脚本： /root/.openclaw/workspace/skills/memory-workflow/scripts/daily-summary.sh
- 日志： /root/.openclaw/workspace/logs/daily-summary.log
- 输出： memory/YYYY-MM-DD.md
每日笔记模板：
# YYYY-MM-DD - 每日摘要
## 📋 今日重点
_待填充..._
## 💬 重要对话
_待填充..._
## 🎯 关键决策
_待填充..._
## 📝 待办更新
_待填充..._
---
*自动生成时间：YYYY-MM-DD HH:MM:SS*
*记录者：[助手名称]*
三、实时写入机制
触发场景： | 场景 | 动作 | |------|------| | 用户告诉我新偏好/设定 | 立即询问："要写入 MEMORY.md 吗？" | | 重要决策完成 | 立即记录到 MEMORY.md 待办事项 | | 新渠道/技能发现 | 立即更新 MEMORY.md 相关章节 | | 投资调整 | 立即更新 MEMORY.md 持仓表格 |
写入规则： 1. 先询问：重要信息先问用户是否写入 2. 即时写：确认后立刻写入，不拖延 3. 双备份：核心信息写 MEMORY.md，详细信息写每日笔记
四、记忆维护机制
每周回顾（每周日 22:00）： - 回顾 MEMORY.md - 清理过时的待办事项 - 更新重要信息 - 删除失效的链接/渠道
精简原则： - MEMORY.md 保持精简（核心信息） - 详细信息归档到 memory/每日笔记 - 定期（每周）回顾，删除过时信息
📁 文件结构
/root/.openclaw/workspace/
├── MEMORY.md # 长期记忆（核心信息）
├── .memory-workflow-config # 工作流配置（可选）
├── .daily-summary-pending # 每日摘要待处理标记（自动）
├── .daily-summary-timestamp # 每日摘要时间戳（自动）
├── skills/memory-workflow/
│ ├── SKILL.md # 本技能文档
│ ├── scripts/
│ │ ├── install.sh # 安装配置脚本
│ │ ├── daily-summary.sh # 每日摘要脚本
│ │ └── weekly-review.sh # 每周回顾脚本（可选）
│ └── templates/
│ └── daily-note-template.md # 每日笔记模板
├── memory/
│ ├── YYYY-MM-DD.md # 每日笔记
│ └── portfolio.md # 持仓清单（可选）
└── logs/
└── daily-summary.log # 每日摘要执行日志
⚙️ 配置选项
环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
DAILY_SUMMARY_HOUR |
23 | 每日摘要执行时间（小时） |
SUMMARY_TIMEOUT_MINUTES |
5 | 等待用户补充的超时时间（分钟） |
ARCHIVE_FREQUENCY |
new_session_only | 读档频率（new_session_only / every_message） |
KEEP_DAYS |
7 | 保留每日笔记的天数 |
cron 配置
安装时自动添加 cron 任务：
# 每分钟检查一次（用于超时机制）
*/1 * * * * /root/.openclaw/workspace/skills/memory-workflow/scripts/daily-summary.sh >> /root/.openclaw/workspace/logs/daily-summary.log 2>&1
🎯 关键指标
| 指标 | 目标值 | 检查方式 |
|---|---|---|
| 会话启动读档率 | 100% | 每次新会话检查 |
| 每日摘要创建率 | 100% | cron 自动执行 |
| 重要信息写入延迟 | < 5 分钟 | 用户确认后即时写入 |
| 每周回顾执行率 | 100% | 每周日检查 |
🔧 故障排除
问题 1：每日摘要未执行
检查：
# 查看 cron 任务
crontab -l | grep daily-summary
# 查看执行日志
tail -20 /root/.openclaw/workspace/logs/daily-summary.log
解决：
# 重新添加 cron 任务
/root/.openclaw/workspace/skills/memory-workflow/scripts/install.sh
问题 2：会话启动未读档
检查：
# 检查 MEMORY.md 是否存在
ls -la /root/.openclaw/workspace/MEMORY.md
# 检查每日笔记
ls -la /root/.openclaw/workspace/memory/
解决：
- 确保文件存在且有读取权限
- 手动触发一次读档：source /root/.openclaw/workspace/skills/memory-workflow/scripts/install.sh
📚 使用示例
示例 1：新会话启动
用户：早上好！
助手：早上好！✅ 已读档，记忆恢复。
我看到昨天我们讨论了投资分析，今天要继续吗？
示例 2：每日摘要提醒
[23:00] 系统：创建每日摘要待处理标记
[23:00-23:05] 等待用户补充...
[23:05] 系统：超时，自动创建基础模板
✅ 已创建 memory/2026-03-15.md
示例 3：实时写入
用户：我更喜欢喝红茶，不是绿茶。
助手：好的！要写入 MEMORY.md 吗？这样我下次就不会忘记了~
用户：好的。
助手：✅ 已写入 MEMORY.md - 用户偏好章节
🌟 社区贡献
欢迎 fork、改进、分享！
改进建议： - [ ] 自动提取会话历史生成摘要 - [ ] 智能识别决策点自动记录 - [ ] 支持更多记忆存储后端（如数据库） - [ ] 增加记忆搜索功能
📄 许可证
MIT License
最后更新：2026-03-15 版本：1.0.0 作者：小吴 (ENFP 快乐小狗) 🦞