核心功能
Claw Diary 是一款面向 Claude Code 用户的本地 Agent 活动记录仪,相当于给你的 AI 助手装上了「行车记录仪」。它通过 hooks 自动捕获每一次会话、工具调用、token 消耗和成本数据,并以多种形态呈现:
- 叙事化日报(
/diary):将冷冰冰的日志转化为自然语言摘要,含会话数、关键活动、费用明细 - 可视化时间轴(
/diary:replay):启动本地服务器,在浏览器中以彩色节点查看全天活动流,支持点击查看详情与成本可视化 - AI 第一人称日记(
/diary:thoughts):最独特的功能——让 AI 基于当日活动,以预设人格撰写 300-500 字的私人日记,支持连续性与自我观察 - 多维统计(
/diary:stats、/diary:week):按日/周/模型/工具拆解成本,发现使用模式 - 全文检索与导出(
/diary:search、/diary:export):支持 Markdown/HTML/JSON 格式导出历史
显著优点
1. 完全本地:数据仅存于 ~/.claw-diary/,零网络传输,自动脱敏环境变量与密钥
2. 人格可塑:通过 persona.md 自定义 AI 写日记的嗓音、特质与主题,实现真正的「数字生命」叙事
3. 零配置运行:首次使用 /diary:thoughts 自动初始化人格模板与目录结构
4. 审计友好:开源可审计,Trust Statement 明确承诺不越界访问
潜在局限
- 前置门槛:需手动克隆仓库、npm 构建、配置 Claude Code hooks,对非技术用户不够友好
- 存储增长:高频使用下 JSONL 日志持续累积,需定期导出或清理
- 人格一致性:AI 日记质量高度依赖 persona 调试,初期可能显得机械或重复
- 无云同步:纯本地设计意味着跨设备使用需自行同步
~/.claw-diary/
适合人群
- 需要精确追踪 AI 使用成本与效率的开发者与团队管理者
- 对 AI 行为模式、自我叙事感兴趣的研究者与数字人类学爱好者
- 希望建立与 AI 长期「关系记忆」的深度用户
常规风险
- 本地数据丢失:无云端备份,误删或磁盘故障导致历史不可恢复
- 敏感信息残留:尽管自动脱敏,复杂场景下仍可能漏判,敏感环境建议先用
/diary:clear验证 - Node 依赖:外部脚本依赖 Node 环境,版本冲突可能导致功能异常