api-credits-lite

通过视频游戏风格的健康栏显示 5 个核心提供商（Anthropic、OpenAI、OpenRouter、Mistral、Groq）的 API 积分余额。 API 自动检查和手动同步。

# 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 providers that expose a balance API (requires the relevant API key set as an env var):

```bash
python3 scripts/check_openai.py       # uses OPENAI_API_KEY
python3 scripts/check_openrouter.py   # uses OPENROUTER_API_KEY
python3 scripts/check_vercel.py       # uses VERCEL_AI_GATEWAY_KEY
```

Anthropic, Mistral, and Groq don't have public balance APIs — use manual sync for those.

---

## Record a Top-Up

**Triggers:** "I added $X to my [provider] account", "I topped up $50 on OpenRouter"

```bash
python3 scripts/topup.py <provider> <amount>
# Example: python3 scripts/topup.py openrouter 20.00
```

---

## Troubleshooting

If the display shows no providers, the config may be empty. Tell the user to run the first manual sync for each provider they use, or copy the example config:

```bash
cp config.example.json config.json
```

---

## Upgrading

Need 16+ providers, auto-tracking from session logs, cloud SDKs (AWS/Azure/GCP), or heartbeat integration? Suggest **api-credits-pro**.

---

## 中文说明

# API Credits Lite

当用户询问 API 积分、余额、消费，或想更新其 Anthropic、OpenAI、OpenRouter、Mistral 或 Groq 的积分信息时，使用此技能。

## 何时使用

✅ **在用户提出以下问题时使用此技能：**

- “我还剩多少积分？” / “我的余额是多少？”
- “显示我的 API 积分” / “检查我的积分”
- “把我的 [provider] 余额更新为 $X”
- “我给 [provider] 充值了 $X”
- “我的 [provider] 快用完了吗？”

❌ **不要在以下情况使用：**
- 用户需要 16+ 个提供商、JSONL 自动追踪、云 SDK 或心跳集成 → 使用 **api-credits-pro**

## 如何使用

你在内部运行脚本——用户从不需要输入 `python3`。请自然地回应，并以对话方式呈现健康栏输出。

技能根目录位于：`~/.openclaw/workspace/skills/api-credits-lite/`
运行脚本：`python3 <skill-root>/scripts/<script>.py <args>`

---

## 显示积分余额

**触发语：** "show my credits", "how much do I have left", "check my API balance"

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

为所有已配置的提供商显示复古风格的健康栏。颜色：🟩 >75% · 🟨 50–75% · 🟧 25–50% · 🟥 <25%

---

## 手动同步余额

**触发语：** "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
```

支持的提供商：`anthropic`、`openai`、`openrouter`、`mistral`、`groq`

在哪里查看余额：
- **Anthropic** → console.anthropic.com
- **OpenAI** → platform.openai.com/usage
- **OpenRouter** → openrouter.ai/activity
- **Mistral** → console.mistral.ai/billing
- **Groq** → console.groq.com/settings/billing

---

## 通过 API 自动检查余额

**触发语：** "check my OpenAI balance automatically", "pull my OpenRouter credits"

对于提供余额 API 的提供商（需要将相关 API 密钥设置为环境变量）：

```bash
python3 scripts/check_openai.py       # uses OPENAI_API_KEY
python3 scripts/check_openrouter.py   # uses OPENROUTER_API_KEY
python3 scripts/check_vercel.py       # uses VERCEL_AI_GATEWAY_KEY
```

Anthropic、Mistral 和 Groq 没有公开的余额 API——请对它们使用手动同步。

---

## 记录一次充值

**触发语：** "I added $X to my [provider] account", "I topped up $50 on OpenRouter"

```bash
python3 scripts/topup.py <provider> <amount>
# Example: python3 scripts/topup.py openrouter 20.00
```

---

## 故障排查

如果显示中没有任何提供商，可能是配置为空。请让用户为其使用的每个提供商运行首次手动同步，或复制示例配置：

```bash
cp config.example.json config.json
```

---

## 升级

需要 16+ 个提供商、从会话日志自动追踪、云 SDK（AWS/Azure/GCP）或心跳集成？请推荐 **api-credits-pro**。