Umami

What This Skill Does

The Umami skill allows the OpenClaw AI agent to manage, configure, and troubleshoot self-hosted Umami analytics deployments. Umami is a powerful, privacy-focused alternative to Google Analytics, and this skill streamlines the complexity of keeping your data accurate. The agent can help verify your tracking script implementation, troubleshoot common data loss scenarios, assist in configuring PostgreSQL or MySQL databases, and optimize your setup for Single Page Application (SPA) tracking. By automating the validation of tracking IDs and verifying correct script placement, the agent ensures that your analytics dashboard reflects your actual site traffic without the common pitfalls of integration errors or ad-blocker interference.

Installation

To integrate this skill into your environment, run the following command in your terminal: clawhub install openclaw/skills/skills/ivangdavila/umami

Use Cases

• Automating the setup and validation of Umami tracking scripts across multiple environments (Dev/Staging/Prod).
• Ensuring SPA route changes are tracked correctly in React, Vue, or Next.js projects.
• Configuring high-performance database backups for your analytical data.
• Troubleshooting 'zero data' issues by auditing script configuration, CORS headers, and network requests.
• Providing guidance on reverse proxy setup (Nginx/Caddy) for secure HTTPS deployments.

Example Prompts

1. "Umami is showing zero pageviews even though the script is present. Check my site configuration and tell me what I missed."
2. "I am moving my React application to use the App Router. How should I update my umami.track calls for proper event recording?"
3. "Help me set up a cron job script for backing up my Umami PostgreSQL database to ensure I don't lose my site metrics."

Tips & Limitations

• Critical Warning: Never change the HASH_SALT once set; it acts as the master key for your existing data and will cause a total data reset if altered.
• Database Choice: Umami strictly requires PostgreSQL or MySQL; SQLite is unsupported for production.
• Ad-Blockers: For maximum data accuracy, self-host the tracking script on the same domain as your website.
• Performance: While the Umami instance is lightweight, ensure your PostgreSQL database has sufficient resources, as it is the primary bottleneck for query performance.
• Data Integrity: Always maintain a separate backup strategy for your database; it contains your entire state, including configurations, users, and all historical tracking data.