Token Manager
by @kelegele
Universal LLM Token Manager - Monitor usage and provide cost-saving recommendations for Kimi, OpenAI, Anthropic, Gemini, and local models. Features scheduled monitoring, cross-session tracking, and proactive alerts.
clawhub install token-manager📖 About This Skill
name: token-manager description: Universal LLM Token Manager - Monitor usage and provide cost-saving recommendations for Kimi, OpenAI, Anthropic, Gemini, and local models. Features scheduled monitoring, cross-session tracking, and proactive alerts.
Token Manager
Universal LLM Token Manager with proactive monitoring and analytics.
When to Use
Use this skill when you need to:
Quick Start
cd /path/to/token-manager
export MOONSHOT_API_KEY="your-api-key"Generate report
node scripts/manager.js report 11000 146 42000 200000 off 9.26 moonshot kimi-k2.5
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)
node scripts/manager.js report [balance] [provider] [model] [apiKey]
node scripts/manager.js balance [provider] [apiKey]
node scripts/manager.js estimate [model]
node scripts/manager.js providers
node scripts/manager.js history
Scheduler (P0 - Cron Alerts)
# Check balance and alert if below threshold
node scripts/scheduler.js check View alert statistics
node scripts/scheduler.js stats
Session Tracker (P2 - Analytics)
# Record session for tracking
node scripts/session-tracker.js record [currency]Generate reports
node scripts/session-tracker.js daily [date]
node scripts/session-tracker.js weekly
node scripts/session-tracker.js recommend
P0: Scheduled Monitoring & Alerts
Setup automatic balance monitoring with cron jobs.
Setup Cron Job
# Check every hour, alert if below ¥5
openclaw cron add \
--name "token-balance-check" \
--schedule "0 * * * *" \
--command "cd /path/to/token-manager && node scripts/scheduler.js check moonshot 5"
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:
{
"alert": true,
"balance": 3.50,
"threshold": 5,
"messages": {
"en": "🚨 [URGENT] Token Manager Alert...",
"cn": "🚨 [紧急] Token 管家提醒..."
}
}
P1: Tool Integration
Register as OpenClaw tool for direct usage.
Tool Configuration
Add to openclaw.json:
{
"tools": {
"token_status": {
"command": "cd /path/to/token-manager && node scripts/manager.js report",
"description": "Check current token usage and costs"
},
"token_balance": {
"command": "cd /path/to/token-manager && node scripts/manager.js balance",
"description": "Query account balance"
}
}
}
Usage After Registration
# Direct commands
openclaw tool token_status 11000 146 42000 200000 off 9.26 moonshot
openclaw tool token_balance moonshot
P2: Cross-Session Tracking
Track usage patterns across multiple sessions.
Recording Sessions
Automatically or manually record each session:
node scripts/session-tracker.js record moonshot kimi-k2.5 5000 500 0.06 CNY
Daily Report
node scripts/session-tracker.js daily
Output: Total tokens, cost, session count, provider breakdown
Weekly Report
node scripts/session-tracker.js weekly
Output: 7-day summary with trend analysis
Smart Recommendations
node scripts/session-tracker.js recommend
Analyzes patterns and suggests optimizations
Environment Variables
MOONSHOT_API_KEY - Kimi/Moonshot API keyOPENAI_API_KEY - OpenAI API key (optional)ANTHROPIC_API_KEY - Anthropic API key (optional)Security
.data/ directoryPricing Reference
Kimi/Moonshot
OpenAI
Anthropic
Google Gemini
Ollama
Token 管家
通用 LLM Token 管理工具,支持主动监控和数据分析。
使用场景
在以下情况使用此 skill:
快速开始
cd /path/to/token-manager
export MOONSHOT_API_KEY="your-api-key"生成报告
node scripts/manager.js report 11000 146 42000 200000 off 9.26 moonshot kimi-k2.5
核心功能
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 费用 |命令
管理器(核心)
node scripts/manager.js report <输入tokens> <输出tokens> <上下文已用> <上下文上限> <推理状态> [余额] [提供商] [模型] [apiKey]
node scripts/manager.js balance [提供商] [apiKey]
node scripts/manager.js estimate <提供商> <输入tokens> <输出tokens> [模型]
node scripts/manager.js providers
node scripts/manager.js history
调度器 (P0 - 定时提醒)
# 检查余额,低于阈值时提醒
node scripts/scheduler.js check <提供商> <阈值>查看提醒统计
node scripts/scheduler.js stats
会话追踪器 (P2 - 分析)
# 记录会话
node scripts/session-tracker.js record <提供商> <模型> <输入tokens> <输出tokens> <费用> [货币]生成报告
node scripts/session-tracker.js daily [日期]
node scripts/session-tracker.js weekly
node scripts/session-tracker.js recommend
P0: 定时监控与提醒
使用 cron 设置自动余额监控。
设置定时任务
# 每小时检查,低于 ¥5 时提醒
openclaw cron add \
--name "token-balance-check" \
--schedule "0 * * * *" \
--command "cd /path/to/token-manager && node scripts/scheduler.js check moonshot 5"
提醒规则
| 条件 | 动作 | 冷却时间 | |------|------|----------| | 余额 < 阈值 | 发送提醒 | 1 小时 | | 余额 < ¥1 | 发送紧急提醒 | 30 分钟 | | 24 小时内 3 次提醒 | 建议充值 | - |
提醒输出
触发时输出 JSON:
{
"alert": true,
"balance": 3.50,
"threshold": 5,
"messages": {
"en": "🚨 [URGENT] Token Manager Alert...",
"cn": "🚨 [紧急] Token 管家提醒..."
}
}
P1: 工具集成
注册为 OpenClaw 工具直接使用。
工具配置
添加到 openclaw.json:
{
"tools": {
"token_status": {
"command": "cd /path/to/token-manager && node scripts/manager.js report",
"description": "Check current token usage and costs"
},
"token_balance": {
"command": "cd /path/to/token-manager && node scripts/manager.js balance",
"description": "Query account balance"
}
}
}
注册后使用
# 直接命令
openclaw tool token_status 11000 146 42000 200000 off 9.26 moonshot
openclaw tool token_balance moonshot
P2: 跨会话追踪
追踪多会话使用模式。
记录会话
自动或手动记录每个会话:
node scripts/session-tracker.js record moonshot kimi-k2.5 5000 500 0.06 CNY
每日报告
node scripts/session-tracker.js daily
输出:总 token、费用、会话数、提供商分布
每周报告
node scripts/session-tracker.js weekly
输出:7 天摘要及趋势分析
智能建议
node scripts/session-tracker.js recommend
分析模式并提供优化建议
环境变量
MOONSHOT_API_KEY - Kimi/Moonshot API 密钥OPENAI_API_KEY - OpenAI API 密钥(可选)ANTHROPIC_API_KEY - Anthropic API 密钥(可选)安全说明
.data/ 目录价格参考
Kimi/Moonshot
OpenAI
Anthropic
Google Gemini
Ollama
⚡ When to Use
💡 Examples
cd /path/to/token-manager
export MOONSHOT_API_KEY="your-api-key"Generate report
node scripts/manager.js report 11000 146 42000 200000 off 9.26 moonshot kimi-k2.5