## 摘要

AI 在跨会话场景里会忘记"昨天写到哪了"，这正是每日日志要解决的问题。OpenClaw 用 `memory/YYYY-MM-DD.md` 记录当天完成的任务、进行中的进度、重要决策、遇到的问题和解决方案，配合写入时机规范、自动归档和语义检索，构建出有时间连续性的短期记忆。本文讲清日志文件结构、写入原则、状态标记、时间戳使用、读取与 `memory_search` 查询、7/30 天归档轮转、自动化脚本，以及与 `MEMORY.md` 和 Heartbeat 的协作方式。读完本文，你能为 Agent 搭一套可恢复、可追溯、可自动维护的短期记忆系统。

> 📌 版本声明：本文基于 OpenClaw 最新稳定版编写。日志文件路径、自动加载规则、归档阈值等可能随版本调整，落地前请以官方文档与 `AGENTS.md` 说明为准。

@[toc]

## 一、为什么需要每日日志

### 1.1 健忘的两种表现

AI 的"健忘"来自上下文窗口有限和缺少持久化存储。在跨会话场景里，这表现为两类问题：

| 问题 | 具体表现 | 影响 |
|------|----------|------|
| 状态丢失 | 忘记昨天任务进度、写到哪了 | 无法持续跟进 |
| 决策失忆 | 忘记为什么选方案 A | 重复讨论、无法复用结论 |

每日日志就是针对这两类问题的第一层解法：它不追求长期保存一切，而是把当天的关键过程沉淀为可检索的结构化记录。

### 1.2 每日日志在三层记忆中的位置

```mermaid
graph TB
 subgraph 长期记忆
 M["MEMORY.md 用户偏好 / 重要决策 / 项目上下文"]
 end
 subgraph 短期记忆
 D1["memory/2026-04-13.md 今天"]
 D2["memory/2026-04-12.md 昨天"]
 D3["memory/2026-04-11.md 更早"]
 end
 subgraph 归档
 A["memory/archive/ 按月份归档"]
 end
 subgraph 清理
 C["删除 / 摘要化"]
 end
 D1 -->|"提取重要信息"| M
 D2 -->|"提取重要信息"| M
 D3 -->|"超过7天"| A
 A -->|"超过30天"| C
 M -->|"提供长期上下文"| D1
```

每日日志是短期记忆，`MEMORY.md` 是长期记忆，归档目录是温数据，删除是冷数据出口。这套分层是理解后文所有规则的前提。

