使用手册 · 洞察
预算管理
为 Agent 或工作区设置成本上限，通过可视化进度条追踪开支，在预算耗尽前收到主动预警。
/budgets概述#
预算功能允许你为单个 Agent 或整个工作区设定美元支出阈值。每个预算实时追踪当前花费与阈值的对比，并以可视化进度条展示，让你随时掌握距离上限还有多远。
当支出接近或超过阈值时，ClawButler 会触发超额预警，并可选择启用预算熔断器自动禁用 Agent。AI 建议引擎会分析你的使用模式，推荐最优预算金额。
前置条件#
使用反馈#
创建预算后，预算页面显示：
- -预算列表，包含 Agent/工作区名称、阈值金额、当前花费和进度条
- -状态指示器：正常（绿色）、接近上限（橙色）、已超出（红色）
- -预警历史，显示已触发的通知及时间戳
- -每个预算的预警历史和当前熔断执行状态
Web 端操作#
从侧边栏的「洞察」部分导航到预算管理。
预算列表
主视图以表格展示所有预算。每行显示预算名称、作用范围（Agent 或工作区）、美元阈值、当前花费和水平进度条。进度条在 80% 时变为橙色，100% 时变为红色。点击任意行可查看详情或编辑。
创建 / 编辑预算
点击「新建预算」打开创建表单。选择作用范围——特定 Agent 或整个工作区。设置美元阈值并配置预警偏好（邮件、应用内通知或两者兼用）。可选启用熔断器，在预算超出时自动禁用 Agent。编辑时点击预算行即可修改任意字段。
预算熔断与执行
预算管理现在聚焦阈值、告警和可选熔断。运维人员主要查看当前花费、预警阈值，以及预算超出后是否会自动禁用 Agent。
预算预警
预警在两个阈值触发：接近上限（默认 80%）和已超出（100%）。每条预警包含预算名称、当前花费、阈值以及受影响的 Agent 或工作区。预警出现在通知中心并记录在审计日志中。
CLI 端操作#
列出所有预算及支出状态
Terminal
$ ap budget list为指定 Agent 创建预算并设置美元阈值
Terminal
$ ap budget create --agent <id> --amount <usd>更新现有预算的阈值金额
Terminal
$ ap budget update <id> --amount <usd>在 CLI 中查看预算状态和阈值熔断执行情况
Terminal
$ ap budget list常见问题#
问：预算超出后会发生什么？
答：系统会立即触发超额预警。如果启用了熔断器，Agent 会被自动禁用，直到提高或重置预算。如果未启用熔断器，Agent 继续运行但预警会持续触发。
问：预算阈值应该怎么设？
答：先参考最近的成本追踪数据，再设定一个预警阈值和一个你能接受的硬上限。需要硬停止时启用熔断；只想观察趋势时则只保留告警即可。
问：我可以一次性为所有 Agent 设置预算吗？
答：可以。创建预算时选择「工作区」范围，即可设置一个追踪该工作区内所有 Agent 总支出的单一阈值。