Skillppx logo

Token Manager

监控 LLM 使用量与费用，提供省钱建议和自动提醒。

已扫描
适合谁
经常使用大模型 API 的开发者、关注成本控制的 AI 项目负责人
不适合谁
无需管理 API 成本的普通用户、不使用外部 LLM 服务的本地部署者
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @kelegele/token-manager
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

Token Manager

通用大模型令牌管理工具，支持主动监控与数据分析。

何时使用

当您需要：

  • 监控大模型 API 的令牌使用情况和费用
  • 获取节省成本的建议
  • 设置自动余额提醒
  • 跨多个会话追踪使用情况
  • 生成每日/每周使用报告

快速开始

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）

追踪支出模式，生成分析报告。

支持的服务提供商

服务提供商余额查询方式令牌估算方式定价
Kimi/Moonshot✅ API✅ API¥12/1M 令牌
OpenAI❌ 控制台❌ 近似值USD/1M 令牌
Anthropic/Claude❌ 控制台❌ 近似值USD/1M 令牌
Google/Gemini❌ 控制台❌ 近似值USD/1M 令牌
Ollama/本地部署N/A 免费N/A免费

成本节省建议

上下文管理

场景建议操作
上下文使用 > 80%🚨 严重：必须立即压缩/compact
上下文使用 > 50%📊 建议：考虑压缩/compact
会话使用 > 50k 令牌⚠️ 警告：现在应拆分任务/spawn
会话使用 > 20k 令牌💡 提示：大型任务可使用子代理/spawn

推理优化

场景建议操作
推理开启 + 小型任务（<5k 令牌）💡 可关闭以节省 20-30%/thinking off
推理开启 + 复杂任务✅ 保持开启以保证质量保持开启

服务商专属提示

场景建议
余额 < ¥5🚨 启用节省模式，避免执行大任务
使用 GPT-4💡 考虑改用 GPT-4o-mini，可节省 10 倍
使用 Claude Opus💡 考虑改用 Claude Sonnet，可节省 5 倍
运行 Ollama🎉 免费！无 API 费用

命令

管理器（核心）

node scripts/manager.js report <tokensIn> <tokensOut> <contextUsed> <contextMax> <thinking> [balance] [provider] [model] [apiKey]
node scripts/manager.js balance [provider] [apiKey]
node scripts/manager.js estimate <provider> <inputTokens> <outputTokens> [model]
node scripts/manager.js providers
node scripts/manager.js history

调度器（P0 - Cron 提醒）

# 检查余额并在低于阈值时触发提醒
node scripts/scheduler.js check <provider> <threshold>

# 查看提醒统计
node scripts/scheduler.js stats

会话追踪器（P2 - 分析）

# 记录会话用于追踪
node scripts/session-tracker.js record <provider> <model> <tokensIn> <tokensOut> <cost> [currency]

# 生成报告
node scripts/session-tracker.js daily [date]
node scripts/session-tracker.js weekly
node scripts/session-tracker.js recommend

P0：定时监控与提醒

通过 cron 任务设置自动余额监控。

设置 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": "检查当前令牌使用情况和费用"
    },
    "token_balance": {
      "command": "cd /path/to/token-manager && node scripts/manager.js balance",
      "description": "查询账户余额"
    }
  }
}

注册后使用

# 直接调用命令
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
# 输出：总令牌数、费用、会话数量、服务商分布

每周报告

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 密钥（可选）

安全性

  • 仅从环境变量读取 API 密钥
  • 所有数据本地存储于 .data/ 目录
  • 不向第三方服务器上传任何数据
  • 网络请求仅指向官方大模型 API
  • 提醒状态本地持久化，包含冷却逻辑

定价参考

Kimi/Moonshot

  • K2.5：¥12 / 1M 令牌

OpenAI

  • GPT-4o：$2.5 / $10 每 1M 令牌
  • GPT-4o-mini：$0.15 / $0.6 每 1M 令牌
  • GPT-3.5-turbo：$0.5 / $1.5 每 1M 令牌

Anthropic

  • Claude 3.5 Sonnet：$3 / $15 每 1M 令牌
  • Claude 3 Opus：$15 / $75 每 1M 令牌
  • Claude 3 Haiku：$0.25 / $1.25 每 1M 令牌

Google Gemini

  • Gemini 1.5 Pro：$3.5 / $10.5 每百万
  • Gemini 1.5 Flash：$0.35 / $1.05 每百万

Ollama

  • 本地执行：免费

Token 管家

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

使用场景

在以下情况使用此 skill：

  • 监控 LLM API 的 token 使用量与费用
  • 获取节省成本的优化建议
  • 设置自动余额提醒
  • 追踪多会话的使用模式
  • 生成每日或每周使用报告

快速开始

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 密钥（可选）

安全说明

  • API 密钥仅从环境变量读取
  • 所有数据本地存储于 .data/ 目录
  • 无数据上传至第三方服务器
  • 网络请求仅访问官方 LLM API
  • 提醒状态本地持久化，包含冷却逻辑

价格参考

Kimi/Moonshot

  • K2.5：¥12 / 百万 tokens

OpenAI

  • GPT-4o：$2.5 / $10 每百万
  • GPT-4o-mini：$0.15 / $0.6 每百万
  • GPT-3.5-turbo：$0.5 / $1.5 每百万

Anthropic

  • Claude 3.5 Sonnet：$3 / $15 每百万
  • Claude 3 Opus：$15 / $75 每百万
  • Claude 3 Haiku：$0.25 / $1.25 每百万

Google Gemini

  • Gemini 1.5 Pro：$3.5 / $10.5 每百万
  • Gemini 1.5 Flash：$0.35 / $1.05 每百万

Ollama

  • 本地运行：免费
K
@kelegele

已收录 1 个 Skill

相关推荐