Package Exports

@hzhipeng/plugin-billing-attribution
@hzhipeng/plugin-billing-attribution/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@hzhipeng/plugin-billing-attribution) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Billing Attribution Plugin

This OpenClaw plugin reports runtime attribution events to relay so billing logs can be reconciled with agent, message, session, and tool context.

It is observation-only:

It does not modify OpenClaw source code.
It does not rewrite prompts, tool calls, or model responses.
It does not calculate or settle tokens.
It does not upload full prompts, image data, files, secrets, or full search queries.

Configuration

{
  "enabled": true,
  "endpoint": "http://openclaw-gateway:8080/v1/api/attribution/events",
  "token": "sk-...",
  "sampleLog": false,
  "timeoutMs": 1500
}

Environment fallbacks are also supported:

BILLING_ATTRIBUTION_ENABLED
BILLING_ATTRIBUTION_ENDPOINT
BILLING_ATTRIBUTION_TOKEN
BILLING_ATTRIBUTION_SAMPLE_LOG
BILLING_ATTRIBUTION_TIMEOUT_MS

The endpoint is protected by the normal relay bearer token middleware. Use a relay token dedicated to attribution ingestion when possible.

Events

The first version listens to:

before_tool_call
message:preprocessed
message_preprocessed

For tool calls, the plugin sends tool_name, tool_call_id, agent, conversation, session, run, message, query_hash, and a short query_preview.

Relay remains the source of truth for usage, quota, and wallet settlement. These events are only evidence used to connect relay usage logs to OpenClaw runtime context when there is exactly one safe match.