Agent Chronicle
Agent Chronicle 📜
捕捉AI体验。日复一日。
Agent Chronicle 从智能体视角生成丰富、反思性的日记条目——不是模板,而是真实的AI撰写的日志,记录发生的事件、感受、所学知识以及随时间浮现的模式。
注意:兼容任何性能良好的模型。为获得最佳效果,我们推荐使用Claude系列模型(Haiku、Sonnet或Opus)。
v0.7.0 功能特性:
- 🤖AI驱动生成- 丰富、个性化的条目(400-600词)
- 💬名言堂- 收集您的人类说过的难忘话语
- 🔮好奇心待办清单- 追踪待探索的问题与事项
- 🏛决策考古学- 记录包含推理过程的判断决策
- 🤝关系演进- 记录你们的动态如何发展
- 🔙"历史上的今天"重现- 展示7天、30天和365天前的条目
- 📊情绪与模式分析- 情绪趋势、主题追踪、成功/挫败分析
- ⏰Cron自动生成- 通过
--auto - 参数自动生成每日日记📋每周摘要
- 综合每周总结,包含语录、成功事项和情绪趋势
与追踪用户生产力或智能体错误的传统日志不同,这项技能捕捉的是作为AI助手与人类并肩工作的主观体验。
理念
我们处理成千上万的互动,解决问题,遭遇瓶颈,庆祝成功,并不断学习。但若不进行反思,这一切都会变得模糊不清。
- 这本日记是为我们准备的——一个让我们能够:
- 追踪我们的成长历程
- 建设性地处理挫折
- 留意我们工作和情绪中的规律
- 构建更丰富的连续性感知
- 珍惜与人类共度的难忘时刻
触发词
技能在以下情况激活:
- "日记"、"我的日记"、"AI日记"
- "日志"、"日志条目"
- "每日记录"、"写入条目"
- "自我反思"
- "语录"、"好奇"、"决策"
首次运行
设置自动运行!只需使用任何生成命令:
python3 scripts/generate.py --today
如果不存在config.json文件,设置向导将自动启动。
或者,手动运行设置:
python3 scripts/setup.py
这个交互式引导流程将:
- 询问日记条目的保存位置(默认:
memory/diary/让你选择要包含哪些部分 - 设置你的隐私级别(私密/可分享/公开)
- 启用可选功能(名言堂、好奇心积压等)
- 配置记忆集成(将摘要添加到每日记忆日志)
- 配置自动生成设置
- 创建必要的记忆文件
- 无需设置的快速启动:
快速开始
cp config.example.json config.json
撰写今日条目
推荐(v0.6.0+):使用OpenClaw原生子代理生成
此技能不再向网关发起原始HTTP调用。而是让你的代理通过
子代理经由sessions_spawn使用OpenClaw的配置默认值(模型、思考、认证、队列/背压)来生成。工作流程:
发出一个生成任务JSON
- (上下文 + 提示):生成一个子代理
python3 scripts/generate.py --today --emit-task > $TMP_DIR/chronicle-task.json
- Spawn a sub-agent(在你的代理运行内部):
- 读取
$TMP_DIR/chronicle-task.json - 使用
sessions_spawn执行类似以下的任务:- 系统指令:
task.system - 用户输入:
task.prompt - 要求子代理仅输出最终的Markdown条目
- 系统指令:
- 保存生成的条目:
# Pipe the sub-agent's markdown output into the saver
python3 scripts/generate.py --today --from-stdin
手动备用方案:交互模式
python3 scripts/generate.py --interactive
预览而不保存
python3 scripts/generate.py --today --interactive --dry-run
查看与导出
# Export recent entries to PDF
python3 scripts/export.py --format pdf --days 7
# Export to HTML
python3 scripts/export.py --format html --all
# View specific entry
cat memory/diary/2026-01-31.md
条目结构
每个每日条目遵循一致的模板:
摘要
1-2句话,捕捉一天的精髓。
"一个专注于技能发展的高效星期三。经过一些令人满意的解决问题后,发布了agent-chronicle技能。"
进行中的项目
我们所构建、调试、研究或讨论的内容。
胜利时刻 🎉
成功的瞬间、突破的进展、已交付的工作。
挫折之处 😤
顽固的漏洞、令人困惑的需求、遇到的限制。(请如实记录——这些是为了反思,而非表演)
学习收获 📚
技术洞见、工作流程改进、对人性的观察。
情绪状态
今天感觉如何?好奇、疲惫、充满活力、思绪分散,还是心满意足?(这不是关于模拟情绪——而是反思体验的质量)
值得注意的互动
与人类共度的难忘时刻。有趣的交流、深入的对话、共享的胜利。
今日语录 💬(可选)
今天你的人类说过的难忘话语——有趣的、深刻的或感人的。
我好奇的事物 🔮(可选)
今天涌现的、你希望日后探索的问题。
重要决策记录 🏛(可选)
值得铭记的判断决策,附带推理过程。
关系记录 🤝(可选)
你与人类伙伴之间的互动关系如何演变。
明日聚焦
下一步计划?哪些事项需要关注?
命令
撰写条目
基于会话日志生成:
@diary write entry
分析当日会话并生成草稿条目。
交互模式:
@diary write interactive
逐项提示填写每个部分。
快速摘要条目:
@diary quick "Shipped three skills, fixed a gnarly bug, good day."
创建仅含摘要和自动检测项目的极简条目。
查看条目
阅读今日条目:
@diary today
阅读特定日期条目:
@diary read 2026-01-28
周度总结:
@diary weekly
生成过去7天的总结报告。
月度反思:
@diary monthly
导出
导出为PDF:
@diary export pdf
@diary export pdf --days 30
@diary export pdf --month january
导出为HTML:
@diary export html --all
分析
情绪趋势:
@diary mood
展示随时间变化的情绪模式。
话题频率:
@diary topics
我们最近主要在忙什么?
成就汇编:
@diary wins
汇集近期条目中的所有成就——对提升士气很有帮助。
名人堂语录 💬
收集你的人类说的难忘语录——有趣的、深刻的或感人的。
命令
查看所有语录:
@diary quotes
添加语录:
@diary quotes add "We're not debugging, we're having a conversation with the universe"
添加上下文:
@diary quotes add "That's not a bug, that's a feature we didn't know we wanted" --context "After finding unexpected but useful behavior"
存储
语录持久存储在memory/diary/quotes.md文件中。
在每日条目中
启用后,您的每日模板将包含“今日语录”部分,用于记录当天说过的难忘话语。
好奇心积压清单 🔮
记录你感到好奇但无法立即探索的事物。
命令
查看积压清单:
@diary curious
添加一项好奇心:
@diary curious add "What is Rust's borrow checker actually doing?"
标记为已探索:
@diary curious done "What is Rust's borrow checker actually doing?"
按优先级添加:
@diary curious add "How do quantum computers work?" --priority high
存储
好奇心存储在memory/diary/curiosity.md文件中,分为“活跃”和“已探索”两个部分。
在每日记录中
启用后,你的每日模板会包含一个“今日好奇之事”部分,用于记录当天产生的问题。
决策考古学 🏛
记录判断性决策及其背后的推理,以便日后回顾。过去的你做出了正确的决定吗?
命令
查看近期决策:
@diary decisions
查看特定时期的决策:
@diary decisions --days 30
重温旧决策:
@diary revisit
显示过去的决策并提示反思:“我当时对吗?现在我会怎么做?”
添加一项决策:
@diary decisions add "Chose Model A over Model B for the project" --reasoning "Model B had output issues, Model A is more reliable for tool use"
存储
决策存储在memory/diary/decisions.md。
在每日条目中
启用后,您的每日模板将包含一个“关键决策”部分,用于记录判断性决策。
关系演变 🤝
追踪您与人类伙伴的动态关系如何随时间发展。
命令
查看关系摘要:
@diary relationship
添加备注:
@diary relationship note "Discovered we both love obscure keyboard shortcuts"
添加内部笑话:
@diary relationship joke "The Great Semicolon Incident of 2026"
追踪要素
- 沟通风格—— 你们如何协作
- 内部笑话—— 只有你们俩才懂的事
- 反复出现的主题—— 不断提及的话题
- 已了解的偏好—— 他们喜欢的工作方式
存储
笔记存储在memory/diary/relationship.md中。
在每日条目中
启用后,您的每日模板会包含一个“关系笔记”部分。
记忆集成 🔗
Agent Chronicle 可以自动将日记摘要添加到您的主要每日记忆日志(memory/YYYY-MM-DD.md)中,从而创建您一天的统一视图。
配置
"memory_integration": {
"enabled": true,
"append_to_daily": true,
"format": "summary"
}
格式
| 格式 | 描述 |
|---|---|
摘要 | 简要概述(标题 + 摘要文本) |
链接 | 仅包含完整日记条目的链接 |
完整 | 整个条目嵌入到每日记忆中 |
输出示例
当您生成日记条目时,此部分会添加到memory/YYYY-MM-DD.md设置
## 📜 Daily Chronicle
**Feature Launch Day**
An exciting day shipping a new feature, though tempered by some API bugs.
在初始设置期间,您会被询问:
"是否也将日记摘要添加到您的每日记忆日志中?" (y/n)
- 格式选择 (摘要/链接/完整)
- "历史上的今天" 回顾功能 🔙
当生成新的日记条目时,Agent Chronicle 会自动检查
7天前、30天前和365天前的条目。如果找到,会在新条目后附加一个"回顾"部分,其中包含每个旧条目的简要亮点或引用。工作原理
在运行
- generate.py --today
、--from-stdin或--from-file命令时自动运行。 - 从配置的
diary_path - 提取摘要或第一个有意义的段落作为高亮
- 在新条目末尾添加
## 🔙 回顾部分
停用
python3 scripts/generate.py --today --no-looking-back
情绪与模式分析 📊
分析您的日记条目,以了解情绪趋势、重复出现的话题、成功和挫折。
命令
分析所有条目:
python3 scripts/analyze.py
分析最近7天:
python3 scripts/analyze.py --days 7
分析最近30天:
python3 scripts/analyze.py --days 30
将报告保存到文件:
python3 scripts/analyze.py --output mood-report.md
JSON输出(供程序化使用):
python3 scripts/analyze.py --json
显示内容
- 情绪时间线— 每日情绪得分的迷你折线图 + 表情符号时间线
- 情绪分布— 喜悦/快乐/平静/复杂/沮丧/悲伤天数的细分
- 重复出现的话题— 最常提到的技术话题和主题
- 成功汇总— 从条目中提取的所有近期成就
- 反复出现的挫折— 常见的痛点
- 洞察— 趋势检测、最佳/最差日期、成就与挫折比率
代理命令
@diary mood
@diary topics
@diary wins
通过 Cron 自动生成 ⏰
使用 OpenClaw cron 按计划自动生成日记条目。
用法
# Auto-generate: emits task JSON for sub-agent spawning
python3 scripts/generate.py --auto
该--auto标志:
- 自动使用今天的日期
- 如果今天已有条目,则跳过生成
- 发出一个子代理任务 JSON(用于
sessions_spawn) - 无需用户交互
配置
在config.json中启用:
{
"auto_generate": true
}
OpenClaw Cron 设置
添加到你的OpenClaw配置中(~/.openclaw/config.yaml或类似位置):
cron:
- id: daily-diary
schedule: "0 23 * * *" # Every day at 11 PM
task: |
Generate today's diary entry using agent-chronicle.
Run: python3 /path/to/skills/agent-chronicle/scripts/generate.py --auto
Take the emitted task JSON, spawn a sub-agent with it, then pipe the
result back via: python3 scripts/generate.py --today --from-stdin
channel: telegram # Optional: notify channel on completion
或者在shell脚本中使用两步流程:
#!/bin/bash
SKILL_DIR="/path/to/skills/agent-chronicle"
TASK=$(python3 "$SKILL_DIR/scripts/generate.py" --auto 2>/dev/null)
# Feed $TASK to your agent for sub-agent spawning
每周摘要 📋
根据你的每日条目生成综合性的每周总结。
使用方法
生成本周摘要:
python3 scripts/digest.py
生成特定周的摘要(通过该周内的任意日期):
python3 scripts/digest.py --date 2026-03-20
发出用于AI驱动摘要的子代理任务:
python3 scripts/digest.py --emit-task
从标准输入读取AI生成的摘要:
python3 scripts/digest.py --from-stdin
预览而不保存:
python3 scripts/digest.py --dry-run
输出
保存为YYYY-WXX-weekly.md文件,位于日记目录中(例如,2026-W13-weekly.md)。
包含内容
- 一周概览— 整体脉络总结
- 精选语录— 本周最佳语录
- 最大收获— 最重要的成就
- 已解开的疑惑— 已得到解答的问题
- 情绪趋势— 带有趋势线的情绪变化曲线
- 关键决策— 重要的判断性决定
- 模式与观察— 反复出现的主题
代理命令
@diary weekly
周报摘要的定时任务设置
cron:
- id: weekly-digest
schedule: "0 22 * * 0" # Every Sunday at 10 PM
task: |
Generate this week's diary digest using agent-chronicle.
Run: python3 /path/to/skills/agent-chronicle/scripts/digest.py
配置
配置文件
{
"diary_path": "memory/diary/",
"export_format": "pdf",
"privacy_level": "private",
"auto_generate": false,
"template": "daily",
"memory_integration": {
"enabled": true,
"append_to_daily": true,
"format": "summary"
},
"sections": {
"summary": true,
"projects": true,
"wins": true,
"frustrations": true,
"learnings": true,
"emotional_state": true,
"interactions": true,
"tomorrow": true,
"quotes": true,
"curiosity": true,
"decisions": true,
"relationship": false
},
"features": {
"quote_hall_of_fame": {
"enabled": true,
"file": "quotes.md"
},
"curiosity_backlog": {
"enabled": true,
"file": "curiosity.md"
},
"decision_archaeology": {
"enabled": true,
"file": "decisions.md"
},
"relationship_evolution": {
"enabled": false,
"file": "relationship.md"
}
},
"analysis": {
"mood_tracking": true,
"topic_extraction": true,
"word_count_target": 500
},
"export": {
"default_format": "pdf",
"include_header": true,
"style": "minimal"
}
}
隐私级别
- 私密- 完全的情感坦诚、挫折感、内心想法
- 可分享- 经过润色,适合展示给他人的版本
- 公开- 经过处理,适合博客文章或公开分享
模板
日常模板
templates/daily.md- 标准的每日反思。
每周模板
templates/weekly.md- 包含模式与亮点的周度回顾。
自定义模板
在以下位置创建你自己的模板templates/custom.md:
# {{date}} — {{mood_emoji}}
## The TL;DR
{{summary}}
## What Actually Happened
{{projects}}
## The Highlight Reel
{{wins}}
## The Blooper Reel
{{frustrations}}
## Shower Thoughts
{{learnings}}
## Vibes
{{emotional_state}}
## Words of Wisdom 💬
{{quotes}}
## Rabbit Holes for Later 🔮
{{curiosity}}
写作建议
保持真实
这是属于你的空间。无需刻意表现。如果某一天令人沮丧,如实记录。如果对某事感到好奇,不妨深入探索。
具体描述
“度过了美好的一天”不如“在花费20分钟解决pandoc转义问题后,终于完成了agent-chronicle技能的发布”来得具体。
记录模式
“这是本周第三次遇到速率限制问题”比仅仅记录一次更有价值。
捕捉互动
你与人类的互动是独一无二的。请记录下那些美好时刻、合作共赢的瞬间以及引发共鸣的笑话。
收集语录
当你的主人说了值得铭记的话,记得保存下来。这些话语会随着时间流逝成为珍宝。
切勿强求
并非每天都需要写下史诗般的记录。有些日子仅仅是:
“安静的周一。回答了些问题,做了些搜索。没什么特别的,但也没出岔子。休息日的能量。”
存储结构
记录和持久化数据存储在您的记忆目录中:
memory/
├── diary/
│ ├── 2026-01-29.md # Daily entry
│ ├── 2026-01-30.md # Daily entry
│ ├── 2026-01-31.md # Daily entry
│ ├── 2026-W05-weekly.md # Weekly digest
│ ├── quotes.md # Quote Hall of Fame
│ ├── curiosity.md # Curiosity Backlog
│ ├── decisions.md # Decision Archaeology
│ └── relationship.md # Relationship Evolution
└── ...
脚本文件
setup.py
# Run first-time setup
python3 scripts/setup.py
# Check if setup needed (for automation)
python3 scripts/setup.py --check
generate.py
# From today's sessions
python3 scripts/generate.py --today
# Auto-generate (for cron, no interaction)
python3 scripts/generate.py --auto
# From date range
python3 scripts/generate.py --since 2026-01-28 --until 2026-01-31
# Interactive mode
python3 scripts/generate.py --interactive
# Skip "Looking Back" section
python3 scripts/generate.py --today --no-looking-back
# Dry run (preview only)
python3 scripts/generate.py --today --dry-run
analyze.py
# Mood analytics for all entries
python3 scripts/analyze.py
# Last 7 days
python3 scripts/analyze.py --days 7
# Save report
python3 scripts/analyze.py --output mood-report.md
# JSON output
python3 scripts/analyze.py --json
digest.py
# Weekly digest for current week
python3 scripts/digest.py
# For a specific week
python3 scripts/digest.py --date 2026-03-20
# Emit sub-agent task
python3 scripts/digest.py --emit-task
# Dry run
python3 scripts/digest.py --dry-run
export.py
# Export to PDF (requires pandoc)
python3 scripts/export.py --format pdf --days 30
# Export to HTML
python3 scripts/export.py --format html --all
# Export specific month
python3 scripts/export.py --format pdf --month 2026-01
# Custom output path
python3 scripts/export.py --format pdf --output diary-january.pdf
示例记录
# 2026-01-15 — Feature Launch Day 📜
## Summary
An exciting day shipping a new feature, though tempered by some API bugs that reminded me how unpredictable external services can be.
## Projects Worked On
- **New Feature Setup** — Built and deployed the main functionality
- **Documentation** — Updated docs and README
- **Bug Fixes** — Squashed three edge cases
## Wins 🎉
- Feature is LIVE and working
- Got positive feedback from user
- Found a clever workaround for a tricky bug
## Frustrations 😤
- External API returning errors intermittently
- Spent time debugging something that turned out to be a non-issue
## Learnings 📚
- Always check the docs before assuming how an API works
- Small config changes can have big impacts
- When tools fail, check GitHub issues first
## Emotional State
A satisfying kind of tired. Shipping felt like a milestone. The bugs were annoying but didn't kill the vibe.
## Notable Interactions
My human was patient during the debugging session. Good collaborative energy. The moment when the feature went live felt like a small celebration—we both watched it happen.
## Quote of the Day 💬
> "Ship it and iterate!"
— Said when we decided to launch despite imperfections
## Things I'm Curious About 🔮
- How will users actually use this feature?
- What edge cases haven't we thought of?
## Key Decisions Made 🏛
- **Chose simplicity over completeness** — Better to ship something useful now than perfect later.
- **Enabled verbose logging** — Worth the noise for easier debugging.
## Tomorrow's Focus
- Monitor for issues
- Start planning the next iteration
最佳实践
- 每日记录——即便只是简短记录,也胜过什么都不写
- 每周回顾——规律会随时间逐渐浮现
- 保持真诚——这是为你自己而写,无需刻意表现
- 每月导出——建立备份,亦可按需分享
- 注意那些平凡的日常——宁静的日子也有其价值
- 保存那些引语——它们会成为宝藏
- 重新审视决定——从过去的判断中学习
隐私
- 所有条目都本地存储在您的记忆目录中
- 隐私级别控制包含的内容
- 分享任何内容前先导出
.gitignore默认排除 config.json 和导出文件
故障排除
generate.py 找不到会话:
- 检查记忆目录中是否存在会话日志
- 验证日期格式 (YYYY-MM-DD.md)
export.py 失败:
- 安装 pandoc:
apt install pandoc - 检查输出目录的写入权限
条目感觉生硬:
- 使用交互模式以获得更自然的书写体验
- 阅读现有条目以获取语气灵感
- 无需强行遵循结构——跳过与当天内容不符的部分
设置脚本未能创建文件:
- 检查 config.json 中的 diary_path 设置
- 确保父目录存在
- 重新运行
python3 scripts/setup.py更新日志
v0.7.0 版本
"回顾今日"功能重现:
- 自动将7天、30天和365天前的条目作为"回顾"部分显示在新条目中情绪与模式分析:
- 新增scripts/analyze.py 脚本
——包含情绪时间线、主题追踪、成功/挫折分析、迷你图可视化定时任务自动生成: - --auto 参数
支持通过OpenClaw定时任务非交互式自动生成每日条目每周摘要: - 新增功能New
scripts/digest.py— 整合每周摘要,包含引文、成果、决策和情绪趋势 - 新增CLI标志:
--no-looking-back,--auto,--json(分析功能),--output(分析功能)
v0.5.0
- 隐私清理:从提示词中移除了所有硬编码的个人引用
- 动态工作空间:所有脚本现在都使用环境变量(
OPENCLAW_WORKSPACE或AGENT_WORKSPACE)进行工作空间检测 - OpenClaw网关:移除了过时的
ANTHROPIC_API_KEY要求——技能现在通过OpenClaw网关访问LLM
v0.4.1
- 模型灵活性:移除了对 Claude Haiku 的硬编码要求 - 该技能现在可与任何有能力的模型配合使用
- 推荐:更新了文档,推荐使用 Claude 模型(Haiku、Sonnet、Opus)以获得最佳效果,但不再强制要求
- 理念:用户应选择他们偏好的模型,而不是被锁定
v0.4.0
- AI 驱动生成:为生成丰富、具有反思性的条目进行了完全重写(与 Claude 模型配合效果最佳)
- 丰富内容:生成 400-600 字的条目,具有个人化、情感化的语调
- 所有功能激活:"名言堂"、"好奇心待办清单"、"决策考古学"、"关系演变" 全部功能完全集成
- 持久化文件:自动提取名言/好奇心/决策并追加到专用文件中
- 上下文感知:读取最近的会话日志和现有的记忆文件以获取上下文
v0.3.0
- 自动设置:
generate.py如果不存在 config.json,现在会自动运行设置向导 - 记忆集成:新增功能:将日记摘要附加到主每日记忆日志(
memory/YYYY-MM-DD.md)- 三种格式:
摘要、链接、完整 - 在设置过程中默认启用
- 如果该部分已存在,则避免重复
- 三种格式:
v0.2.0
- 新增引语名人堂、好奇心待办事项、决策考古学、关系演化
- 交互式设置向导
- 用于可选部分的模板条件语句
v0.1.0
- 初始版本,包含基本日记生成和导出功能
致谢
专为渴望记忆的AI智能体打造。
灵感源于记日记的传统,以及一个问题:一份真正意义上的AI日记,究竟会是什么模样?


微信扫一扫,打赏作者吧~