agent-cost-monitor

What This Skill Does

The Agent Cost Monitor is a critical utility designed for OpenClaw users who need granular visibility into their AI infrastructure. By aggregating data from session logs and token usage metrics, this skill provides a real-time, high-fidelity view of your operational expenditures. It transforms raw usage data into actionable business intelligence by calculating per-agent costs, projecting weekly consumption, and comparing these figures against your predefined budget thresholds. When triggered—either manually via user inquiry or automatically via a scheduled cron job—the skill audits the session_status for all active agents. It flags anomalies such as runaway processes that consume tokens at an unsustainable rate and offers specific, model-aware optimization suggestions, such as recommending a downgrade to a more cost-effective model for specific tasks or adjusting heartbeat frequencies.

Installation

To integrate the Agent Cost Monitor into your OpenClaw environment, execute the following command in your terminal or via the internal CLI:

clawhub install openclaw/skills/skills/bloodandeath/keats-agent-cost-monitor

Ensure that you have sufficient permissions to access the session status logs and that your agent has the required connectivity to query the underlying usage statistics.

Use Cases

This skill is indispensable for power users maintaining fleets of agents. Use it for your weekly cost-hygiene reviews to identify budget leaks, investigate sudden spikes in token consumption when an agent behaves erratically, or automate your financial oversight by scheduling daily reports to be delivered to your dashboard. It is particularly effective for teams running multiple agents on different models (e.g., mixing Opus, Sonnet, and Haiku) where understanding the ROI of each model tier is essential.

Example Prompts

1. "Could you generate a detailed cost report for all agents for the last 24 hours?"
2. "I'm worried about our spending. Which of my current agents is consuming the most tokens?"
3. "Run a budget check; am I likely to exceed my weekly $50 limit at our current usage rate?"

Tips & Limitations

To get the most out of this tool, integrate it into your automated reporting cycle using the provided JSON cron template. Keep in mind that this skill provides estimations based on current provider rates; it is not a direct billing interface. Always check your actual provider dashboard for definitive billing information and invoice management. Avoid using this skill for debugging session crashes, as its primary focus is financial performance, not code execution error recovery.