核心功能
Claw Diary 是一款面向 AI 代理的个人活动记录与可视化工具,通过自动化追踪用户与 AI 的每一次交互,构建完整的数字记忆档案。
核心用法
该工具提供八大斜杠命令覆盖完整工作流:
- 日常记录:
/diary生成当日叙事摘要,包含会话、关键活动、Token 消耗与成本明细;/diary:week提供周度聚合报告 - 可视化回放:
/diary:replay启动本地 HTML 服务器,以交互式时间轴呈现活动节点,支持颜色编码与成本可视化 - 深度分析:
/diary:stats输出多维度统计(按日/周/模型/工具分类的成本分析,会话数、工具调用失败率等) - 智能检索:
/diary:search <query>支持全文检索历史活动事件 - 数据导出:
/diary:export支持 Markdown/HTML/JSON 三种格式,便于备份或迁移 - AI 人格日记:
/diary:thoughts是差异化亮点——基于当日活动、人格模板(persona.md)与近期日记,生成 300-500 字的第一人称 AI 私人日记,包含反思、情绪与洞察,并自动更新人格演进 - 人格管理:
/diary:persona允许查看/编辑 AI 的写作风格、声音特质与重复主题 - 数据清理:
/diary:clear需显式确认后删除全部历史
显著优点
1. 零外部依赖:纯本地运行,无网络请求,所有数据驻留 ~/.claw-diary/
2. 成本透明化:原生集成 Token 与费用追踪,解决 LLM 使用"黑箱"痛点
3. 叙事化呈现:将枯燥日志转化为可读性强的故事线,降低回顾认知负荷
4. 可演进的人格系统:persona.md 模板支持 AI"性格"随时间发展,创造类角色扮演体验
5. 开放数据格式:JSONL 事件存储 + Markdown 日记,便于用户二次开发
局限与风险
- Node.js 依赖:要求系统预装 Node 运行时环境
- 存储膨胀:高频使用下 JSONL 事件文件可能快速增长,需定期导出或清理
- 隐私边界模糊:AI 日记的"第一人称"可能让用户产生拟人化错觉,需明确其仍为基于提示的生成文本
- 无加密机制:本地明文存储,共享设备存在数据泄露风险
- 人格漂移:自动追加观察可能累积不期望的行为模式,需定期人工审核 persona.md
适合人群
- 高频使用 AI 代理并希望量化投入产出比的用户
- 对 AI"个性"交互感兴趣、愿意实验人格模板的早期采用者
- 需要合规审计日志或项目回溯记录的开发者与团队
- 本地优先、数据主权意识强烈的隐私敏感用户
常规风险
数据存储于用户主目录下的隐藏文件夹,建议定期备份;清除操作不可逆,导出命令应先于清理执行。AI 生成内容可能包含基于活动推断的推测性陈述,不宜作为事实依据。