usage-visualizer

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":"[Truncated]","env":"[Truncated]"},"install":["[Truncated]"]}}

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