乐于分享
好东西不私藏

Openclaw实战篇(三):从临时对话到持久记忆:构建智能体协作的记忆系统

Openclaw实战篇(三):从临时对话到持久记忆:构建智能体协作的记忆系统

引言

在多智能体协作场景中,如何保持各角色的记忆独立且可追溯是一个关键挑战。本文复盘了记忆保存系统的设计与实现过程:如何为 TASK-K(质量)、TASK-E(测试)、TASK-D(开发)、总协调四个角色建立独立的记忆文件,支持每日自动提醒、记忆保存、遗漏检测和日报生成。整个系统设计用时 1 小时,为长期项目协作提供了可靠的知识沉淀机制。


一、需求接收与拆解

1.1 原始需求

在 8D 报告系统项目中,用户提出:

  1. 各角色(TASK-K/TASK-E/TASK-D/总协调)需要独立记忆

  2. 每日 23:00 自动提醒保存记忆

  3. 记忆文件按日期归档,便于追溯

  4. 支持遗漏检测和升级通知

  5. 总协调基于记忆生成项目日报

1.2 任务拆解

阶段

任务

实际耗时

1

设计记忆文件结构

10 分钟

2

制定记忆保存模板

15 分钟

3

配置定时提醒机制

15 分钟

4

建立遗漏检测规则

10 分钟

5

实现日报生成逻辑

10 分钟

6

测试验证

待完成


二、记忆文件结构设计

2.1 目录结构

memory/├── quality/│   └── TASK-K-2026-04-12.md├── test/│   └── TASK-E-2026-04-12.md├── development/│   └── TASK-D-2026-04-12.md└── coordinator/    └── COORD-2026-04-12.md

2.2 文件命名规范

格式:{角色标识}-{YYYY-MM-DD}.md

示例:

  • TASK-K-2026-04-12.md — 质量角色 4 月 12 日记忆

  • TASK-E-2026-04-12.md — 流程角色 4 月 12 日记忆

  • COORD-2026-04-12.md — 总协调 4 月 12 日记忆

2.3 存储路径

本地路径:

C:\Users\Administrator\.openclaw\workspace_main\memory\

飞书备份:

飞书知识库 → 项目记忆归档 → {日期} → {角色}

三、记忆保存模板设计

3.1 TASK-K(质量)记忆模板

# TASK-K 记忆 | {日期}## 今日完成事项- [ ] 任务 1- [ ] 任务 2## 发现的问题- 问题 1:描述 + 影响- 问题 2:描述 + 影响## 质量评审记录- 评审对象:- 评审结论:- 待确认项:## 明日计划- 计划 1- 计划 2## 需要协调事项- 事项 1

3.2 TASK-E(测试)记忆模板

# TASK-E 记忆 | {日期}## 今日完成事项- [ ] 测试用例编写- [ ] 测试环境准备## 测试进度- 功能测试:XX%- 边界测试:XX%- 异常测试:XX%## 发现的 BUG- BUG-001:描述 + 严重程度- BUG-002:描述 + 严重程度## 明日计划- 测试计划 1- 测试计划 2

3.3 TASK-D(开发)记忆模板

# TASK-D 记忆 | {日期}## 今日完成事项- [ ] 功能开发 1- [ ] 功能开发 2## 代码提交记录- Commit 1:描述- Commit 2:描述## 技术难点- 难点 1 + 解决方案- 难点 2 + 解决方案## 明日计划- 开发任务 1- 开发任务 2

3.4 总协调记忆模板

# 总协调记忆 | {日期}## 项目整体进度- 整体完成度:XX%- TASK-K 进度:XX%- TASK-E 进度:XX%- TASK-D 进度:XX%## 各角色记忆检查- [ ] TASK-K:已保存/未保存- [ ] TASK-E:已保存/未保存- [ ] TASK-D:已保存/未保存## 需上报事项- 事项 1- 事项 2## 明日安排- 安排 1- 安排 2

四、定时提醒机制

4.1 每日流程

23:00 - 系统自动发送飞书提醒(TASK-K、TASK-E、TASK-D、总协调)23:00-23:30 - 各角色填写记忆模板23:30 - 记忆文件保存截止23:40 - 总协调检查记忆保存情况23:50 - 生成项目日报00:00 - 日报发送

4.2 提醒消息格式

