ai-usage

What This Skill Does

The ai-usage skill serves as a comprehensive monitoring dashboard for your AI consumption within the OpenClaw ecosystem. It provides real-time visibility into your interaction patterns, token usage, and associated costs across various AI providers. By bridging the gap between your local OpenClaw session logs and the official Anthropic OAuth quota API, this tool ensures you never hit unexpected rate limits or budget caps. It automatically detects and parses logs from multiple providers like Anthropic, OpenAI, and Ollama, offering both a human-readable CLI summary and a machine-readable JSON output for automated tracking systems.

Installation

To integrate this tool into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/bshandley/ai-usage

This script is lightweight and requires no external pip dependencies, running natively on Python 3.10+ environments. It utilizes existing authentication from your Claude Code installation to query quota data securely.

Use Cases

This skill is designed for power users, developers, and team leads who need granular control over their AI spend. Use it to:

• Monitor weekly utilization percentages for Anthropic models including Sonnet and Opus.
• Track rolling 5-hour usage windows to avoid rate-limit throttling.
• Audit total token consumption across different local and cloud-based AI providers.
• Generate cost reports for project-based accounting using the built-in parsing engine for session logs.
• Set up automated heartbeat checks to receive alerts before your monthly spend or API quota is reached.

Example Prompts

1. "What is my current AI usage across all models today?"
2. "How much of my Anthropic weekly quota have I burned through so far?"
3. "Show me the token breakdown for my recent sessions and tell me if I'm trending over budget."

Tips & Limitations

• Use the --json flag when piping output into monitoring tools or custom dashboards to ensure clean data parsing.
• If you are running automated checks, use a smaller, faster model like Haiku to minimize the overhead cost of the check itself.
• The tool requires claude CLI access to read quota details; if your credentials are expired, the tool will attempt an automatic refresh, but ensure your ~/.claude/.credentials.json file is properly configured.
• Note that while local OpenClaw logs are parsed immediately, real-time external API quota information is subject to the responsiveness of the Anthropic authentication server.