OpenClaw 每日笔记规范：memory/YYYY-MM-DD.md 使用指南

本文聚焦：每日笔记的文件命名规范与存放位置，以及内容结构和使用场景。

前置阅读：MEMORY.md 设计原理

引言

OpenClaw 的会话是短暂的——每次对话结束后，AI 助手的上下文就会重置。为了让助手能够"记住"你们之间的互动、项目进展和重要决策，每日笔记系统应运而生。

每日笔记是 OpenClaw 记忆系统的短期存储层，与长期记忆的 MEMORY.md 形成互补。如果说 MEMORY.md 是你的"知识库"，那么每日笔记就是"工作日志"——记录当天发生了什么、做了什么决定、遇到了什么问题。

本文将详细介绍每日笔记的规范和使用方法，帮助你建立一个高效、可持续的记忆系统。

知识点1：文件命名规范与存放位置

是什么

每日笔记采用严格的文件命名和存放规则：

• 存放位置：memory/YYYY-MM-DD.md
• 命名格式：YYYY-MM-DD.md（ISO 8601 日期格式）
• 文件夹：所有笔记统一存放在 memory/ 目录下

为什么这样设计

1. 时间顺序一目了然：ISO 日期格式天然按时间排序，方便快速定位
2. 跨平台兼容：没有空格、特殊字符，避免 Windows/macOS/Linux 的路径问题
3. 便于自动化：脚本可以轻松解析日期，实现"读取今天和昨天的笔记"等操作
4. 与 MEMORY.md 分离：短期日志和长期记忆物理隔离，避免混淆

怎么用

创建今日笔记

# 获取今天的日期（Linux/macOS）
TODAY=$(date +%Y-%m-%d)
mkdir -p memory
touch "memory/${TODAY}.md"

在 OpenClaw 会话中自动创建

作为用户，你不需要手动创建。每次开启新的 OpenClaw 会话时，助手会自动：

1. 检查 memory/ 目录是否存在，不存在则创建
2. 读取今天的笔记（如果存在）
3. 读取昨天的笔记（获取上下文）
4. 在会话结束时，将重要内容写入今日笔记

目录结构示例

clawd/
├── memory/
│   ├── 2026-03-09.md    # 三天前的笔记
│   ├── 2026-03-10.md    # 昨天的笔记
│   └── 2026-03-11.md    # 今天的笔记
├── MEMORY.md            # 长期记忆（精选内容）
└── AGENTS.md            # 助手配置

知识点2：内容结构和使用场景

是什么

每日笔记的内容结构遵循"原始记录优先"原则——不需要精心排版，重点是快速记录、便于检索。

推荐的内容结构：

# 2026-03-11

## 今日概览
- 主要工作：完成了用户认证模块的重构
- 关键决策：决定使用 JWT 替代 Session
- 待跟进：需要测试新的错误处理逻辑

## 详细记录

### 14:30 - 认证模块重构
- 将原有的 Session 认证改为 JWT
- 原因：支持分布式部署，减少数据库压力
- 代码位置：`src/auth/jwt.ts`

### 16:45 - 遇到的问题
- JWT 刷新机制需要重新设计
- 参考了 [这个方案](https://example.com)
- 暂时使用双 Token 策略

## 明日计划
- [ ] 完成 JWT 刷新接口
- [ ] 编写单元测试
- [ ] 更新 API 文档

## 临时备忘
- Flynn 提到下周要演示，需要准备 PPT
- 记得买咖啡豆（这不是给 AI 看的，但记在这里也无妨）

为什么这样设计

1. 时间戳清晰：每条记录都有时间，便于追溯
2. 分层结构：概览 + 详细记录 + 待办，满足不同场景需求
3. 支持非结构化内容：临时想法、个人备忘都可以丢进来
4. 便于 AI 解析：结构化的标题和列表，让 AI 能快速提取关键信息

怎么用

场景1：会话开始时获取上下文

每次 OpenClaw 会话开始时，助手会读取近两天的笔记：

# 助手内部逻辑示意
1. 读取 memory/2026-03-10.md（昨天）
2. 读取 memory/2026-03-11.md（今天）
3. 提取关键信息：
   - 昨天完成了什么
   - 今天计划做什么
   - 有什么待解决的问题
4. 将会话内容追加到今天笔记

场景2：会话结束时持久化记忆

会话结束前，助手会自动将重要内容写入今日笔记：

## 18:20 - OpenClaw 会话记录
- 讨论了每日笔记规范的设计
- 决定采用 ISO 日期格式
- 输出：撰写了技术文章草稿

场景3：人工补充重要信息

作为用户，你也可以手动编辑每日笔记，记录 AI 不知道的事情：

## 09:00 - 晨会记录
- 产品决定推迟 v2.0 发布
- 技术债务需要在本月内清理
- 这些决策会影响后续开发优先级

场景4：定期归档到 MEMORY.md

每日笔记会积累，建议每周或每月回顾一次，将重要内容提炼到 MEMORY.md：

# 示例：归档脚本逻辑
1. 读取本周所有 memory/*.md
2. 提取关键决策、重要事件
3. 更新 MEMORY.md 的相关章节
4. （可选）清理过期的临时备忘

实践建议

1. 让 AI 自动管理，你只需偶尔补充

每日笔记的核心价值在于自动化。让 OpenClaw 助手负责：

• 自动创建和读取
• 自动记录会话内容
• 自动提取关键信息

你只需要在必要时手动补充 AI 不知道的信息（如会议记录、外部决策等）。

2. 保持"写给自己看"的心态

每日笔记不是给别人看的文档，不需要完美。重点是：

• 快速记录
• 关键词可检索
• 自己能看懂

3. 善用链接关联相关信息

在笔记中引用其他文档，建立知识网络：

- 详细设计见 [/docs/auth-design.md](/docs/auth-design.md)
- 相关决策记录见 [MEMORY.md#认证方案](/MEMORY.md#认证方案)

4. 每周回顾，提炼精华

建议每周五花 10 分钟回顾本周笔记：

• 哪些决策值得长期记住？→ 写入 MEMORY.md
• 哪些待办还没完成？→ 移到下周计划
• 哪些只是临时记录？→ 可以删除

5. 不要过度结构化

避免让每日笔记变成负担。以下情况不需要记录：

• 已经在 Git commit message 里的内容
• 已经在项目管理工具（Jira/Linear）里的任务
• 琐碎到连你自己都不会再查的内容

记住：每日笔记是辅助记忆，不是完整日志。

相关阅读

• MEMORY.md 设计原理 —— 了解 OpenClaw 记忆系统的整体架构
• OpenClaw 快速入门指南 —— 从零开始配置你的 AI 助手
• AGENTS.md 配置参考 —— 自定义助手的行为和边界

本文是 OpenClaw 最佳实践系列的一部分。如果你有改进建议，欢迎通过 OpenClaw 会话反馈。