zai-usage

# Z.AI Usage Monitor

Track your Z.AI GLM Coding Plan usage in real-time.

## Quick Start

```bash
# Check usage
~/.openclaw/skills/zai-usage/scripts/usage-summary.sh

# Quick status
~/.openclaw/skills/zai-usage/scripts/quick-check.sh
```

## Setup

1. Get your JWT token from https://z.ai/manage-apikey/subscription
   - Open DevTools (F12)
   - Application → Local Storage → `z-ai-open-platform-token-production`

2. Store in `~/.openclaw/secrets/zai.env`:
   ```
   ZAI_JWT_TOKEN=eyJhbGci...
   ```

## What You See

- **5-Hour Quota** - Rolling token usage with reset countdown
- **Monthly Quota** - Monthly token allocation
- **Web Tools** - Search/reader/zread call limits
- **Plan Level** - Lite/Pro subscription status

## Status Icons

| Icon | Usage |
|------|-------|
| ✅ | < 50% |
| ⚠️ | 50-80% |
| 🔴 | > 80% |

## Commands

Ask me:
- "How's our Z.AI usage?"
- "Check credit usage"
- "Are we running low on credits?"

## Requirements

- `curl` - HTTP requests
- `jq` - JSON parsing
- `bc` - Number formatting (optional)

## Sources

- https://github.com/zereraz/tokensight
- https://www.reddit.com/r/ZaiGLM/comments/1pmb7fj/how_to_check_zai_coding_usage/

# Z.AI Usage Monitor

Monitor your Z.AI GLM Coding Plan usage and quota limits directly from OpenClaw.

## Features

- ✅ **Real-time quota tracking** - 5-hour and monthly token quotas
- ✅ **Web tool monitoring** - Track search/reader/zread usage
- ✅ **Visual progress bars** - Easy-to-read usage indicators
- ✅ **Reset countdown** - Know when quotas refresh
- ✅ **Quick status** - One-line summary for fast checks

## Screenshot

```
╔════════════════════════════════════════════════════════════╗
║           Z.AI GLM Coding Plan Usage                       ║
╚════════════════════════════════════════════════════════════╝

Subscription: GLM Coding Pro

5-Hour Token Quota:
   8M / 200M tokens (4%)
   [█░░░░░░░░░░░░░░░░░░░░]
   192M remaining
   Resets in: 4h 47m

Monthly Quota:
   19% used
   Resets: 2026-03-04

Web Tools (Monthly):
   1000 / 2000 calls (0%)
   1000 remaining

Status: ✅ Good
```

## Installation

### Option 1: ClawHub (Recommended)

```bash
cd ~/.openclaw
clawhub install zai-usage
```

### Option 2: Manual

```bash
cd ~/.openclaw/skills
git clone https://github.com/openclaw/skills.git temp
mv temp/zai-usage .
rm -rf temp
```

## Setup

### Step 1: Get Your Token

You need a JWT token from your Z.AI browser session (not an API key).

1. Go to: https://z.ai/manage-apikey/subscription
2. Open DevTools (`F12` or `Cmd+Option+I`)
3. Navigate to: **Application** → **Local Storage** → `https://z.ai`
4. Find: `z-ai-open-platform-token-production`
5. Copy the value (starts with `eyJhbGci...`)

**Reference:** https://github.com/zereraz/tokensight

### Step 2: Store Your Token

Add your token to OpenClaw secrets:

```bash
mkdir -p ~/.openclaw/secrets
echo "ZAI_JWT_TOKEN=eyJhbGci..." > ~/.openclaw/secrets/zai.env
```

Or add to your shell environment:

```bash
export ZAI_JWT_TOKEN="eyJhbGci..."
```

## Usage

### Command Line

```bash
# Full usage report
~/.openclaw/skills/zai-usage/scripts/usage-summary.sh

# Quick one-line status
~/.openclaw/skills/zai-usage/scr...