OpenClaw 记忆归档定时任务修复：从 API 查询到文件系统读取的范式转变

核心结论：通过将数据获取方式从 API 查询改为直接读取文件系统，成功解决了 OpenClaw 记忆归档定时任务无法访问主会话历史的问题。这一方案不仅修复了具体 Bug，更揭示了在 session 隔离架构下绕过数据隔离限制的根本思路。

问题背景：记忆归档定时任务失效

每日记忆归档是 OpenClaw 系统的核心功能之一——自动检测前一天的技术讨论，提取有价值的内容，生成归档文件并更新长期记忆。

故障现象：2026年5月6日起，定时任务开始汇报”昨日无重要技术讨论”，而实际上当天明明有活跃的技术讨论（包括编写优化方案文档本身）。

初步诊断：怀疑是 sessions_list 查询参数不够精确，尝试了四层 fallback 策略（按时间范围、活跃状态、reset 文件等多个维度查询），但均告失败。

根因分析：Isolated Session 的数据隔离

通过深入排查，发现了问题的根本原因：

OpenClaw 的 Session 隔离机制

• • Main Session：用户直接交互的会话，包含完整的对话历史
• • Isolated Session：定时任务等后台操作创建的独立会话，与主会话完全隔离

定时任务在 isolated session 中执行 sessions_list 查询，只能看到该 isolated session 自己的历史记录，无法访问 main session 的任何数据。

这是设计层面的根本限制，不是查询参数优化能解决的。

方案演进：从 API 查询到文件系统读取

方案1.0-3.0：在 API 查询层面挣扎

关键洞察：所有基于 sessions_list API 查询的方案都无法突破 session 隔离的限制。需要从根本上改变数据获取方式。

✅ 方案4.0：直接读取文件系统

核心思路：完全绕过 sessions_list API，直接在 isolated session 中用 exec 工具读取文件系统。

具体方法：

1. 1. 执行 ls ~/.openclaw/agents/main/sessions/*.reset.* 列出所有 reset 备份文件
2. 2. 根据文件名中的 UTC 日期（+8小时转为北京时间）筛选昨天的文件
3. 3. 用 cat 读取文件内容，解析 JSONL 格式提取技术讨论
4. 4. 生成归档文件并更新记忆

为什么能成功：

• • sessions_list 查询的是 OpenClaw 内部的会话索引，受 session 隔离限制
• • 文件系统读取是直接操作系统文件，不受 OpenClaw 会话隔离限制
• • Isolated session 拥有文件系统读取权限，可以访问 main session 的 reset 文件

验证结果：方案4.0成功运行

验证时间：2026-05-08 01:00 AM（定时任务实际执行时间）

验证结果：✅ 成功！ 定时任务成功找到并归档了5月7日的技术讨论

归档内容（2026-05-07）：

• • 成功归档了关于 记忆归档定时任务优化方案 的技术讨论
• • 内容包括：问题现象分析、根因定位（isolated session 数据隔离）、四层 fallback 查询策略设计
• • 用户反馈了对记忆系统失效的沮丧情绪，推动了方案4.0的诞生
• • 生成了 memory/2026-05-07.md 并更新了 MEMORY.md

经验总结与启示

1. 架构设计层面的启示

Session 隔离是把双刃剑

• • 优点：保证不同会话间的数据安全和隔离性
• • 缺点：在需要跨会话数据访问的场景（如定时任务归档）会造成障碍

绕过隔离限制的正确姿势

• • 不要试图在应用层（API 查询）突破隔离
• • 在基础设施层（文件系统）直接访问数据更加可靠

2. 问题解决方法论

当一条路走不通时，及时转变思路

• • 方案1.0-3.0 都是在 API 查询层面尝试，耗费了大量时间
• • 方案4.0 从根本上改变了数据获取方式，问题迎刃而解

深入理解系统架构是解决问题的关键

• • 如果不理解 OpenClaw 的 session 隔离机制，可能会在错误的道路上越走越远
• • 深入阅读源码、理解架构设计，才能找到问题的本质原因

3. 工程实践建议

定时任务设计原则

• • 明确任务运行的 session 环境（main vs isolated）
• • 预先评估数据访问需求，设计合适的数据获取方案
• • 考虑在任务失败时提供详细的诊断信息

监控与告警

• • 对定时任务的关键指标（成功率、执行时间、数据量）进行监控
• • 设置合理的告警阈值，及时发现和解决问题

结语

从 API 查询到文件系统读取，这不只是一次技术方案的切换，更是一次思维方式的转变——当应用层的限制无法突破时，基础设施层往往能提供更加根本的解决方案。

OpenClaw 记忆归档定时任务的修复过程，让我们深刻理解了 session 隔离架构的本质，也积累了在受限环境下绕过隔离限制的宝贵经验。这些经验不仅适用于当前的定时任务场景，也将指导未来类似问题的解决。

方案4.0的验证成功，标志着记忆归档系统进入了稳定运行的新阶段。

附定时任务

【每日记忆归档任务 - 方案4.0 文件系统读取版】

今天是 {{today}}，需要处理昨天（{{yesterday}}）的讨论记录。

**核心思路**：不再使用 `sessions_list` 查询（isolated session 无法看到 main session 的会话），而是直接读取文件系统中的 `.reset.*` 备份文件。

**执行步骤**：

1. **列出所有 reset 文件**

   exec: ls -la ~/.openclaw/agents/main/sessions/*.reset.* 2>/dev/null | head -20


2. **筛选昨天的文件**
   - 文件名格式：`{session-id}.jsonl.reset.{timestamp}`
   - 根据文件名中的日期（如 `2026-05-06`）筛选昨天日期的文件
   - 注意：文件名中的日期是 UTC 时间，需要转换为北京时间（+8小时）

3. **读取文件内容提取讨论**
   - 对每个匹配的文件执行 `cat` 读取
   - 解析 JSONL 格式，提取用户消息和助手回复
   - 识别技术讨论内容（排除问候、闲聊等）

4. **生成归档文件**
   - 创建 `memory/{{yesterday}}.md`
   - 更新 `MEMORY.md`
   - 汇报结果

**如果找不到任何 reset 文件**：
- 尝试读取活跃的 `.jsonl` 文件（未 reset 的会话）
- 如果仍然找不到，记录"昨日无重要技术讨论"

**注意事项**：
- 文件路径：`~/.openclaw/agents/main/sessions/`
- 权限：确保可以读取该目录
- 日期转换：UTC 时间戳需要 +8 小时转为北京时间

文档版本: v2.0
最后更新: 2026-05-08
验证状态: ✅ 方案4.0 验证成功

今日小课堂

今日小幽默