umami-stats

What This Skill Does

The umami-stats skill serves as a robust, read-only data-access layer for your OpenClaw agent, enabling it to programmatically query Umami Cloud (v2) or self-hosted analytics infrastructure. By leveraging this skill, agents can retrieve real-time traffic statistics, page view histories, session data, and specific event performance without needing manual dashboard access. The skill abstracts the complexity of authentication—handling the differences between Umami Cloud's x-umami-api-key header and self-hosted Bearer token requirements—and provides a unified interface for data retrieval. Whether you need to monitor user behavior, conduct marketing experiments, or plan content strategies based on historical performance, this skill provides the raw data necessary for an agent to perform complex analytical reasoning.

Installation

To integrate this skill into your environment, use the OpenClaw package manager: clawhub install openclaw/skills/skills/hfichter/umami-stats

Ensure you have configured your environment variables, specifically setting UMAMI_API_KEY and your preferred UMAMI_WEBSITE_ID. If you are self-hosting, remember to set UMAMI_DEPLOYMENT to self-hosted and provide your custom UMAMI_BASE_URL.

Use Cases

This skill is designed for data-driven workflows. Common applications include automated daily reporting of key performance indicators, alerting on traffic spikes or drops, and performing comparative analysis across different time windows. Agents can use this to identify the most popular landing pages, analyze specific user conversion events like "signup_click" or "purchase," and aggregate session duration metrics. It is particularly useful for growth hackers and content creators who need "always-on" visibility into their site's health.

Example Prompts

1. "How has our website traffic trended over the last 30 days, and what are the top 5 landing pages?"
2. "Can you compare the number of signup button clicks from this week versus last week to see if our recent changes were effective?"
3. "Fetch the latest visitor statistics and summarize any anomalies in traffic patterns for my website."

Tips & Limitations

• Read-Only Constraint: This skill is strictly limited to GET requests; it cannot modify your analytics configuration or delete data.
• Authentication Modes: Ensure your UMAMI_DEPLOYMENT variable matches your setup. Cloud uses /v1/ paths, while self-hosted uses /api/ paths; the script handles mapping, but explicit configuration prevents unexpected 404 errors.
• Time Precision: Always use absolute timestamps (milliseconds) or provided presets (like last7d) to ensure data consistency across queries.
• Data Privacy: Be mindful of sharing exported data if the analytics contain PII or sensitive user patterns.
• API Limits: Large time-range queries on massive datasets may be subject to rate limiting by the Umami instance; prefer smaller, focused queries for routine analysis.