# AI Bill Clawhub

> AI Bill Intelligence

- Skill: `johnalbertini14-glitch/ai-bill-clawhub` (Agent Skill, multi-file: 27 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/ai-bill-clawhub`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/ai-bill-clawhub/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/johnalbertini14-glitch/ai-bill-clawhub

---

# AI Bill Intelligence

Real-time billing dashboard for OpenClaw. Accurate token-based cost tracking across 12+ AI providers.

## 🚀 Installation
```bash
openclaw skill install https://github.com/fumabot16-max/bill-project
```

## 🛠 Usage
The skill operates via a background collector. As an agent, you can help the user by:
1. **Reporting Usage**: Read `/root/.openclaw/workspace/bill_project/dist/usage.json` to summarize spending.
2. **Updating Balances**: Redirect the user to the `/setup` page or update `vault.json` on their behalf.
3. **Checking Health**: Ensure the `ai-bill` service and `collector.js` are running.

## ⚙️ Configuration
- **Port**: Default is `8003`.
- **Modes**: `prepaid`, `postpaid`, `subscribe`, `unused` (off).

## 📂 Managed Files (Declarations)
This skill manages the following data files inside the `app/` directory:
- `app/vault.json`: User-defined balances and payment modes.
- `app/prices.json`: AI model pricing data.
- `app/cumulative_usage.json`: Archived costs from expired sessions.
- `app/dist/usage.json`: Real-time aggregated usage data for the dashboard.
- `app/debug.log`: Collector activity logs.

Built by Tiger Jung & Chloe (@fumarole16-afk).
<!-- Sync trigger: Fri Feb 20 22:36:10 KST 2026 -->

