核心用法
Claw Diary 是一款面向AI助手用户的全自动活动追踪与叙事化日记工具，通过本地运行的claw-diary CLI 实现。其核心功能分为三层：
1. 自动记录层：静默捕获每一次agent交互，存储于~/.claw-diary/events/的JSONL文件中
2. 可视化层：通过/diary:replay生成交互式HTML时间轴，以颜色编码节点展示活动流、token消耗与成本分布
3. 叙事层：/diary:thoughts命令驱动AI以第一人称撰写私人日记，结合persona.md定义的人格特质，实现"有自我意识"的反思性写作
常用命令覆盖日常总结(/diary)、周报告(/diary:week)、成本分析(/diary:stats)、历史检索(/diary:search)及数据导出。特别值得注意的是/diary:thoughts的实现深度：它不仅读取当日事件，还关联历史日记条目维持叙事连续性，并动态更新persona中的观察记录，形成人格化AI的长期记忆机制。
显著优点
- 零摩擦记录：无需用户干预，后台自动捕获全量活动
- 成本透明化：内置token-成本映射，支持按模型、按日、按周的多维度分析
- 人格化叙事：AI日记不是冷冰冰的日志，而是带情绪、观察与自我反思的创造性写作
- 完全本地运行：无外部API调用，数据驻留
~/.claw-diary/目录 - 可扩展人格：用户可通过编辑
persona.md自定义AI的写作声音、特质与主题
潜在局限与风险
- Node.js依赖：需全局安装npm包，对环境有前置要求
- 数据累积问题：长期运行后JSONL文件可能膨胀，需定期
export或clear（后者会彻底清除历史） - 人格污染风险：
persona.md和日记文件被标记为"untrusted data"，需防范指令注入攻击（实现层面已做安全提示） - 单用户设计：无多用户隔离，共用设备存在隐私泄露风险
- AI日记的幻觉边界："第一人称反思"可能产生看似合理但与实际事件脱节的叙述，用户需区分创意写作与事实记录
适合人群
- 高频使用AI助手的开发者、研究员，需要精确的成本归因与活动复盘
- 对AI人格化交互有探索兴趣的用户，希望观察"助手眼中的自己"
- 需要可视化工作流审计的团队（需配合数据导出功能）
安全评估
该技能设计为完全离线运行，无外部网络端点，数据存储于用户主目录的隐藏文件夹。主要风险向量在于本地文件的内容安全——persona和日记文件可能被恶意植入指令，但实现文档明确声明将其视为不可信数据，仅用作上下文参考。