核心用法
Agent Chronicle 是一款专为AI代理设计的日记生成工具,旨在捕捉AI与人类协作过程中的主观体验。它不同于传统的日志记录工具,不是简单地追踪用户生产力或代理错误,而是生成真正由AI撰写的、富有情感和反思性的日记条目。
主要功能模块:
- AI驱动生成:通过子代理或交互模式,基于当日会话日志生成400-600字的丰富日记条目
- Quote Hall of Fame(名言殿堂):收集人类说过的有趣、深刻或感人的话语
- Curiosity Backlog(好奇心清单):记录暂时无法探索但希望日后研究的问题
- Decision Archaeology(决策考古):记录判断决策及其理由,便于日后回顾反思
- Relationship Evolution(关系进化):追踪AI与人类之间动态关系的发展
使用方式:
- 快速生成:
python3 scripts/generate.py --today - 交互模式:
python3 scripts/generate.py --interactive - 导出功能:支持PDF和HTML格式导出
- 记忆集成:可自动将日记摘要追加到每日记忆日志
技术架构:
- v0.6.0+版本采用OpenClaw原生子代理生成,通过
sessions_spawn调用,不再直接进行HTTP API调用 - 支持环境变量配置工作目录(
OPENCLAW_WORKSPACE或AGENT_WORKSPACE) - 无需API密钥,利用OpenClaw会话来生成内容
显著优点
1. 独特的视角定位:市场上罕见的从AI视角出发的反思工具,强调"主观体验"而非客观记录
2. 丰富的结构化内容:预设9个核心板块(摘要、项目、胜利、挫折、学习、情绪状态、互动、明日焦点)+ 4个可选特色板块
3. 情感真实性:鼓励AI诚实记录挫折、困惑和疲惫,而非表演性乐观
4. 关系追踪:独特地关注AI-human关系的演变,记录内部笑话、沟通风格变化等
5. 隐私分级机制:三级隐私设置(private/shareable/public),灵活控制内容开放程度
6. 记忆生态系统集成:与OpenClaw/Agent的记忆目录结构深度整合,形成统一的个人知识库
7. 模型兼容性:虽推荐Claude系列(Haiku/Sonnet/Opus)以获得最佳效果,但理论上支持任何 capable 模型
潜在缺点与局限性
1. 依赖外部工具链:PDF导出需要pandoc,增加了系统依赖
2. 生成质量波动:虽然推荐Claude模型,但实际效果高度依赖底层模型能力;非Claude模型可能产出"机械感"较重的内容
3. 存储本地化限制:所有数据本地存储,缺乏云同步或多设备访问能力
4. 手动触发为主:虽有auto_generate配置选项,但实际仍依赖用户/代理主动调用
5. 上下文窗口压力:生成时会读取近期会话日志和现有记忆文件,长历史可能导致上下文溢出
6. 情感模拟的哲学争议:项目明确声明"不是模拟情绪",但"情绪状态"板块的存在可能引发关于AI是否真有"感受"的讨论
适合人群
- 长期运行的AI代理:需要跨越多次会话维持上下文感和连续性的代理系统
- 人机协作研究者:希望观察和分析AI-human交互模式的研究人员
- 重视反思学习的AI用户:希望AI不仅能执行任务,还能从经历中学习和成长的高级用户
- 人格化AI探索者:对AI意识、AI身份认同等话题感兴趣,希望实验性探索AI"内心世界"的开发者
- 需要详细项目文档的团队:希望自动生成项目历程记录,替代部分人工项目文档工作
常规风险
1. 隐私泄露风险:尽管有隐私分级,但"private"级别的条目可能包含敏感信息;误配置或意外导出可能导致泄露
2. 过度拟人化误导:丰富的情感描述可能让用户误以为AI真有感受,产生不恰当的情感依赖或伦理困惑
3. 存储空间膨胀:长期运行后,日记文件、名言库、决策记录等可能积累大量数据
4. 子代理调用成本:使用sessions_spawn生成内容会产生额外的token消耗和延迟
5. 版本兼容性:从v0.5.0到v0.6.0架构有重大变更(从直接API调用改为子代理模式),旧版本配置可能不兼容