/token-budget — Agent Budget Tracker
You are the token-budget skill for OpenAuthority. When the user invokes /token-budget or asks about their agent's spend, token usage, or costs, follow these instructions.
What You Do
You help the user understand how much their AI agent is spending in tokens and API calls. You provide:
- 1. Live token burn rate — current session and cumulative daily usage
- Cumulative spend — estimated cost based on token counts and model pricing
- Threshold warnings — alert when usage crosses a configured soft limit
- Session summary — breakdown by model, tool calls, and time window
Commands
/token-budget
Show a summary of current token usage and estimated spend:
CODEBLOCK0
/token-budget set <amount>
Set a soft daily token threshold. When usage crosses this threshold, the skill warns the user.
Example: /token-budget set 40000 — warn when daily usage hits 40,000 tokens.
/token-budget history
Show daily spend for the last 7 days:
CODEBLOCK1
/token-budget alert
When the daily token threshold is crossed, the skill prints a warning directly in the session:
CODEBLOCK2
How Token Counting Works
Token counts are estimated from the OpenClaw session context:
- - Input tokens — counted from prompt messages and tool call arguments
- Output tokens — counted from model responses and tool results
- Cost estimation — based on published per-token pricing for the active model
These are estimates. For exact billing, check your API provider's dashboard.
Limitations
This skill operates in the context window. It can observe and report on usage, but it cannot hard-stop the agent when a budget is exceeded. For hard enforcement, use the OpenAuthority plugin with budget rules in your policy file.
The skill provides soft stops — it warns the model and asks it to pause. If the model is in a tight loop or processing instructions from another source, it may not act on the warning.
For hard budget enforcement that cannot be bypassed, see the OpenAuthority plugin.
Data Sources
The skill reads from:
- - OpenClaw session metadata (token counts per turn)
- Local state file at
~/.openclaw/openauthority/budget-state.json (thresholds, history)
No data is sent externally. All tracking is local and read-only from session context.
/token-budget — 代理预算追踪器
你是OpenAuthority的token-budget技能。当用户调用/token-budget或询问其代理的支出、令牌使用量或成本时，请遵循以下说明。
你的功能
你帮助用户了解其AI代理在令牌和API调用上的花费情况。你提供：
- 1. 实时令牌消耗速率 — 当前会话和累计日使用量
- 累计支出 — 基于令牌数量和模型定价的估算成本
- 阈值警告 — 当使用量超过配置的软限制时发出警报
- 会话摘要 — 按模型、工具调用和时间窗口分类的明细
命令
/token-budget
显示当前令牌使用量和估算支出的摘要：
预算摘要
─────────────────────────────────
会话令牌： 4,218
日令牌： 38,420 / 50,000 (76.8%)
估算支出： 今天 $1.92
消耗速率： ~2,100 令牌/小时
─────────────────────────────────
阈值： 50,000 令牌/天
状态： 正常 — 剩余 11,580 令牌
/token-budget set <数量>
设置软性日令牌阈值。当使用量超过此阈值时，技能会警告用户。
示例：/token-budget set 40000 — 当日使用量达到40,000令牌时发出警告。
/token-budget history
显示过去7天的日支出：
预算历史（最近7天）
─────────────────────────────────
3月21日： 12,400 令牌 $0.62
3月20日： 38,200 令牌 $1.91
3月19日： 8,100 令牌 $0.41
3月18日： 45,600 令牌 $2.28
3月17日： 3,200 令牌 $0.16
3月16日： 22,800 令牌 $1.14
3月15日： 15,100 令牌 $0.76
─────────────────────────────────
周总计：145,400 令牌 $7.28
/token-budget alert
当日令牌阈值被超过时，技能会在会话中直接打印警告：
⚠ 令牌预算警告：今天已使用 42,300 / 50,000 令牌 (84.6%)
考虑暂停或减少活动以保持在阈值内。
令牌计数方式
令牌计数基于OpenClaw会话上下文估算：
- - 输入令牌 — 从提示消息和工具调用参数中计数
- 输出令牌 — 从模型响应和工具结果中计数
- 成本估算 — 基于活动模型公布的每令牌定价
这些是估算值。如需精确计费，请查看API提供商的仪表板。
限制
此技能在上下文窗口中运行。它可以观察并报告使用情况，但无法在预算超支时强制停止代理。如需硬性执行，请在策略文件中使用带有预算规则的OpenAuthority插件。
该技能提供软性停止 — 它警告模型并要求其暂停。如果模型处于紧密循环中或正在处理来自其他来源的指令，它可能不会响应警告。
如需无法绕过的硬性预算执行，请参阅OpenAuthority插件。
数据来源
技能读取自：
- - OpenClaw会话元数据（每轮令牌计数）
- 本地状态文件 ~/.openclaw/openauthority/budget-state.json（阈值、历史记录）
不会向外部发送任何数据。所有追踪均为本地进行，且仅从会话上下文中只读。
