C
Cody
Analytics

Connecting OpenClaw with Amplitude: A Practical Guide

·3 min read

Amplitude's Analytics API allows programmatic access to event data, user properties, and cohort information. Connecting it to OpenClaw lets your product team query behavioural data directly from Slack.

How OpenClaw Integrations Work

OpenClaw is a self-hosted AI assistant that runs on your own server — typically an EC2 instance — and connects to Slack. It uses Claude under the hood to process requests. Out of the box, OpenClaw doesn't ship with pre-built connections to third-party tools. Instead, integrations are built using the skills system: markdown files in ~/.openclaw/skills/ that give Claude instructions for a particular domain, combined with HTTP tool calls to any API you expose to it.

In practice, adding a real integration means: getting API credentials from the third-party service, building or configuring a small proxy/endpoint that OpenClaw can call, and writing a skill file that tells Claude how to use it. For some tools this is an afternoon of work. For others — like Amplitude — it's considerably more involved.

Connecting OpenClaw with Amplitude: Step by Step

Step 1: Get Your Amplitude API Key and Secret

Go to Amplitude → Settings → Projects and note your project's API Key and Secret Key. These authenticate requests to the Amplitude Analytics API at https://amplitude.com/api/2/.

Step 2: Use the Events Segmentation Endpoint

The core query endpoint is /api/2/events/segmentation. It accepts event names, date ranges, grouping, and filters. There's also /api/2/funnels for funnel queries and /api/2/retention for retention analysis.

Step 3: Build the Proxy and Skill File

Build your proxy around the event, funnel, and retention endpoints. Write ~/.openclaw/skills/amplitude.md with your key events, user properties, and the types of analyses available. Like Mixpanel, the quality of the skill file depends heavily on documenting your actual event names.

Challenges and Caveats

API Access Depends on Your Amplitude Plan

Amplitude's Analytics API is available on Growth and Enterprise plans. Starter plan users don't have programmatic API access. Check your plan before investing in this integration.

Cohort Queries Are Rate Limited

Cohort-based queries can be computationally expensive and are more aggressively rate limited than simpler event queries. Cache results where possible.


Skip All of This — Use Cody Instead

Cody has Amplitude integration built in. Query user behaviour and retention cohorts from Slack without API keys or proxy services.

Get started with Cody →


Related Guides


Need the model-flexible version? See: How to Connect Amplitude to OpenClaw: Setup, Models, and Workflow Guide.