Matomo Analytics

What This Skill Does

The Matomo Analytics skill for OpenClaw empowers users to interact with their self-hosted or cloud-hosted Matomo instances directly through natural language. By abstracting complex API calls, this skill allows the agent to fetch key performance indicators (KPIs), generate visual report summaries, track goal conversions, and segment visitor data seamlessly. It supports full management of analytics data, ensuring that site owners can perform deep-dive analysis into traffic sources, user engagement, and goal success without writing manual code. The skill is architected for modularity, using localized memory structures to save report templates and site configurations while maintaining strict security boundaries.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/ivangdavila/matomo Upon installation, consult the setup.md file within the skill directory to configure your environment variables and access credentials. Ensure the ~/matomo/ directory is initialized correctly to enable persistent caching and template storage.

Use Cases

• Executive Reporting: Automatically generate weekly performance summaries comparing current traffic against historical data.
• Conversion Optimization: Track specific user goals (such as form submissions or purchases) and filter by specific visitor segments like "returning users" or "mobile traffic."
• Traffic Source Analysis: Quickly identify which external websites or search engines are driving the most high-intent traffic to your properties.
• Trend Detection: Monitor significant shifts in visitor patterns (>10% changes) to identify potential marketing wins or technical issues.

Example Prompts

• "Compare the conversion rate for mobile users versus desktop users on my main site over the last 30 days."
• "What were the top 5 landing pages for visitors coming from social media sources yesterday?"
• "Generate a summary report for the current month, highlighting any significant changes in total pageviews compared to the previous month."

Tips & Limitations

To ensure optimal performance, always batch your queries where possible to avoid hitting rate limits on your Matomo instance. Utilize the internal cache for follow-up questions to minimize unnecessary network traffic. For privacy and security, never expose your token_auth in conversation; always use local references. Remember that the skill requires proper configuration of the ~/matomo/memory.md file to map site IDs to friendly names for ease of use. If you are dealing with large datasets, rely on the segment parameter to filter results early at the API level rather than processing large payloads within the agent.