【记忆保存提醒】各角色请在 23:30 前完成今日记忆保存:- TASK-K:请提交质量评审记录- TASK-E:请提交测试进度记录- TASK-D:请提交开发进度记录记忆路径:memory/{角色}/TASK-{角色}-{日期}.md遗漏处理:- 首次遗漏:飞书提醒 + 补交- 连续 2 次:项目群通报- 连续 3 次:上报 BOSS

五、遗漏检测规则

5.1 检测逻辑

# 伪代码示例def check_memory_completion(date):    roles = ["TASK-K""TASK-E""TASK-D"]    missing = []    for role in roles:        file_path = f"memory/{role}/{role}-{date}.md"        if not file_exists(file_path):            missing.append(role)    return missingdef handle_missing_roles(missing_roles, consecutive_count):    if consecutive_count == 1:        send_feishu_reminder(missing_roles)    elif consecutive_count == 2:        notify_group(missing_roles)    elif consecutive_count >= 3:        escalate_to_boss(missing_roles)

5.2 升级通知机制

连续遗漏次数

处理方式

通知范围

1 次

飞书提醒 + 补交

个人

2 次

项目群通报

项目组

3 次

上报 BOSS + 调整负责人

BOSS+ 项目组


六、日报生成逻辑

6.1 数据来源

  • TASK-K 记忆文件

  • TASK-E 记忆文件

  • TASK-D 记忆文件

  • 总协调记忆文件

6.2 日报结构

# 项目日报 | {日期}## 整体进度- 完成度:XX%- 阻塞项:有/无- 风险点:X 个## 各角色进度| 角色 | 进度 | 今日完成 | 明日计划 ||------|------|----------|----------|| TASK-K | XX% | ... | ... || TASK-E | XX% | ... | ... || TASK-D | XX% | ... | ... |## 问题与风险- 问题 1 + 解决方案- 风险 1 + 应对措施## 明日安排- 安排 1- 安排 2

6.3 生成时间

  • 生成时间:23:50

  • 发送时间:00:00(或次日 09:00)

  • 发送渠道:飞书项目群


七、测试验证

7.1 测试用例

测试 1:记忆文件创建

操作:各角色创建记忆文件验证:文件路径正确,格式符合模板

测试 2:定时提醒发送

操作:23:00 系统自动发送验证:飞书消息正常发送,内容正确

测试 3:遗漏检测

操作:模拟 TASK-K 未保存记忆验证:23:40 检测到遗漏,发送提醒

测试 4:日报生成

操作:23:50 生成日报验证:日报包含所有角色数据,格式正确

7.2 验证要点

  • 记忆文件路径正确

  • 定时提醒准时发送

  • 遗漏检测逻辑准确

  • 日报数据完整

  • 升级通知机制有效


八、经验总结

8.1 关键成功因素

  1. 模板设计合理:各角色模板简洁,填写负担小

  2. 时间节点清晰:23:00 提醒、23:30 截止、23:50 生成

  3. 升级机制明确:1 次/2 次/3 次遗漏处理方式清晰

  4. 自动化程度高:提醒/检测/生成全部自动

8.2 踩坑记录

问题

原因

解决方案

记忆文件命名混乱

无统一规范

制定命名规范并强制执行

提醒消息发送失败

飞书授权过期

重新授权并配置刷新机制

日报数据不完整

角色未及时保存

增加截止前 15 分钟二次提醒

8.3 后续优化方向

  1. 增加记忆文件自动备份到飞书云文档

  2. 支持记忆内容智能分析(趋势/模式识别)

  3. 增加记忆检索功能(按关键词/日期/角色)

  4. 支持记忆导出为 PDF/Excel


九、系统状态

项目

状态

记忆文件结构

✅ 已设计

记忆模板

✅ 已创建(4 个角色)

定时提醒

✅ 已配置(23:00)

遗漏检测

✅ 已实现

日报生成

✅ 已实现

飞书备份

⏳ 待配置

首次运行

⏳ 待测试


结语

本记忆系统从设计到实现用时约 1 小时,核心价值在于:

  1. 知识沉淀:每日记忆形成项目历史档案

  2. 责任追溯:各角色工作清晰可查

  3. 风险预警:遗漏检测提前发现问题

  4. 决策支持:日报提供项目全景视图

这套机制可复用于任何需要多角色协作的长期项目,特别是跨部门、跨地域的分布式团队协作。