Drip OpenClaw Billing
Instrument OpenClaw agents with Drip for run timelines, tool-call usage metering, and customer-level billing attribution.
Install (copy/paste)
clawhub install drip-openclaw-billing
Use slug only in CLI (drip-openclaw-billing), not owner/slug.
What this gives you
- Per-run billing traceability (
start_run → events → usage → end_run)
- Metered usage by unit (tokens, tool calls, API calls, compute time)
- Customer/project-level cost and usage visibility in Drip
- Idempotent writes for retry-safe telemetry
Integration paths
- Recommended:
DRIP_API_KEY with /v1/* endpoints for full billing + telemetry control.
- Lightweight:
OPENCLAW_IDENTITY_TOKEN with /openclaw/* endpoints.
Security rules
- Use least-privilege runtime keys (prefer scoped telemetry key).
- Never send raw prompts, raw model outputs, credentials, or PII.
- Send sanitized metadata only (hash content fields like
queryHash when needed).
- Emit stable idempotency keys for all writes.
- Validate payload schemas in staging before production rollout.
Quickstart (Node.js)
import { OpenClawBilling } from '@drip-sdk/node/openclaw';
const billing = new OpenClawBilling({
apiKey: process.env.DRIP_API_KEY,
customerId: 'cus_123',
workflowId: process.env.DRIP_WORKFLOW_ID ?? 'wf_openclaw',
});
await billing.withRun({ externalRunId: 'openclaw_req_456' }, async ({ runId }) => {
await billing.withToolCall({ runId, provider: 'brave', endpoint: '/res/v1/web/search' }, async () => {
// tool execution
});
});
Quickstart (Python)
from drip import Drip
import os
client = Drip(api_key=os.environ['DRIP_API_KEY'])
run = client.start_run(customer_id='cus_123', workflow_id='wf_openclaw', external_run_id='openclaw_req_456')
client.emit_event(run_id=run.id, event_type='tool.call', quantity=1, metadata={'provider': 'brave'})
client.track_usage(customer_id='cus_123', meter='brave_api_calls', quantity=1, metadata={'runId': run.id})
client.end_run(run.id, status='COMPLETED')
Load detailed API docs
See references/API.md for:
- endpoint shapes
- run/event/usage lifecycle
- pricing units and rate-limit notes
- error handling patterns