介绍
# OpenClaw Cost Guard
当您需要以下功能时使用此技能： - **准确的成本报告**（每日/每周/总计） - **最昂贵的会话** - **降低 token 消耗的防护措施**（除非用户要求，否则不更改配置）
## 1) 数据源（重要）
优先使用 **session JSONL** 日志（它们包含每次调用的 `usage`，通常带有 **真实美元成本**）： - OpenClaw：`~/.openclaw/agents/*/sessions/*.jsonl` - Legacy/compat：`~/.clawdbot/agents/*/sessions/*.jsonl`
**不要**根据“当前上下文窗口”风格的 token 字段进行估算。
## 2) 快速命令
### 每日成本（过去 7 天） ```bash python3 {baseDir}/scripts/extract_cost.py --last-days 7 ```
### 今天 / 昨天 ```bash python3 {baseDir}/scripts/extract_cost.py --today python3 {baseDir}/scripts/extract_cost.py --yesterday ```
### 最昂贵的会话 ```bash python3 {baseDir}/scripts/extract_cost.py --top-sessions 10 ```
### JSON 输出（用于仪表板） ```bash python3 {baseDir}/scripts/extract_cost.py --last-days 30 --json ```
## 3) 如果缺少成本（后备估算）
某些提供商可能会省略 `usage.cost`。您可以提供每百万 token 的价格：
```bash export PRICE_INPUT=1.75 export PRICE_OUTPUT=14 export PRICE_CACHE_READ=0.175 export PRICE_CACHE_WRITE=0 python3 {baseDir}/scripts/extract_cost.py --last-days 7 ```
## 4) 预算警报
提取器可以作为 **预算检查** 运行：
```bash python3 {baseDir}/scripts/extract_cost.py --today --budget-usd 5 ```
- 如果超出预算，它会打印 **ALERT** 并以代码 **2** 退出（默认）。 - 对于非失败检查：
```bash python3 {baseDir}/scripts/extract_cost.py --today --budget-usd 5 --budget-mode warn ```
### 将其连接到 cron 警报（推荐）
每天（或每小时）运行一次，如果退出代码为 2，则向自己发送一条 Telegram 消息。 （具体实现取决于您的 OpenClaw 通道设置；请勿在脚本中嵌入密钥。）
## 5) 节省 Token 指南（训练 AI）
当用户说“尽可能使用最少的 token”时，应用以下原则： - **默认回复预算：** 1–6 行，要点优于段落 - **最多提 1 个问题**（仅在真正受阻时） - **渐进式披露：** 仅在被问及时提供详细信息 - **工具调用：** 批处理；避免重复调用 `status`/browser - **不要将日志转储到聊天中；** 摘要 + 指向文件路径 - **硬限制：** 每个任务最多 3 次网页迭代（搜索/获取）
用于自我约束的可选措辞： > “回答控制在 <=6 行。如果需要更多内容，请征得许可。”