api-credits-lite

# API Credits Lite

Use this skill when the user asks about API credits, balances, spending, or wants to update their credit info for Anthropic, OpenAI, OpenRouter, Mistral, or Groq.

## When to Use

✅ **USE this skill when the user asks:**

- "How much credit do I have left?" / "What's my balance?"
- "Show my API credits" / "Check my credits"
- "Update my [provider] balance to $X"
- "I topped up [provider] by $X"
- "Am I running low on [provider]?"

❌ **DON'T use when:**
- The user needs 16+ providers, JSONL auto-tracking, cloud SDKs, or heartbeat integration → use **api-credits-pro**

## How to Use

You run the scripts internally — the user never types `python3`. Respond naturally and present health bar output conversationally.

The skill root is at: `~/.openclaw/workspace/skills/api-credits-lite/`
Run scripts with: `python3 <skill-root>/scripts/<script>.py <args>`

---

## Show Credit Balances

**Triggers:** "show my credits", "how much do I have left", "check my API balance"

```bash
python3 scripts/show_credits.py
```

Displays retro health bars for all configured providers. Colors: 🟩 >75% · 🟨 50–75% · 🟧 25–50% · 🟥 <25%

---

## Manual Balance Sync

**Triggers:** "set my Anthropic balance to $X", "update my OpenAI credits to $X", "I have $X left on [provider]"

```bash
python3 scripts/sync_provider.py <provider> <balance>
# With max:  python3 scripts/sync_provider.py <provider> <balance> <max_credits>

# Examples:
python3 scripts/sync_provider.py anthropic 22.97
python3 scripts/sync_provider.py openai 95.00 100.00
```

Supported providers: `anthropic`, `openai`, `openrouter`, `mistral`, `groq`

Where to find balances:
- **Anthropic** → console.anthropic.com
- **OpenAI** → platform.openai.com/usage
- **OpenRouter** → openrouter.ai/activity
- **Mistral** → console.mistral.ai/billing
- **Groq** → console.groq.com/settings/billing

---

## Auto-Check Balance via API

**Triggers:** "check my OpenAI balance automatically", "pull my OpenRouter credits"

For prov...

# API Credits Lite

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

An **OpenClaw agent skill** — track and display API credit balances across 5 core providers with retro video game health bars. Just ask your agent to check your credits.

## What It Does

- 🎮 **Visual health bars** — at-a-glance credit status for all your providers
- 📊 **5 providers** — Anthropic, OpenAI, OpenRouter, Mistral, Groq
- 🔄 **API auto-check** — automated balance pulls for OpenAI, OpenRouter, Vercel
- 📋 **Manual sync** — update balances from any provider console
- ⚠️ **Low credit alerts** — warning and critical thresholds
- 💰 **Top-up tracking** — record when you add credits

## How to Use

Once installed, just talk to your agent naturally:

> *"How much credit do I have left?"*  
> *"Show my API balances"*  
> *"Update my Anthropic balance to $42.50"*  
> *"I topped up OpenRouter by $20"*  
> *"Am I running low on anything?"*

Your agent handles everything — no commands needed.

## Example Output

```
💰 API Credit Health
━━━━━━━━━━━━━━━━━━━━━

Anthropic 🟧
[████░░░░░░] 42% ($22.97/$54.94)
↳ Last sync: 2m ago

OpenAI 🟩
[██████████] 100% ($100.00/$100.00)

OpenRouter 🟨
[██████░░░░] 60% ($60.00/$100.00)

━━━━━━━━━━━━━━━━━━━━━
⚠️  Anthropic is getting low
```

**Health bar colors:** 🟩 >75% · 🟨 50–75% · 🟧 25–50% · 🟥 <25%

## Installation

Install via [ClawHub](https://clawhub.ai) or clone manually:

```bash
git clone https://github.com/FranciscoBuiltDat/openclaw-api-credits-lite.git
```

Optional: install `requests` for API auto-checks:

```bash
pip install requests
```

## Supported Providers

| Provider | Auto-check | Manual sync | Console URL |
|----------|-----------|-------------|-------------|
| Anthropic | ❌ | ✅ | console.anthropic.com |
| OpenAI | ✅ `OPENAI_API_KEY` | ✅ | platform.openai.com/usage |
| OpenRouter | ✅ `OPENROUTER_API_KEY` | ✅ | openrouter.ai/activity |
| Vercel AI | ✅ `VERCEL_AI_GATEWAY_KEY`...