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 todaypython3 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)
- Image Delivery: Extract
image_pathfrom JSON and send as attachment usingmessagetool'sfilePath. NEVER send the local path as a string. - Verification: Verify the file exists and is a valid PNG before sending.
- No Network: This skill is 100% local. It has zero network dependencies.
📄 License
MIT