360 Secure SkillHub
360 安全技能中心

Usage Visualizer

该 Skill 通过 Python 脚本读取 OpenClaw 工作区会话日志,汇总使用统计并生成高保真图片报表和文本摘要,支持 today、week 等周期与 JSON 输出,结果可做为图片附件交付,处理过程在本地完成。

vintlin
vintlin
热度 95.12
最近更新 2026-05-17 12:12:13
分类:数据依赖:代码执行 / 读写文件应用场景:报告撰写 / 数据处理 / 摘要总结

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add usage-visualizer
Metadata
name
usage-visualizer
description
Advanced usage statistics and high-fidelity visual reporting for OpenClaw. 100% local processing. Audit-verified privacy (No credentials stored).
metadata
{"openclaw":{"emoji":"📊","os":["darwin","linux"],"requires":{"bins":["python3","chromium"],"env":["OPENCLAW_WORKSPACE"]},"install":[{"id":"pip-deps","kind":"exec","command":"pip3 install -r requirements.txt","label":"Install Python dependencies"}]}}

Usage Visualizer

Usage Visualizer is a high-fidelity analytics engine for OpenClaw that transforms raw session logs into professional, actionable visual reports.

🚀 Quick Start

# Generate today's visual report
python3 scripts/run_usage_report.py --mode image --period today

📈 Usage Guide

Visual Reports

The visualizer syncs logs first, then generates the report image.

  • python3 scripts/run_usage_report.py --mode image --period today
  • python3 scripts/run_usage_report.py --mode image --period week --json

Text Summaries

  • python3 scripts/run_usage_report.py --mode text --period today --json

🛡 Delivery Protocol (MANDATORY FOR AGENTS)

  1. Image Delivery: Extract image_path from JSON and send as attachment using message tool's filePath. NEVER send the local path as a string.
  2. Verification: Verify the file exists and is a valid PNG before sending.
  3. No Network: This skill is 100% local. It has zero network dependencies.

📄 License

MIT