Cost Monitor

Real-time token usage and cost tracking for OpenClaw agents. Supports MiMo Token Plan (Credits) and DeepSeek pay-as-you-go (RMB). Shows per-turn consumption and remaining balance after every reply.

When to Use

This skill activates automatically on every assistant reply. No user trigger needed.

• After each API response, calculate token consumption and cost
• Append a one-line summary to the reply showing balance and usage
• Support both MiMo (Token Plan Credits) and DeepSeek (RMB) billing models

Quick Start

Install:

bash

clawhub install cost-monitor

Zero configuration. Works out of the box with default settings.

First-time setup (optional):

bash

# Set your MiMo balance (copy from backend: consumed / total)
set-balance mimo 4,250,108,284 / 11,000,000,000

# Set your DeepSeek balance (RMB)
set-balance deepseek 18.00

Display Format

MiMo (Token Plan):

text

MiMo：61.4% | 603.5k · in 333+264.9kcached(99%) · out 202

DeepSeek (Pay-as-you-go):

text

DeepSeek：¥18.00 | ¥0.0045 · in 111+198.0kcached(99%) · out 192

What Each Field Means

Field	Description
61.4% / ¥18.00	Remaining balance (percentage for MiMo, RMB for DeepSeek)
603.5k / ¥0.0045	Cost of this turn (Credits or RMB)
in X+Ycached(Z%)	New input tokens + cached tokens (cache hit rate)
out X	Output tokens generated

Supported Models

Model	Billing	Auto-detected
xiaomi/mimo-v2.5	Token Plan Credits	✅
xiaomi/mimo-v2.5-pro	Token Plan Credits	✅
deepseek/deepseek-v4-flash	RMB (pay-as-you-go)	✅
deepseek/deepseek-v4-pro	RMB (pay-as-you-go)	✅
moonshot/kimi-k2.6	RMB (pay-as-you-go)	✅

Calibration

MiMo: Copy consumed / total from the backend:

text

校准 mimo 4,250,108,284 / 11,000,000,000

DeepSeek: Automatic via API:

text

校准 deepseek

Both automatically deduct the current turn's consumption.

File Structure

text

cost-monitor/
├── SKILL.md              # This file
├── pricing.json          # Official pricing (auto-updated)
├── balance.json          # Balance tracking (auto-updated)
├── scripts/
│   ├── cost.py           # Core calculation engine
│   ├── calibrate.py      # Balance calibration
│   └── set-balance.sh    # Quick balance setter
└── references/
    └── detailed-guide.md # Full documentation

Nighttime Discount

MiMo Token Plan includes a 0.8× coefficient during off-peak hours (Beijing Time 00:00-08:00). This is automatically applied.

Troubleshooting

Balance not updating?

• Ensure balance.json exists in the skill directory
• Run calibration to sync with backend

Wrong model pricing?

• Update pricing.json with official rates from provider websites
• The _source field in pricing.json tracks the data origin

Display not appearing?

• Check that the skill is installed: clawhub list
• Verify AGENTS.md or SOUL.md contains the cost monitoring rule