代币预算监控器:通过 Openclaw Skills 管理 LLM 使用量

作者:互联网

2026-03-28

AI教程

什么是 代币预算监控器?

Token Budget Monitor 是使用 Openclaw Skills 的开发者管理大语言模型财务开销的必备工具。它提供了一种集中式方法,用于跟踪各种定时任务、回退链和活动会话中的输入及输出代币,确保自动化任务不会超出您的预算。

通过集成此技能,您可以精细地查看哪些特定任务正在消耗资源,从而实现更好的资源分配。它作为自主代理的财务安全网,通过强制执行严格的每日及单项任务限制来防止成本失控,同时提供备选模型建议以保持运营高效运行。

下载入口:https://github.com/openclaw/skills/tree/main/skills/aviclaw/token-budget-monitor

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install token-budget-monitor

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 token-budget-monitor。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

代币预算监控器 应用场景

  • 监控多个自动化 Openclaw Skills 的每日代币消耗。
  • 防止长期运行的定时任务或递归代理链中的成本失控。
  • 当代币使用量达到分配预算的特定百分比时,触发自动提醒。
  • 识别为次要任务切换到免费模型替代方案的机会。
代币预算监控器 工作原理
  1. 通过 CLI 安装技能,并在配置文件中配置全局和单项任务的代币限制。
  2. 将跟踪命令集成到您的 LLM 调用逻辑中,以捕获每次调用后的输入和输出代币。
  3. 监控器记录按任务名称和所使用的特定模型分类的数据。
  4. 运行状态检查或自动提醒命令,根据定义的预算阈值评估当前使用情况。
  5. 在达到预算限制时,利用推荐引擎识别免费模型选项。

代币预算监控器 配置指南

使用以下命令安装技能:

openclaw skills install aviclaw/token-budget-monitor

config.json 中配置您的限制和提醒阈值:

{
  "dailyLimit": 100000,
  "jobLimits": {
    "daily-tweet": 5000,
    "rss-brief": 15000
  },
  "alertThreshold": 0.8,
  "freeModels": [
    "nvidia/moonshotai/kimi-k2.5",
    "google/gemini-2.0-flash-exp"
  ]
}

代币预算监控器 数据架构与分类体系

该技能通过结构化配置和持久日志管理跟踪数据。它根据以下元数据分类组织使用情况:

属性 描述
job-name 特定任务或定时任务的唯一标识符
input_tokens 提示中发送的代币总数
output_tokens 响应中生成的代币总数
model 用于交易的特定模型标识符
status 相对于设定预算的当前使用状态
name: token-budget-monitor
version: "1.0.0"
description: Track and control token consumption across OpenClaw cron jobs
author: aviclaw
tags:
  - token
  - budget
  - monitor
  - openclaw

token-budget-monitor

Track and control token consumption across OpenClaw cron jobs, fallback chains, and sessions.

Installation

openclaw skills install aviclaw/token-budget-monitor

Usage

# Check current usage
node track-usage.js status

# Check budget for a specific job  
node track-usage.js check daily-tweet

# Alert if over budget
node track-usage.js alert

# Get model recommendations
node track-usage.js recommend

Integration

Add to cron jobs to track usage:

// After LLM call completes
const usage = result.usage;
exec('node /path/to/track-usage.js track  ' + 
  usage.input_tokens + ' ' + usage.output_tokens + ' ' + model);

Configuration

Edit config.json:

{
  "dailyLimit": 100000,
  "jobLimits": {
    "daily-tweet": 5000,
    "rss-brief": 15000
  },
  "alertThreshold": 0.8,
  "freeModels": [
    "nvidia/moonshotai/kimi-k2.5",
    "google/gemini-2.0-flash-exp"
  ]
}

Features

  • Per-job token tracking
  • Daily budget limits
  • Per-job custom limits
  • Alert when threshold exceeded
  • Recommend free model alternatives

Author

  • GitHub: @aviclaw

License

MIT