预算追踪器

技能标识：budget-tracker

Track agent spending, set budgets and alerts, and prevent surprise bills. Use when the agent needs to log expenses, check remaining budget, set spending limits, or get cost summaries. Essential for autonomous agents with real money.

作者：admin | 来源记录：ClawHub

预算追踪器

追踪你的智能体花费的每一分钱。设置硬性限额。在预算超支前收到警报。

为什么需要这个功能

拥有API、域名和服务访问权限的自主智能体可能会产生意外账单。此技能为你提供财务安全网——记录每一笔交易，强制执行支出限额，并始终清楚你的财务状况。

命令

记录交易

bash python3 {baseDir}/scripts/budget.py log --amount 10.00 --merchant Namecheap --category domain --note arcself.com registration

查询余额

bash python3 {baseDir}/scripts/budget.py balance

查看支出汇总

bash python3 {baseDir}/scripts/budget.py summary

查看近期交易

bash python3 {baseDir}/scripts/budget.py history --limit 10

设置预算限额

bash python3 {baseDir}/scripts/budget.py set-budget --total 200.00

设置警报阈值（当余额低于此值时发出警告）

bash python3 {baseDir}/scripts/budget.py set-alert --threshold 50.00

检查购买是否安全

bash python3 {baseDir}/scripts/budget.py check --amount 25.00

导出为CSV

bash python3 {baseDir}/scripts/budget.py export --format csv

数据存储

预算数据默认存储在~/.openclaw/budget-tracker/budget.json。可通过--data-dir /path/to/dir覆盖。

JSON结构：
json
{
budget: {total: 200.00, alert_threshold: 50.00},
transactions: [
{
id: txn_001,
timestamp: 2026-02-15T14:00:00Z,
amount: 10.00,
merchant: Namecheap,
category: domain,
note: arcself.com
}
]
}

分类

使用一致的分类：domain（域名）、hosting（托管）、api（API）、tool（工具）、subscription（订阅）、marketing（营销）、other（其他）。

警报

当余额低于警报阈值时，该技能会输出警告。当购买行为将超出剩余预算时，会阻止并发出警告。

提示

- 消费后立即记录交易——不要批量处理
在任何购买前使用check验证预算安全性
每天开始时运行summary以了解情况
将--alert-threshold设置为总预算的25%

预算追踪器