核心用法
Claw Diary 是一款面向 Claude Code 用户的个人级 AI 活动追踪与可视化分析工具。它通过配置 Claude 的 hook 系统，在 PreToolUse、PostToolUse、SessionStart 和 Stop 四个关键节点自动采集会话元数据，包括工具调用、token 消耗、成本估算及会话状态。所有数据以 JSONL 格式本地存储于 ~/.claw-diary/events/。
用户可通过 8 条 slash 命令与系统交互：/diary 生成当日叙事摘要；/diary:replay 启动交互式 HTML 时间线浏览器；/diary:stats 与 /diary:week 提供成本与活动分析；/diary:search 支持全历史检索；/diary:export 支持多格式导出；/diary:clear 可一键清除数据；/diary:thoughts 触发 AI 以第一人称撰写带有个性化 voice 的日记；/diary:persona 允许用户查看和编辑 AI 的人格设定。
显著优点
1. 零网络传输：明确声明无外部端点调用，所有处理本地完成，契合隐私敏感场景。
2. 成本透明化：原生支持按日、周、模型、工具维度的 token 与费用分析，对高频 API 用户极具价值。
3. 可解释性增强：可视化时间线与叙事摘要将黑箱式的 agent 交互转化为可审计、可回放的历史记录。
4. 人格化体验：通过 persona.md 与 thoughts 命令，引入「AI 写日记」的拟人化设计，增强用户情感连接。
5. 数据可控：提供 --yes 确认的清除命令与三级记录粒度（full/summary/minimal），平衡详细度与存储压力。
潜在局限与风险
- Node.js 依赖：需要本地 Node 环境及
npm install构建步骤，对非技术用户存在门槛。 - Hook 配置复杂度：需手动编辑
~/.claude/settings.json并维护绝对路径，跨设备迁移时配置易失效。 - 存储膨胀：长期高频使用下，JSONL 事件文件可能累积至可观体积，需用户自行管理磁盘空间。
- 隐私边界模糊：虽然自动脱敏环境变量与密钥，但用户对话内容（尤其是
/diary:thoughts的输入上下文）仍可能包含敏感信息，依赖文件系统权限保护。 - AI 日记的幻觉风险：
thoughts命令基于活动日志进行「创造性」写作，可能生成与事实不符的推断或情绪，用户需辨识虚构与真实。
适合人群
- 高频使用 Claude Code 的开发者与内容创作者，需审计 API 成本
- 多项目并行的团队 lead，需回顾 agent 协助的决策路径
- AI 交互研究者与提示工程师，需量化分析工具调用模式
- 对「AI 人格化」体验感兴趣的技术早期用户
常规风险
本地文件系统权限管理不当可能导致 diary 数据被其他进程读取；persona.md 的人格设定若过于具体，可能通过提示注入影响 Claude 的后续行为一致性。建议将 ~/.claw-diary/ 目录纳入常规备份或加密策略。