## Core Features

### 1. Usage Monitoring
Real-time session analysis with cost-saving suggestions.

### 2. Scheduled Alerts (P0)
Automatic balance monitoring with proactive notifications.

### 3. Built-in Tool Integration (P1)
Register as OpenClaw tool for seamless usage.

### 4. Cross-Session Analytics (P2)
Track spending patterns and generate reports.

## Supported Providers

| Provider | Balance Query | Token Estimate | Pricing |
|----------|---------------|----------------|---------|
| Kimi/Moonshot | ✅ API | ✅ API | ¥12/1M tokens |
| OpenAI | ❌ Console | ❌ Approx | USD/1M tokens |
| Anthropic/Claude | ❌ Console | ❌ Approx | USD/1M tokens |
| Google/Gemini | ❌ Console | ❌ Approx | USD/1M tokens |
| Ollama/Local | N/A Free | N/A | FREE |

## Cost-Saving Recommendations

### Context Management
| Scenario | Recommendation | Action |
|----------|----------------|--------|
| Context > 80% | 🚨 Critical: Must compact immediately | `/compact` |
| Context > 50% | 📊 Suggest: Consider compacting | `/compact` |
| Session > 50k tokens | ⚠️ Warning: Split tasks now | `/spawn` |
| Session > 20k tokens | 💡 Tip: Use sub-agents for large tasks | `/spawn` |

### Reasoning Optimization
| Scenario | Recommendation | Action |
|----------|----------------|--------|
| Reasoning ON + small task (<5k tokens) | 💡 Can disable to save 20-30% | `/thinking off` |
| Reasoning ON + complex task | ✅ Keep on for quality | Keep |

### Provider-Specific Tips
| Scenario | Recommendation |
|----------|----------------|
| Balance < ¥5 | 🚨 Enable save mode, avoid large tasks |
| Using GPT-4 | 💡 Consider GPT-4o-mini for 10x savings |
| Using Claude Opus | 💡 Consider Claude Sonnet for 5x savings |
| Running Ollama | 🎉 Free! No API costs |

## Commands

### Manager (Core)

## P0: Scheduled Monitoring & Alerts

Setup automatic balance monitoring with cron jobs.

### Setup Cron Job

### Alert Rules

| Condition | Action | Cooldown |
|-----------|--------|----------|
| Balance < threshold | Send alert | 1 hour |
| Balance < ¥1 | Send urgent alert | 30 min |
| 3 alerts in 24h | Suggest adding funds | - |

### Alert Output

When triggered, outputs JSON:

## P1: Tool Integration

Register as OpenClaw tool for direct usage.

### Tool Configuration

Add to `openclaw.json`:

## P2: Cross-Session Tracking

Track usage patterns across multiple sessions.

### Recording Sessions

Automatically or manually record each session:

## Environment Variables

- `MOONSHOT_API_KEY` - Kimi/Moonshot API key
- `OPENAI_API_KEY` - OpenAI API key (optional)
- `ANTHROPIC_API_KEY` - Anthropic API key (optional)

## Security

- API keys read from environment variables only
- All data stored locally in `.data/` directory
- No data uploaded to third-party servers
- Network requests only to official LLM APIs
- Alert state persisted locally with cooldown logic

## Pricing Reference

### Kimi/Moonshot
- K2.5: ¥12 / 1M tokens

### OpenAI
- GPT-4o: $2.5 / $10 per 1M
- GPT-4o-mini: $0.15 / $0.6 per 1M
- GPT-3.5-turbo: $0.5 / $1.5 per 1M

### Anthropic
- Claude 3.5 Sonnet: $3 / $15 per 1M
- Claude 3 Opus: $15 / $75 per 1M
- Claude 3 Haiku: $0.25 / $1.25 per 1M

### Google Gemini
- Gemini 1.5 Pro: $3.5 / $10.5 per 1M
- Gemini 1.5 Flash: $0.35 / $1.05 per 1M

### Ollama
- Local execution: FREE

---

---

# Token 管家

通用 LLM Token 管理工具，支持主动监控和数据分析。

## 使用场景

在以下情况使用此 skill：
- 监控 LLM API token 使用和费用
- 获取省钱优化建议
- 设置自动余额提醒
- 追踪多会话使用模式
- 生成每日/每周使用报告

## 快速开始

## 核心功能

### 1. 使用监控
实时会话分析，提供省钱建议。

### 2. 定时提醒 (P0)
自动余额监控，主动通知。

### 3. 工具集成 (P1)
注册为 OpenClaw 工具，无缝使用。

### 4. 跨会话分析 (P2)
追踪消费模式，生成报告。

## 支持的提供商

| 提供商 | 余额查询 | Token 估算 | 价格 |
|--------|----------|------------|------|
| Kimi/Moonshot | ✅ API | ✅ API | ¥12/百万 |
| OpenAI | ❌ 控制台 | ❌ 估算 | USD/百万 |
| Anthropic/Claude | ❌ 控制台 | ❌ 估算 | USD/百万 |
| Google/Gemini | ❌ 控制台 | ❌ 估算 | USD/百万 |
| Ollama/本地 | N/A 免费 | N/A | 免费 |

## 省钱优化建议

### 上下文管理
| 场景 | 建议 | 操作 |
|------|------|------|
| 上下文 > 80% | 🚨 紧急：必须立即压缩 | `/compact` |
| 上下文 > 50% | 📊 建议：适时压缩 | `/compact` |
| 会话 > 50k tokens | ⚠️ 警告：立即拆分任务 | `/spawn` |
| 会话 > 20k tokens | 💡 提示：大任务使用子代理 | `/spawn` |

### 推理优化
| 场景 | 建议 | 操作 |
|------|------|------|
| Reasoning 开启 + 小任务 (<5k tokens) | 💡 可关闭节省 20-30% | `/thinking off` |
| Reasoning 开启 + 复杂任务 | ✅ 保持开启确保质量 | 保持 |

### 提供商特定建议
| 场景 | 建议 |
|------|------|
| 余额 < ¥5 | 🚨 开启省钱模式，避免大任务 |
| 使用 GPT-4 | 💡 考虑 GPT-4o-mini 省 10 倍 |
| 使用 Claude Opus | 💡 考虑 Claude Sonnet 省 5 倍 |
| 运行 Ollama | 🎉 免费！无 API 费用 |

## 命令

### 管理器（核心）

## P0: 定时监控与提醒

使用 cron 设置自动余额监控。

### 设置定时任务

### 提醒规则

| 条件 | 动作 | 冷却时间 |
|------|------|----------|
| 余额 < 阈值 | 发送提醒 | 1 小时 |
| 余额 < ¥1 | 发送紧急提醒 | 30 分钟 |
| 24 小时内 3 次提醒 | 建议充值 | - |

### 提醒输出

触发时输出 JSON：

## P1: 工具集成

注册为 OpenClaw 工具直接使用。

### 工具配置

添加到 `openclaw.json`：