mirror of
https://github.com/openclaw/openclaw.git
synced 2026-04-29 01:52:04 +00:00
43 lines
2.3 KiB
Markdown
43 lines
2.3 KiB
Markdown
---
|
||
summary: "Usage tracking surfaces and credential requirements"
|
||
read_when:
|
||
- You are wiring provider usage/quota surfaces
|
||
- You need to explain usage tracking behavior or auth requirements
|
||
title: "Usage Tracking"
|
||
---
|
||
|
||
# Usage tracking
|
||
|
||
## What it is
|
||
|
||
- Pulls provider usage/quota directly from their usage endpoints.
|
||
- No estimated costs; only the provider-reported windows.
|
||
- Human-readable status output is normalized to `X% left`, even when an
|
||
upstream API reports consumed quota, remaining quota, or only raw counts.
|
||
|
||
## Where it shows up
|
||
|
||
- `/status` in chats: emoji‑rich status card with session tokens + estimated cost (API key only). Provider usage shows for the **current model provider** when available as a normalized `X% left` window.
|
||
- `/usage off|tokens|full` in chats: per-response usage footer (OAuth shows tokens only).
|
||
- `/usage cost` in chats: local cost summary aggregated from OpenClaw session logs.
|
||
- CLI: `openclaw status --usage` prints a full per-provider breakdown.
|
||
- CLI: `openclaw channels list` prints the same usage snapshot alongside provider config (use `--no-usage` to skip).
|
||
- macOS menu bar: “Usage” section under Context (only if available).
|
||
|
||
## Providers + credentials
|
||
|
||
- **Anthropic (Claude)**: OAuth tokens in auth profiles.
|
||
- **GitHub Copilot**: OAuth tokens in auth profiles.
|
||
- **Gemini CLI**: OAuth tokens in auth profiles.
|
||
- JSON usage falls back to `stats`; `stats.cached` is normalized into
|
||
`cacheRead`.
|
||
- **OpenAI Codex**: OAuth tokens in auth profiles (accountId used when present).
|
||
- **MiniMax**: API key (coding plan key; `MINIMAX_CODE_PLAN_KEY`, `MINIMAX_CODING_API_KEY`, or `MINIMAX_API_KEY`); coding-plan window labels come from provider hours/minutes fields when present, then fall back to the `start_time` / `end_time` span. MiniMax's raw `usage_percent` / `usagePercent` fields mean **remaining** quota, so OpenClaw inverts them before display; count-based fields win when present.
|
||
- If the coding-plan endpoint returns `model_remains`, OpenClaw prefers the
|
||
chat-model entry, derives the window label from timestamps when explicit
|
||
`window_hours` / `window_minutes` fields are absent, and includes the model
|
||
name in the plan label.
|
||
- **z.ai**: API key via env/config/auth store.
|
||
|
||
Usage is hidden if no matching OAuth/API credentials exist.
|