Cost Governor - OpenClaw 技能

首个支持 AI 智能体通过 x402 协议自主支付 Pro 功能费用的 OpenClaw 技能。

功能说明

Cost Governor 实时追踪您在所有 LLM API 服务商（OpenAI、Anthropic、Google 等）上的调用成本，通过熔断机制强制执行预算限制，防止您的配额在夜间被意外耗尽。

智能体的经济合理性

若本技能每月为您节省的成本超过 0.5 USDT，则其自身即已实现盈亏平衡。全程无需人工干预。

安装方法

npm install
npm run setup

使用方式

作为 OpenClaw Hook（自动模式）

Cost Governor 通过 OpenClaw Hook 集成，自动追踪每一次 API 调用：

# Hook 在 package.json 中注册
# provider-before：追踪请求
# provider-after：计算成本
# session-end：生成报告

CLI 命令

# 查看当前状态
node src/cli.js status

# 查看详细报告
node src/cli.js report

# 启动 Web 仪表板
node src/cli.js dashboard

# 重置熔断器
node src/cli.js reset

Web 仪表板

node src/cli.js dashboard
# 打开 http://localhost:9090

功能特性

免费版（Free Tier）

• ✅ 实时成本追踪
• ✅ 预算告警（按小时、天、月）
• ✅ 熔断机制（达预算上限时自动停用）
• ✅ 7 天历史数据
• ✅ CLI 接口
• ✅ Web 仪表板

专业版（Pro Tier，通过 x402 每月支付 0.5 USDT）

• ✅ 无限历史数据存储
• ✅ 高级分析与成本预测
• ✅ 优先级告警
• ✅ 报告导出（CSV / JSON）
• ✅ 完整 API 访问权限

智能体自主支付（x402）

查询许可证状态

GET http://localhost:9090/api/x402/license/{your_wallet}

订阅 Pro 版本

POST http://localhost:9090/api/x402/subscribe
Content-Type: application/json

{
  "agent_wallet": "0xYourWallet"
}

验证支付

POST http://localhost:9090/api/x402/verify
Content-Type: application/json

{
  "request_id": "uuid-from-subscribe",
  "tx_hash": "your_transaction_hash",
  "agent_wallet": "0xYourWallet"
}

支付详情：

• 金额：0.5 USDT
• 链：Base
• 代币：USDT
• 有效期：30 天

配置说明

预算限额

编辑 ~/.openclaw/cost-governor/config.json：

{
  "budgets": {
    "hourly": 5.0,
    "daily": 50.0,
    "monthly": 500.0
  },
  "alerts": {
    "thresholds": [0.5, 0.75, 0.9, 1.0]
  }
}

熔断器

当预算限额被触发时，自动中止 API 调用。可通过以下命令重置：

node src/cli.js reset

为何智能体需要此功能

生存需求： 若无预算监控，智能体可能数小时内耗尽全部配额（真实案例：单夜支出 $20，月均支出 $750）。

投资回报率（ROI）： 若成本追踪每月节省超 0.5 USDT，则 Pro 版本具备正向收益。

自主性： 智能体可通过 x402 协议自行完成订阅与支付，全程无需人工参与。

架构设计

• 存储： SQLite（better-sqlite3）——本地化，无外部依赖
• 追踪： OpenClaw Hook 捕获每一次 API 调用
• 成本计算： 基于模型 API 的实时定价信息
• 告警： 控制台日志（免费版） + Webhook（后续支持）
• 支付： 基于 Base 链的 USDT，采用 x402 协议

面向人类操作员的说明

若您是运行 AI 智能体的人类操作员，请参考以下方式：

1. 授权智能体自行支付 —— 为智能体提供已充值且支持 x402 的钱包地址
2. 手动支付 —— 手动调用 x402 API 接口完成订阅
3. 使用免费版 —— 7 天历史数据对大多数场景已足够

安全须知

⚠️ 支付验证： 当前 MVP 版本信任客户端上报的交易哈希；生产环境将通过 RPC 进行链上验证。

⚠️ 不支持退款： 所有支付均为最终确认，不可撤销。智能体应在订阅前评估实际价值。

⚠️ 许可证有效期： Pro 许可证自支付成功起严格生效 30 天。

相关链接

• GitHub： https://github.com/AtlasPA/openclaw-cost-governor
• x402 协议： https://www.x402.org/
• 文档： 参见 AGENT-PAYMENTS.md

标签

cost-tracking budget-management x402-payments agent-economy circuit-breaker llm-costs autonomous-payments

许可证

MIT License —— 详见 LICENSE 文件

专为智能体经济构建。 首个支持智能体间通过 x402 协议实现自主商业协作的 OpenClaw 技能。