drip-openclaw-billing
# Drip OpenClaw Billing
Instrument OpenClaw agents with Drip for **run timelines**, **tool-call usage metering**, and **customer-level billing attribution**.
## Install (copy/paste)
```bash
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
1. **Recommended**: `DRIP_API_KEY` with `/v1/*` endpoints for full billing + telemetry control.
2. **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)
```ts
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)
```py
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
标签
skill
ai
