ga4

What This Skill Does

The GA4 skill is a powerful integration for OpenClaw that allows users to programmatically interact with their Google Analytics 4 properties. By leveraging the official Google Analytics Data API, this skill acts as a bridge between your agent and your live web traffic statistics. It enables users to fetch granular data such as pageviews, user sessions, acquisition sources, and conversion events without ever leaving the OpenClaw interface. It supports complex queries involving multi-metric selection, dimension breakdowns, custom date ranges, and regex-based filtering, making it an essential tool for performance marketing, SEO audits, and product growth analysis.

Installation

To integrate this skill, follow these steps:

1. Execute the installation command: clawhub install openclaw/skills/skills/bobdevibecoder/bobagent-ga4.
2. Ensure your Google Cloud Project has the Analytics Data API enabled.
3. Configure your environment variables in your OpenClaw setup:
   • GA4_PROPERTY_ID: The unique identifier for your GA4 property.
   • GOOGLE_CLIENT_ID & GOOGLE_CLIENT_SECRET: Your OAuth credentials.
   • GOOGLE_REFRESH_TOKEN: An authorized refresh token to maintain persistent access.

Use Cases

This skill is ideal for teams needing automated reporting or deep-dive analysis. Typical use cases include:

• Automated Weekly Reports: Automatically generating summaries of top-performing blog posts or landing pages.
• Traffic Source Audits: Identifying which channels (Social, Organic, Referral) are driving the highest session counts.
• Technical SEO Monitoring: Filtering by specific URL patterns to monitor page performance for sub-directories.
• Conversion Tracking: Monitoring goal completions against active user counts to determine funnel health.

Example Prompts

1. "Check the performance of my top 10 landing pages from the last 30 days and list their total session counts."
2. "What are the primary traffic sources for the /blog/ directory? Please output the results in JSON format."
3. "Show me the bounce rate and total active users broken down by city for the month of January 2026."

Tips & Limitations

• Rate Limits: Be mindful of Google's quota limits for the Data API; excessively frequent requests may result in temporary blocks.
• Authentication: Keep your refresh token secure; do not commit it to public version control repositories.
• Filtering: Use the --filter flag with caution; ensure your regex syntax aligns with the dimensions provided by the Google Analytics Data API schema.
• Data Latency: Remember that GA4 data often has a 24-48 hour processing delay; real-time performance is not supported.