核心用法
Usage Visualizer 是 OpenClaw 生态中的高级分析引擎，专为将原始会话日志转化为专业级可视化报告而设计。用户通过命令行调用 Python 脚本，支持两种输出模式：
- 图像模式 (`--mode image`)：生成高保真 PNG 可视化报告，支持
today或week周期，可选--json输出结构化数据 - 文本模式 (`--mode text`)：生成纯文本摘要，适合快速浏览或进一步处理
关键执行流程为先同步日志，再生成报告图像。对于 AI Agent 有强制交付协议：必须从 JSON 中提取 image_path，使用 message 工具的 filePath 参数作为附件发送，严禁直接发送本地路径字符串；发送前须验证文件存在且为有效 PNG。
显著优点
- 100% 本地处理：零网络依赖，所有数据处理在本地完成，彻底杜绝数据外泄风险
- 审计验证的隐私保护：明确声明不存储任何凭证，隐私架构经过独立审计
- 高保真可视化输出：生成专业级图表，优于原始日志的纯文本呈现
- 灵活的周期覆盖：支持单日/单周视图，满足不同时间维度的分析需求
- 双模式输出：兼顾视觉呈现与机器可读的文本摘要
潜在缺点与局限性
- 系统依赖较重：需要 Python3 和 Chromium 浏览器环境，对轻量系统不够友好
- 环境变量强制依赖：必须配置
OPENCLAW_WORKSPACE，配置门槛存在 - OpenClaw 生态绑定：非通用工具，专用于 OpenClaw 日志格式，迁移成本高
- 无实时流处理能力：基于周期批处理，非实时仪表盘
- 输出格式单一：图像仅支持 PNG，无 PDF/SVG 等矢量格式选项
适合人群
- OpenClaw 重度用户，需要定期回顾使用模式
- 隐私敏感型用户，拒绝云端分析服务
- 需要向团队或管理层展示使用数据的管理员
- 开发运维人员，需审计会话历史与资源消耗
常规风险
- 路径泄露风险：Agent 若未遵守强制交付协议，可能将本地文件路径暴露给用户或日志
- Chromium 依赖风险：若系统 Chromium 版本过旧或损坏，渲染可能失败
- 日志完整性依赖：输出质量完全取决于 OpenClaw 日志的完整性与准确性
- 本地存储敏感：生成的可视化报告含使用数据，需确保本地文件系统安全
- 无加密声明：报告生成后本地存储，未声明是否加密