Go back
More in category View on ClawHub

Jump to related tools in the same category or review the original source on GitHub.

Coding Agents & IDEs @bshandley Updated 6/28/2026 1,205 downloads 0 stars Security: Pass

Ai Usage OpenClaw Plugin & Skill | ClawHub

Looking to integrate Ai Usage into your AI workflows? This free OpenClaw plugin from ClawHub helps you automate coding agents & ides tasks instantly, without having to write custom tools from scratch.

What this skill does

Check AI usage across Anthropic and other providers. Use when: 1. User asks about AI usage, token usage, or quota 2. User says "what's my AI usage" or "how much have I used" 3. User asks about Anthropic/Claude usage or limits 4. User asks about costs or spending on AI 5. Monitoring usage during heartbeats (daily check)

Install

ClawHub CLI 
openclaw skills install @bshandley/ai-usage
Node.js (npx) 
npx clawhub@latest install ai-usage

Full SKILL.md

Open original
Metadata table.
namedescription
ai-usageCheck AI usage across Anthropic and other providers. Use when: 1. User asks about AI usage, token usage, or quota 2. User says "what's my AI usage" or "how much have I used" 3. User asks about Anthropic/Claude usage or limits 4. User asks about costs or spending on AI 5. Monitoring usage during heartbeats (daily check)

SKILL.md content below is scrollable.

AI Usage Check

Quick Start

python3 scripts/usage_check.py           # Pretty report with gauges
python3 scripts/usage_check.py --json    # JSON output for scripting

Requirements

  • Python 3.10+ (no pip dependencies — stdlib only)
  • Claude Code installed and authenticated (claude CLI in PATH) — for Anthropic quota
  • OpenClaw installed — for session log token/cost stats

What It Shows

Anthropic (real quota from OAuth API):

  • Weekly utilization % with reset countdown
  • 5-hour rolling window %
  • Model-specific weekly (Sonnet, Opus) when available
  • Extra usage spend vs monthly limit

Other Providers (from OpenClaw session logs):

  • Token counts and call counts per model
  • Auto-detects any provider OpenClaw routes through (Ollama, OpenAI, etc.)

OpenClaw Anthropic breakdown:

  • Per-model token counts and equivalent API cost

How It Works

  • Anthropic quota: GET https://api.anthropic.com/api/oauth/usage using Claude Code's OAuth token from ~/.claude/.credentials.json (requires user:profile scope)
  • Token auto-refresh: If the token is expired, the script automatically refreshes it by invoking claude --print -p "ok" (Claude Code refreshes its own OAuth token on any invocation), then re-reads the updated credentials file. If Claude Code isn't installed, Anthropic quota is skipped gracefully.
  • Session stats: Parses ~/.openclaw/agents/main/sessions/*.jsonl for per-provider/model token and cost data

Environment Variables

Variable Default Description
OPENCLAW_SESSIONS_DIR ~/.openclaw/agents/main/sessions OpenClaw session log directory
CLAUDE_CREDENTIALS_PATH ~/.claude/.credentials.json Claude Code credentials file

Tips

  • Run via Haiku or a lightweight model for heartbeat/background checks — the script just needs to execute, no reasoning required
  • Use --json for programmatic consumption (cron jobs, dashboards, alerts)
  • Works with any Anthropic subscription tier (Pro, Max, Team, etc.)
ClawHub Registry URL: https://clawhub.ai/bshandley/skills/ai-usage

Related skills

If this matches your use case, these are close alternatives in the same category.

0g-compute

Use cheap, TEE-verified AI models from the 0G Compute Network as OpenClaw providers.

0protocol

Agents can sign plugins, rotate credentials without losing identity, and publicly attest to behavior.

2nd-brain

Personal knowledge base for capturing and retrieving information about people, places, restaurants, games, tech.

2slides-skills

AI-powered presentation generation using 2slides API.

3d-cog

Other tools need perfect images.

3d-model-generation

Generate 3D models using each::sense AI.