heap

What This Skill Does

The Heap skill for OpenClaw integrates directly with the Heap product analytics platform, empowering your AI agent to act as a data analyst. By providing an interface to both track custom server-side events and query existing analytics data, this skill allows users to bridge the gap between technical implementation and business intelligence. You can monitor user behavior, track key conversions, and extract insights directly through natural language queries without needing to navigate the Heap dashboard manually.

Installation

To install the Heap skill, run the following command in your terminal: clawhub install openclaw/skills/skills/mrgoodb/heap

Once installed, you must configure your environment variables to authenticate with your Heap instance. Add the following to your shell profile: export HEAP_APP_ID="your_app_id_here" export HEAP_API_KEY="your_api_key_here"

Use Cases

This skill is designed for product managers, growth teams, and developers who need real-time visibility into user interactions. Common use cases include:

• Tracking custom business logic events, such as "Trial Started" or "Subscription Cancelled", directly from your backend.
• Updating user segments by adding granular properties like "plan_type" or "account_manager" for better cohort analysis.
• Analyzing conversion funnels by querying event data to identify drop-off points in a user's journey.
• Generating quick reports on active user counts during a product launch.

Example Prompts

1. "Heap, record a 'Product Purchased' event for user user123 with a property of amount set to 50."
2. "Update the user properties for [email protected], setting their plan to 'enterprise'."
3. "Can you query the recent events from Heap and give me a summary of how many users have triggered the 'Signup' event in the last 24 hours?"

Tips & Limitations

• Security: Ensure that your HEAP_API_KEY is kept secure and never committed to version control, as it provides administrative access to your analytics data.
• Rate Limiting: Note that the Heap API has usage limits; avoid flooding queries in rapid succession.
• Data Accuracy: Since this skill interacts with your production Heap environment, verify your identity strings consistently to avoid duplicate user profile creation.
• Documentation: For deep dives into specific API parameters or complex query filters, refer to the official Heap Developers documentation.