A Stripe-native usage metering system that ensures precise totals for consumption-based billing models.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install stripemeter
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 stripemeter 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 StripeMeter?
StripeMeter is a high-performance, developer-centric tool designed to bridge the gap between application usage and Stripe billing. By utilizing an immutable ledger for events and pre-computed aggregations, it provides a robust solution for tracking API calls, seats, or any metered metric without the risk of double-counting or data loss. As a core part of the Openclaw Skills ecosystem, it simplifies complex billing workflows like handling late events and managing billing drift through a sophisticated watermark system.
StripeMeter Use Cases
- Implementing consumption-based pricing for SaaS platforms.
- Tracking API call volumes or seat-based usage in real-time.
- Synchronizing usage deltas to Stripe while handling network retries.
- Simulating invoice costs based on tiered pricing models before billing.
How StripeMeter Works
- Ingest usage events through the REST API or SDKs with unique idempotency keys to prevent double counting.
- Events are recorded in an immutable ledger to ensure data integrity and auditability.
- Real-time counters aggregate metrics such as sum, max, or last-value based on the tenant and customer.
- Watermarks manage late-arriving data by triggering re-aggregation within a 48-hour window.
- The system calculates usage deltas and pushes only the necessary updates to Stripe subscription items.
StripeMeter Setup
To begin using this skill from the Openclaw Skills collection, follow these installation steps:
git clone https://github.com/geminimir/stripemeter && cd stripemeter
cp .env.example .env && docker compose up -d && pnpm -r build
pnpm db:migrate && pnpm dev
Ensure your STRIPE_SECRET_KEY and database credentials are configured in the .env file.
StripeMeter Data Schema & Taxonomy
The system organizes data into several logical layers for maximum reliability:
| Component | Description |
|---|---|
| Events | Immutable ledger storing tenantId, metric, customerRef, quantity, and timestamps. |
| Counters | Materialized aggregations (sum/max/last) updated in near-real-time. |
| Watermarks | Temporal markers used to handle late-event re-aggregation windows. |
| Delta Push | Metadata tracking the difference between locally metered usage and what has been pushed to Stripe. |
StripeMeter Advanced Features
- Shadow Mode: Safely test Stripe billing logic without impacting live customer invoices.
- Pricing Simulator: Advanced calculator for simulating costs against tiered or volume-based pricing models.
- Reconciliation Engine: Built-in drift detection to identify discrepancies between local totals and Stripe data.
- SDK Support: Native Node.js and Python clients for seamless integration into existing application stacks.
SKILL.md
Loading
Related Openclaw Skills
PwnClaw Security Scan
A comprehensive security testing suite designed to harden AI agents against prompt injection, jailbreaks, and advanced adversarial attacks.
gekko-yield
An automated DeFi management tool for earning sustainable yield on USDC through the Moonwell Flagship vault on the Base network.
Gekko Portfolio Manager
An AI-driven DeFi portfolio manager for the Base network that optimizes yield across top protocols like Morpho and Yearn.
Gekko Strategist
An AI-powered DeFi strategy agent designed to build, backtest, and adapt yield farming strategies on the Base network.
agkan
agkan is an SQLite-powered CLI task management tool designed for seamless collaboration between human developers and AI agents.
CopilotKit Agent Patterns
A comprehensive framework for architecting and implementing AI agents that integrate seamlessly with the CopilotKit runtime and AG-UI protocol.
Featured*