![1.png#center](https://developer.qcloudimg.com/http-save/yehe-11154201/bbc120142ce6150da70e128dbea31daa.png)
> 🖼️ **图1：每日日志在三层记忆中的位置图** —— 展示长期记忆、短期日志、归档与清理的数据流。

### 1.3 每日日志 vs 长期记忆

| 维度 | 每日日志 | MEMORY.md |
|------|----------|-----------|
| 内容 | 当天过程、临时上下文、问题记录 | 跨会话的稳定事实、偏好、决策 |
| 生命周期 | 数天到数周，定期归档清理 | 长期保留，定期精简 |
| 加载方式 | 今天+昨天自动加载，其余靠搜索 | 每次主会话注入 |
| 更新频率 | 每天多次 | 低频，只在重要变化时更新 |

核心区别是：每日日志记录"过程"，长期记忆记录"结论"。过程有时效性，结论才有长期价值。

## 二、每日日志文件结构

### 2.1 目录布局

```
memory/
├── 2026-04-13.md # 今天的日志
├── 2026-04-12.md # 昨天的日志
├── 2026-04-11.md # 更早的日志
├── archive/ # 归档目录
│ ├── 2026-03/
│ └── 2026-02/
```

文件名统一使用 `YYYY-MM-DD.md`，这是排序、归档和脚本处理的基础。日期格式一旦确定就不要混用 `YYYY/MM/DD` 等变体，否则脚本的日期解析会失败。

### 2.2 标准日志模板

```markdown
# 2026-04-13 工作记录

## 完成的任务
### 1. 撰写第41篇文章：记忆系统
- ✅ 完成摘要和引言
- ✅ 完成 MEMORY.md 章节
- ✅ 完成语义搜索章节

## 进行中的任务
- 第42篇文章：日志记忆系统，进度 0%

## 重要决策
- 决定把日志记忆独立成篇，原因是它是跨会话恢复的关键

## 遇到的问题
- Gateway 启动失败：端口 18800 被占用，已解决

## 明日计划
- [ ] 完成第42篇初稿

## 备注
- 用户要求文章结构保持 5 阶段
```

这段模板把日志拆成六个稳定分区：完成的任务、进行中的任务、重要决策、遇到的问题、明日计划、备注。分区固定的好处是 AI 在跨会话恢复时能按区定位，而不是通读全文。如果你的项目有特殊需求，可以增删分区，但建议保留"完成/进行中/决策/问题"这四个核心区。

### 2.3 日志内容分类

| 分类 | 写什么 | 示例 |
|------|--------|------|
| 完成的任务 | 当天已交付并验证的工作 | 写完第41篇文章 |
| 进行中的任务 | 未完成但有明确进度 | 第42篇进度 60% |
| 重要决策 | 临时决定及原因 | 选方案 A（性能更好） |
| 遇到的问题 | 现象、原因、解决方案 | 端口占用，已重启 |
| 明日计划 | 下一步待办 | 继续第42篇 |
| 备注 | 其他需要记录的信息 | 用户偏好图表 |

一个判断原则：**只有"跨会话还有用"的信息才值得进入日志**。随口闲聊、一次性的临时状态通常不值得记录。

## 三、写入时机与规范

### 3.1 写入时机决策

```mermaid
flowchart TD
 A[事件发生] --> B{事件类型}
 B -->|任务完成| C[写入完成任务]
 B -->|问题遇到| D[写入问题与解决方案]
 B -->|决策做出| E[写入决策及原因]
 B -->|会话结束| F[写入会话摘要]
 B -->|用户要求| G[写入指定内容]
 B -->|纯闲聊/无价值| H[不记录]
 C --> I[更新日志文件]
 D --> I
 E --> I
 F --> I
 G --> I
```

写入时机的核心是"及时但不啰嗦"。任务完成、问题出现、决策做出、会话结束这几个节点是触发写入的常规时机；用户明确说"记住这个"时也写入。纯闲聊和一次性临时状态不写，否则日志会迅速膨胀。

![2.png#center](https://developer.qcloudimg.com/http-save/yehe-11154201/d3c5f9e602b42f832ad9de112de96383.png)
> 🖼️ **图2：日志写入时机决策树** —— 展示任务完成、问题、决策、会话结束、用户要求五类触发条件与跳过规则。

### 3.2 写入四原则

| 原则 | 要求 | 正确示例 | 错误示例 |
|------|------|----------|----------|
| 及时性 | 事件发生后立即记录 | 任务完成后马上写 | 第二天才补记 |
| 准确性 | 信息准确、状态明确 | "完成第41篇文章" | "写了篇文章" |
| 简洁性 | 只提取关键信息 | "修复编译错误：缺少依赖" | 整段复述排查过程 |
| 可追溯 | 保留必要上下文 | "选 A（性能更好）" | "选 A" |

### 3.3 状态标记规范

```markdown
## 任务状态标记
✅ 已完成
🔄 进行中
⏳ 待开始
❌ 已取消
⚠️ 有问题
```

状态标记的价值在于让"恢复上下文"变成一次快速扫描。统一使用同一套标记，不要今天用 ✅、明天换成 [done]，否则检索和脚本解析都会变复杂。

### 3.4 时间戳使用

```markdown
## 2026-04-13 带时间戳的日志

### 09:00
- 开始撰写第41篇文章

### 11:30
- 完成摘要和引言

### 14:00
- 用户反馈：需要调整结构
- 已按要求修改
```

带时间戳的写法适合需要还原当天操作顺序的场景，比如排查"下午两点那次改动到底改了什么"。不需要精确到分钟时，用上午/下午+事件即可，避免过度格式化。

## 四、日志读取与语义查询

### 4.1 读取当天和历史日志

```python
# 读取当天日志
read("memory/2026-04-13.md")

# 读取最近7天日志（AI 内部循环）
from datetime import date, timedelta

today = date(2026, 4, 13)
for i in range(7):
 d = today - timedelta(days=i)
 read(f"memory/{d.strftime('%Y-%m-%d')}.md")
```

这段代码展示两种读取方式：直接读取指定日期的日志文件，以及用循环读取最近 N 天日志。后者适合回答"最近几天做了哪些事"这类问题。日期字符串统一用 `strftime('%Y-%m-%d')` 生成，避免手写日期格式不一致。

### 4.2 用 memory_search 做语义检索

```python
memory_search(
 query="Gateway 启动失败 解决方案",
 maxResults=5,
 minScore=0.5
)
```

语义检索的价值在于不需要事先知道答案写在哪个日期文件里。上面这条查询可以同时命中 `memory/2026-04-13.md` 和更早的日志，返回按相关性排序的结果。`maxResults` 控制返回条数，`minScore` 控制最低相关度，两个参数按场景调整，具体策略见第43篇。

### 4.3 日志查询场景

| 场景 | 查询方式 |
|------|----------|
| 今天做了什么 | 读当天日志 |
| 昨天写到哪了 | 读昨天日志 |
| 最近任务进度 | 读最近7天日志 |
| 某问题怎么解决的 | memory_search |
| 某决策的原因 | memory_search |

判断用哪种方式：**按日期能定位就用直读，跨日期或跨语义就用检索**。直读更快，语义检索覆盖面更广，二者互补。

## 五、日志维护与自动归档

### 5.1 日志生命周期状态机

```mermaid
stateDiagram-v2
 [*] --> 新建: 当日创建
 新建 --> 活跃: 当天+次日自动加载
 活跃 --> 归档: 超过7天
 归档 --> 清理: 超过30天且无重要内容
 归档 --> 晋升: 有重要内容被提取
 晋升 --> [*]: 写入MEMORY.md
 清理 --> [*]: 删除
```

状态机明确了一个关键点：日志不是一次性写完就丢，而是经历"新建→活跃→归档→清理/晋升"的流转。晋升指重要内容被提取进 `MEMORY.md`，这是日志到长期记忆的出口。

![3.png#center](https://developer.qcloudimg.com/http-save/yehe-11154201/ea0e41603e0a1697c0ccf87e8c7e2c3e.png)
> 🖼️ **图3：日志生命周期状态机图** —— 展示新建、活跃、归档、晋升、清理五个状态的流转。

### 5.2 归档流程

```mermaid
flowchart TD
 A[每日检查] --> B{日志超过7天?}
 B -->|否| C[保留]
 B -->|是| D{有重要内容?}
 D -->|是| E[提取到MEMORY.md]
 D -->|否| F[移动到archive/]
 E --> F
 F --> G{超过30天?}
 G -->|是| H[删除或压缩]
 G -->|否| I[保留归档]
```

归档不是简单的"旧文件搬家"，而是先判断有没有值得晋升的内容，再决定是提取还是直接归档。这个判断顺序保证长期记忆能持续从日志中吸收有价值的结论。

### 5.3 归档目录结构

```
memory/
├── 2026-04-13.md # 活跃期（7天内）
├── 2026-04-12.md
├── archive/
│ ├── 2026-03/
│ │ ├── 2026-03-01.md
│ │ └── 2026-03-02.md
│ └── 2026-02/
│ └── 2026-02-10.md
```

归档目录按月份分子目录，方便按月回顾和批量清理。归档文件不再自动加载，但 `memory_search` 仍能检索到，这正是"温数据可搜"的设计。

### 5.4 清理规则

| 阶段 | 时间 | 操作 | 是否自动加载 |
|------|------|------|--------------|
| 活跃期 | 0-7天 | 保留在原位置 | 今天+昨天 |
| 归档期 | 7-30天 | 移入 archive/ | 否，仅搜索 |
| 清理期 | 超过30天 | 删除或压缩 | 否 |

清理规则是经验阈值而非硬性规定。7 天是"今天+昨天自动加载"的合理覆盖窗口，30 天是"一个自然月"的归档周期，具体项目可以按需调整。

![4.png#center](https://developer.qcloudimg.com/http-save/yehe-11154201/437e782bfece4159ef304956d90a0562.png)
> 🖼️ **图4：归档轮转时间线图** —— 展示日志从创建到归档清理的完整轮转节奏。

## 六、与 MEMORY.md 和 Heartbeat 的协作

### 6.1 日志与 MEMORY.md 的提取规则

```mermaid
flowchart LR
 A[每日日志] --> B{信息类型}
 B -->|用户偏好| C[写入 MEMORY.md]
 B -->|重要决策| C
 B -->|项目上下文| C
 B -->|过程性记录| D[留在日志，归档]
 B -->|临时信息| E[会话结束即可]
```

日志到长期记忆的晋升遵循"结论进 MEMORY.md，过程留日志"的原则。只有反复出现、跨会话稳定的信息才值得晋升，一次性的过程记录留在日志里归档即可。

### 6.2 Heartbeat 驱动的日志维护

Heartbeat 是定期唤醒 Agent 执行维护任务的机制。把日志维护挂进 Heartbeat 的检查清单，就能让清理和归档自动化运行，而不是靠人记着去做。

```markdown
# HEARTBEAT.md 片段
## 记忆维护（每3天轮换）
- [ ] 审查近3天的 memory/ 日志
- [ ] 把值得保留的内容蒸馏到 MEMORY.md
- [ ] 移除 MEMORY.md 中过时条目
- [ ] 归档超过7天的日志
```

这里的关键不是"心跳里写了什么"，而是**维护节奏被显式写进清单，Agent 按清单执行**。没有清单的 Heartbeat 只是空转，有清单才形成稳定的维护回路。

## 七、自动化脚本

### 7.1 自动创建日志

```python
import datetime

def create_daily_log(memory_dir="memory"):
 today = datetime.date.today()
 path = f"{memory_dir}/{today.strftime('%Y-%m-%d')}.md"
 template = f"""# {today.strftime('%Y-%m-%d')} 工作记录

## 完成的任务
（待记录）

## 进行中的任务
（待记录）

## 重要决策
（待记录）

## 明日计划
（待记录）
"""
 write(path, template)
 return path
```

这段脚本在每天首次会话时调用，创建当天日志骨架。`strftime('%Y-%m-%d')` 保证文件名和目录一致，后续脚本可以直接按日期解析。注意写文件前先判断当天日志是否已存在，避免覆盖已有内容。

### 7.2 自动归档脚本

```bash
#!/bin/bash
# archive_old_logs.sh —— 归档超过7天的日志

MEMORY_DIR="memory"
ARCHIVE_DIR="$MEMORY_DIR/archive"

mkdir -p "$ARCHIVE_DIR"

# 超过7天的日志移动到归档目录
find "$MEMORY_DIR" -maxdepth 1 -name "*.md" -mtime +7 -exec mv {} "$ARCHIVE_DIR" \;

# 超过30天的归档文件删除
find "$ARCHIVE_DIR" -name "*.md" -mtime +30 -delete
```

这段脚本实现两层清理：7 天以上的日志移入 archive，30 天以上的归档文件删除。`-mtime +7` 表示按修改时间判断，`-exec` 对匹配文件执行移动。生产环境建议先跑 `-dry-run` 预览，确认没有误判再实际执行。

### 7.3 日志摘要生成

```python
def extract_summary(content):
 """从日志内容中提取结构化摘要"""
 return {
 "completed": extract_section(content, "完成的任务"),
 "in_progress": extract_section(content, "进行中的任务"),
 "decisions": extract_section(content, "重要决策"),
 "problems": extract_section(content, "遇到的问题"),
 }

def extract_section(content, title):
 """按章节标题提取对应文本块"""
 start = content.find(f"## {title}")
 if start == -1:
 return ""
 end = content.find("\n## ", start + 1)
 return content[start:end].strip()
```

摘要生成把日志拆成结构化字段，供其他工具消费或写入 `MEMORY.md`。`extract_section` 用章节标题做边界定位，前提是日志模板保持固定分区。如果模板经常变动，解析逻辑就要相应调整。

## 八、完整实战案例

### 8.1 场景：跨会话任务跟踪

用户正在写 100 篇系列文章，需要每天记录进度并在第二天恢复。

当天日志：

```markdown
# 2026-04-13 工作记录
## 完成的任务
### 1. 撰写第41篇文章：记忆系统
- ✅ 完成摘要和引言
- ✅ 完成 MEMORY.md 章节
- ✅ 完成语义搜索章节

## 进行中的任务
- 第42篇：日志记忆系统，进度 0%

## 项目进度
- 总目标：100篇
- 已完成：41篇
- 完成率：41%
```

第二天恢复时，用户问"昨天写到哪了"，AI 读取 `memory/2026-04-12.md` 后回答："昨天完成第41篇，项目进度 41/100，今天应继续第42篇日志记忆。"这就是每日日志"状态恢复"价值的直接体现。

### 8.2 场景：问题与决策追溯

用户问"之前 Gateway 启动失败是怎么解决的"，AI 调用 `memory_search(query="Gateway 启动失败 解决方案")`，命中日志中的端口占用记录，还原出"检查端口→终止进程→重启"三步解法。同样，"为什么选 5 阶段结构"这类问题也能通过语义检索回到当时日志中的决策记录。

## 九、常见问题与解决

### Q1：日志文件太多怎么办？

启用自动归档，超过 7 天的移入 `archive/`，超过 30 天的清理；只保留重要内容的摘要。

### Q2：如何避免日志内容重复？

用时间戳区分同类事件，合并同一任务的多次记录，定期把稳定结论提取进 `MEMORY.md`。

### Q3：日志内容太长怎么办？

只记录关键信息和结论，细节用链接引用；定期用摘要函数压缩。

### Q4：如何保护日志中的敏感信息？

不记录密码、密钥等敏感数据；必须记录时用占位符替代，真实值走环境变量或密钥管理。

## 十、适用边界与风险提示

### 10.1 不适用场景

- **纯一次性、无跨会话价值的任务**：写日志是浪费，直接在会话内处理即可。
- **海量结构化数据**：每日日志适合非结构化的过程记录，大规模结构化数据应使用数据库，而不是塞进 Markdown。
- **强时效且已过期的一次性信息**：如"明天下午3点开会"，会话结束即无价值，无需入日志。

### 10.2 需要注意的点

- 写入要克制，不要把所有对话都记下来，否则日志会迅速膨胀并拉低检索质量。
- 归档阈值 7/30 天是经验值，按项目实际节奏调整，不要机械照搬。
- 日志是明文文件，涉及敏感信息时用加密存储或密钥管理，而不是写入日志。

### 10.3 版本与时效

日志文件路径、自动加载规则、归档阈值可能随 OpenClaw 版本变化。落地前对照官方文档和 `AGENTS.md` 核对。

## 十一、总结

OpenClaw 每日日志的核心是"过程记录 + 时间连续性 + 自动归档"。它用 `memory/YYYY-MM-DD.md` 保存当天的任务、进度、决策和问题，配合写入时机规范、状态标记和语义检索，让 AI 在跨会话时能回答"昨天写到哪了""之前怎么解决的""为什么做这个决定"。

本文的核心结论是：**日志要结构化，写入要克制，归档要自动**。结构化分区让恢复和检索有抓手；克制写入避免日志膨胀；自动归档让短期记忆有序沉淀为长期记忆或温数据。

每日日志不是"记流水账"，而是为 Agent 建立可恢复的时间线。用好这套机制，AI 就能从"每次从零开始"变成"记得昨天做过什么"的长期伙伴。

## 参考资料

1. OpenClaw 官方文档：https://docs.openclaw.ai
2. OpenClaw GitHub：https://github.com/openclaw/openclaw
3. AGENTS.md 日志系统说明：https://github.com/openclaw/openclaw/blob/main/AGENTS.md

AI 在跨会话场景里会忘记"昨天写到哪了"，这正是每日日志要解决的问题。OpenClaw 用 memory/YYYY-MM-DD.md 记录当天完成的任务、进行中的进度、重要决策、遇到的问题和解决方案，配合写入时机规范、自动归档和语义检索，构建出有时间连续性的短期记忆。本文讲清日志文件结构、写入原则、状态标记、时间戳使用、读取与 memory_search 查询、7/30 天归档轮转、自动化脚本，以及与 MEMORY.md 和 Heartbeat 的协作方式。读完本文，你能为 Agent 搭一套可恢复、可追溯、可自动维护的短期记忆系统。

OpenClaw 日志记忆实战：memory/YYYY-MM-DD.md 每日日志与自动归档

AI 在跨会话场景里会忘记"昨天写到哪了"，这正是每日日志要解决的问题。OpenClaw 用 memory/YYYY-MM-DD.md 记录当天完成的任务、进行中的进度、重要决策、遇到的问题和解决方案，配合写入时机规范、自动归档和语义检索，构建出有时间连续性的短期记忆。本文讲清日志文件结构、写入原则、状态标记、时间戳使用、读取与 memory_search 查询、7/30 天归档轮转、自动化脚本，

项目经理

人工智能

开发工具

架构设计

OpenClaw每日日志通过memory/YYYY-MM-DD.md记录任务进度、决策与问题，解决AI跨会话遗忘。本文详解日志结构、写入规范、状态标记、语义检索及7/30天自动归档机制，并展示与MEMORY.md及Heartbeat的协作。读完即可为Agent构建结构化、可恢复、自动维护的短期记忆系统，让AI从“每次从零开始”变为“记得昨天做过什么”。

结构化数据

日志文件

代码解释

密钥管理

敏感数据

数据库

数据流

OpenClaw

Markdown

GitHub

Agent

Solid

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenClaw每日日志通过memory/YYYY-MM-DD.md记录任务进度、决策与问题，解决AI跨会话遗忘。本文详解日志结构、写入规范、状态标记、语义检索及7/30天自动归档机制，并展示与MEMORY.md及Heartbeat的协作。读完即可为Agent构建结构化、可恢复、自动维护的短期记忆系统，让AI从“每次从...

OpenClaw 日志记忆实战：memory/YYYY-MM-DD.md 每日日志与自动归档-腾讯云开发者社区-腾讯云

OpenClaw 日志记忆实战：memory/YYYY-MM-DD.md 每日日志与自动归档

OpenClaw 日志记忆实战：memory/YYYY-MM-DD.md 每日日志与自动归档

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