A professional workflow for deploying and optimizing Umami, the privacy-focused alternative to traditional web analytics.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install umami
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install umami using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Umami Analytics Skill?
The Umami skill empowers developers to implement a robust, self-hosted analytics solution that prioritizes user privacy. By utilizing Openclaw Skills for your deployment, you gain access to critical configuration patterns, such as managing the permanent HASH_SALT and selecting the correct database backends like PostgreSQL or MySQL. This skill ensures that your tracking remains uninterrupted and invisible to common ad-blockers by leveraging same-domain hosting strategies.
Beyond basic installation, it covers complex integration scenarios for modern web frameworks. Whether you are managing a single blog or a multi-tenant application environment, this guide provides the technical foundation to scale your analytics without compromising performance or data integrity.
Umami Analytics Skill Use Cases
- Migrating from Google Analytics to a privacy-compliant, cookie-less solution.
- Tracking user behavior in Single Page Applications (SPAs) like React, Next.js, and Vue.
- Avoiding tracking script blockages by self-hosting on a primary domain.
- Centralizing analytics for multiple websites within a single, secure instance.
How Umami Analytics Skill Works
- Provision a PostgreSQL or MySQL database, as SQLite is not supported for production-grade tracking.
- Configure environment variables, ensuring the HASH_SALT is set to a value that will never change to prevent data invalidation.
- Deploy the Umami application via Node.js and point it to your database.
- Register your website within the Umami dashboard to obtain a unique data-website-id.
- Embed the tracking script in the of your application and verify the connection via the browser network tab.
Umami Analytics Skill Setup
To begin using this skill from the Openclaw Skills collection, follow these installation steps:
# Configure your database connection string
DATABASE_URL=postgresql://username:password@localhost:5432/databasename
# Set a permanent HASH_SALT (crucial for data integrity)
HASH_SALT=any-random-string
# Install dependencies and build the project
npm install
npm run build
# Launch the Umami instance
npm start
Note: For production, ensure a reverse proxy is configured to handle HTTPS traffic on port 3000.
Umami Analytics Skill Data Schema & Taxonomy
| Key | Description |
|---|---|
| Database Backend | Requires PostgreSQL or MySQL; holds all users and tracking data. |
| HASH_SALT | Critical identifier; changing this resets all existing analytics data. |
| Website ID | Unique identifier per site to route tracking data correctly. |
| Session Data | Minimal, privacy-focused data stored without personal identifiers. |
| API Access | Properties for custom events are searchable through the Umami API. |
Umami Analytics Skill Advanced Features
- Multi-site management allows a single instance to track hundreds of independent domains.
- Custom event tracking using the umami.track() function for granular user action analysis.
- Automated integration with Next.js App and Pages routers via dedicated packages.
- Public dashboard sharing for transparent reporting without requiring user accounts.
SKILL.md
Loading
Related Openclaw Skills
Ukrainian Natural Language Skill
A specialized skill designed to shift AI output from stiff, robotic Ukrainian to warm, authentic, and human-sounding communication.
UI
Design clear, consistent, and visually polished user interfaces using industry-standard principles.
UGC Content Engine
A strategic framework for producing viral user-generated content that focuses on authentic hooks and high-conversion creator briefs.
Udio
An advanced automation skill for generating, extending, and managing AI-powered music tracks via the Udio platform.
Uniswap
A technical guide and automation assistant for executing secure swaps and managing concentrated liquidity positions on Uniswap.
United States
A professional AI travel assistant for navigating US entry rules, regional routing, and practical tourist logistics.
Featured*
