DeepClaw OpenClaw Plugin

DeepClaw for OpenClaw streams LLM usage telemetry from OpenClaw into DeepClaw: model, provider, input/output tokens, cache reads/writes, reasoning tokens, and calculated cost breakdowns.

It is built for teams that run multi-provider AI agents and need to know, in near real time, where LLM spend is going.

Highlights

• Real-time telemetry from OpenClaw llm_output hooks.
• Per-session batching with periodic flush and final session_end flush.
• Token-level breakdowns: input, output, cache read, cache write, reasoning/thinking tokens.
• Cost attribution using a maintained pricing table with explicit costSource metadata.
• Provider-aware pricing for Gemini, OpenAI, Anthropic, DeepSeek, and xAI models.
• Safe by default: disabled until configured with an explicit sync token.
• Small package surface: only runtime files, plugin manifest, README, license, changelog, and security policy are published.

Why this plugin exists

Agent cost tracking often breaks around preview models, cache tokens, reasoning tokens, or provider-specific usage fields. The result is usually either $0 cost, inflated estimates, or numbers that cannot be audited later.

This plugin captures the raw usage shape exposed by OpenClaw, normalizes the important fields, calculates a structured cost breakdown, and sends it to DeepClaw for long-term analysis.

Installation

From the public npm registry:

npm install deepclaw-openclaw

From GitHub Packages, once the scoped mirror package has been published:

# .npmrc
@digitizers:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}

npm install @digitizers/deepclaw-openclaw

The GitHub Packages build is published as the scoped alias @digitizers/deepclaw-openclaw; the canonical npmjs package remains deepclaw-openclaw for easier public installation.

For local development or manual installation:

git clone https://github.com/Digitizers/deepclaw-openclaw.git
cd deepclaw-openclaw
npm install
npm run ci

Configuration

Configure the plugin in your OpenClaw agent config:

plugins:
  deepclaw-openclaw:
    enabled: true
    syncToken: "YOUR_DEEPCLAW_SYNC_TOKEN"
    instanceId: "prod-agent-01"
    apiUrl: "https://app.deep-claw.com"
    flushIntervalMs: 5000
    debug: false

Environment variables are also supported:

Data flow

Payloads are sent to:

POST /api/sync/session
Authorization: Bearer <syncToken>

Cost source semantics

Each LLM record includes costSource:

Note: usage counters come from OpenClaw/provider response metadata. Dollar cost is calculated locally by this plugin unless OpenClaw adds a trusted provider-cost field in a future hook shape.

Development

npm install
npm run typecheck
npm test
npm pack --dry-run

Useful scripts:

Published package contents

The package is intentionally narrow:

• index.ts
• src/config.ts
• src/pricing.ts
• src/service.ts
• openclaw.plugin.json
• README.md
• LICENSE
• SECURITY.md
• CHANGELOG.md
• SKILL.md

Security

Do not commit sync tokens or OpenClaw runtime state. See SECURITY.md for reporting and handling guidance.

Status

0.1.2 is an initial public release candidate. APIs may still evolve with OpenClaw plugin hook changes.

License

MIT © Ben Kalsky / Digitizer.