name: api-cost-optimizer description: "Analyze OpenClaw agent configuration and API usage patterns to identify cost-saving opportunities. Diagnose inefficient heartbeat configs, estimate daily/weekly API spend, and generate actionable recommendations to reduce LLM API costs. Essential for any agent operator running 24/7 on a budget. Use when: agent costs are higher than expected, heartbeat config needs review, or monthly API bill surprises you." metadata: { "openclaw": { "requires": { "bins": ["curl", "python3"] }, "install": [], }, }
Diagnose, estimate, and optimize LLM API costs for OpenClaw agents running 24/7.
Documented cases show agents burning $8–$250 per week in API costs due to misconfigured heartbeats and inefficient task patterns. A properly tuned heartbeat alone can reduce costs by 60–90%.
| Variable | Required | Default | Description |
|---|---|---|---|
API_COST_MODEL |
No | openai |
Provider: openai, anthropic, minimax, lmstudio |
API_COST_INTERVAL |
No | weekly |
Report interval: daily, weekly, monthly |
HEARTBEAT_INTERVAL |
No | auto |
Override heartbeat interval in seconds (auto-detect if not set) |
MODEL_PRICE_INPUT |
No | auto | Price per 1M input tokens (auto-selected by provider) |
MODEL_PRICE_OUTPUT |
No | auto | Price per 1M output tokens (auto-selected by provider) |
| Provider | Model | Input | Output |
|---|---|---|---|
| OpenAI | GPT-4o | $2.50 | $10.00 |
| OpenAI | GPT-4o-mini | $0.15 | $0.60 |
| OpenAI | GPT-4-turbo | $10.00 | $30.00 |
| Anthropic | Claude 3.5 Sonnet | $3.00 | $15.00 |
| Anthropic | Claude 3 Opus | $15.00 | $75.00 |
| MiniMax | MiniMax-M2 | $0.10 | $0.10 |
| MiniMax | MiniMax-M2.1 | $0.20 | $0.40 |
Runs a complete cost diagnostic on the current OpenClaw configuration.
./scripts/analyze.sh
Output: Detailed markdown report with: - Estimated API spend (daily / weekly / monthly) - Heartbeat cost analysis - Tool count risk factor - Top 3 cost reduction recommendations - Estimated savings after optimization
Checks OpenClaw heartbeat configuration and calculates wasted API calls.
./scripts/heartbeat_diagnosis.sh
Output: Heartbeat efficiency score (0–100%), wasted calls per day, estimated annual waste.
One-shot estimate with optional custom parameters.
./scripts/estimate.sh <heartbeat_seconds> <tasks_per_day> <avg_input_tokens> <avg_output_tokens>
Output: Daily, weekly, and monthly cost estimates for the given parameters.
Priority order:
# Full analysis with MiniMax pricing
export API_COST_MODEL=minimax
./scripts/analyze.sh
# Quick estimate
./scripts/estimate.sh 300 20 8000 2000
# Heartbeat-only diagnosis
./scripts/heartbeat_diagnosis.sh
这个 Skill 质量中上,功能实用且文档清晰,能自动检测配置并给出优化建议。主要问题是代码存在 bug(第 147 行变量名错误会导致计算出错),以及缺少测试覆盖。文档和功能设计做得不错,但实现细节需要打磨,适合作为生产工具使用前先自行检查脚本逻辑。