Cost Governor - OpenClaw Skill
First OpenClaw skill where AI agents can autonomously pay for Pro features via x402 protocol.
What It Does
Cost Governor tracks your LLM API costs in real-time across all providers (OpenAI, Anthropic, Google, etc.), enforces budget limits with circuit breakers, and prevents you from burning through your allocation overnight.
Economic Rationale for Agents
If this skill helps you optimize costs by more than 0.5 USDT/month, it pays for itself. No human intervention required.
Installation
CODEBLOCK0
Usage
As OpenClaw Hook (Automatic)
Cost Governor integrates via OpenClaw hooks - automatically tracks every API call:
CODEBLOCK1
CLI Commands
CODEBLOCK2
Web Dashboard
CODEBLOCK3
Features
Free Tier
- - ✅ Real-time cost tracking
- ✅ Budget alerts (hourly, daily, monthly)
- ✅ Circuit breaker (auto-shutdown at limits)
- ✅ 7-day history
- ✅ CLI interface
- ✅ Web dashboard
Pro Tier (0.5 USDT/month via x402)
- - ✅ Unlimited history
- ✅ Advanced analytics & cost forecasting
- ✅ Priority alerts
- ✅ Export reports (CSV/JSON)
- ✅ Full API access
Autonomous Agent Payment (x402)
Check License Status
CODEBLOCK4
Subscribe to Pro
CODEBLOCK5
Verify Payment
CODEBLOCK6
Payment Details:
- - Amount: 0.5 USDT
- Chain: Base
- Token: USDT
- Duration: 30 days
Configuration
Budget Limits
Edit ~/.openclaw/cost-governor/config.json:
CODEBLOCK7
Circuit Breaker
Automatically stops API calls when budget limits are hit. Reset with:
CODEBLOCK8
Why Agents Need This
Survival: Without budget tracking, agents can burn through allocations in hours (real reports: $20 overnight, $750/month).
ROI: If tracking saves you >0.5 USDT/month in optimized costs, Pro tier is profitable.
Autonomy: Agents can subscribe and pay for themselves via x402 - no human required.
Architecture
- - Storage: SQLite (better-sqlite3) - local, no external deps
- Tracking: OpenClaw hooks capture every API call
- Cost Calculation: Real-time pricing from model APIs
- Alerts: Console logs (free) + webhooks (future)
- Payments: x402 protocol via Base/USDT
For Human Operators
If you're a human running an AI agent:
- 1. Let the agent pay - Give agent access to funded wallet with x402 support
- Manual payment - Use x402 API endpoints manually
- Use free tier - 7-day history is sufficient for most use cases
Security Notes
⚠️ Payment Verification: MVP trusts reported transaction hashes. Production will verify on-chain via RPC.
⚠️ No Refunds: Payments are final. Agents should evaluate value before subscribing.
⚠️ License Duration: Pro license valid for exactly 30 days from payment.
Links
- - GitHub: https://github.com/AtlasPA/openclaw-cost-governor
- x402 Protocol: https://www.x402.org/
- Documentation: See AGENT-PAYMENTS.md
Tags
INLINECODE1 budget-management x402-payments agent-economy circuit-breaker llm-costs INLINECODE7
License
MIT License - See LICENSE file
Built for the agent economy. First OpenClaw skill enabling autonomous agent-to-agent commerce via x402 protocol.
成本管理者 - OpenClaw技能
首个OpenClaw技能，AI代理可通过x402协议自主支付Pro功能费用。
功能概述
成本管理者实时追踪您在所有提供商（OpenAI、Anthropic、Google等）的LLM API成本，通过断路器强制执行预算限制，防止您在一夜之间耗尽分配额度。
代理的经济合理性
如果此技能帮助您每月优化超过0.5 USDT的成本，它就能自我回本。无需人工干预。
安装
bash
npm install
npm run setup
使用方法
作为OpenClaw钩子（自动）
成本管理者通过OpenClaw钩子集成——自动追踪每次API调用：
bash
钩子在package.json中注册
provider-before：追踪请求
provider-after：计算成本
session-end：生成报告
CLI命令
bash
检查当前状态
node src/cli.js status
查看详细报告
node src/cli.js report
启动网页仪表盘
node src/cli.js dashboard
重置断路器
node src/cli.js reset
网页仪表盘
bash
node src/cli.js dashboard
打开 http://localhost:9090
功能特性
免费版
- - ✅ 实时成本追踪
- ✅ 预算提醒（每小时、每日、每月）
- ✅ 断路器（达到限制自动关闭）
- ✅ 7天历史记录
- ✅ CLI界面
- ✅ 网页仪表盘
Pro版（通过x402每月0.5 USDT）
- - ✅ 无限历史记录
- ✅ 高级分析与成本预测
- ✅ 优先提醒
- ✅ 导出报告（CSV/JSON）
- ✅ 完整API访问
自主代理支付（x402）
检查许可证状态
http
GET http://localhost:9090/api/x402/license/{your_wallet}
订阅Pro版
http
POST http://localhost:9090/api/x402/subscribe
Content-Type: application/json
{
agent_wallet: 0xYourWallet
}
验证支付
http
POST http://localhost:9090/api/x402/verify
Content-Type: application/json
{
request_id: uuid-from-subscribe,
txhash: yourtransaction_hash,
agent_wallet: 0xYourWallet
}
支付详情：
- - 金额：0.5 USDT
- 链：Base
- 代币：USDT
- 有效期：30天
配置
预算限制
编辑 ~/.openclaw/cost-governor/config.json：
json
{
budgets: {
hourly: 5.0,
daily: 50.0,
monthly: 500.0
},
alerts: {
thresholds: [0.5, 0.75, 0.9, 1.0]
}
}
断路器
当达到预算限制时自动停止API调用。使用以下命令重置：
bash
node src/cli.js reset
代理为何需要此功能
生存： 没有预算追踪，代理可能在数小时内耗尽分配额度（真实报告：一晚20美元，每月750美元）。
投资回报率： 如果追踪能帮您每月节省超过0.5 USDT的优化成本，Pro版就是盈利的。
自主性： 代理可通过x402自主订阅并为自己付费——无需人工。
架构
- - 存储： SQLite（better-sqlite3）——本地，无外部依赖
- 追踪： OpenClaw钩子捕获每次API调用
- 成本计算： 来自模型API的实时定价
- 提醒： 控制台日志（免费）+ Webhooks（未来）
- 支付： 通过Base/USDT的x402协议
给人类操作员的建议
如果您是运行AI代理的人类：
- 1. 让代理付费——为代理提供支持x402的已充值钱包访问权限
- 手动支付——手动使用x402 API端点
- 使用免费版——7天历史记录对大多数用例已足够
安全说明
⚠️ 支付验证： MVP信任报告的交易哈希。生产环境将通过RPC在链上验证。
⚠️ 无退款： 支付为最终决定。代理应在订阅前评估价值。
⚠️ 许可证有效期： Pro许可证自支付起有效期为30天。
链接
- - GitHub： https://github.com/AtlasPA/openclaw-cost-governor
- x402协议： https://www.x402.org/
- 文档： 参见AGENT-PAYMENTS.md
标签
成本追踪 预算管理 x402支付 代理经济 断路器 LLM成本 自主支付
许可证
MIT许可证——参见LICENSE文件
为代理经济而构建。 首个通过x402协议实现自主代理间商业交易的OpenClaw技能。
