OpenClaw Cost Guard

在以下场景中使用该技能：

• 需要精确的成本报告（按日/按周/累计总成本）
• 识别开销最高的会话
• 设置防护机制以减少 token 消耗（除非用户明确要求，否则不修改配置）

1) 数据来源（重要）

优先使用 session JSONL 日志（其中包含每次调用的 usage 字段，通常含 真实 USD 成本）：

• OpenClaw：~/.openclaw/agents/*/sessions/*.jsonl
• 旧版/兼容路径：~/.clawdbot/agents/*/sessions/*.jsonl

请勿基于“当前上下文窗口”类的 token 字段进行估算。

2) 快速命令

近 7 日每日成本

python3 {baseDir}/scripts/extract_cost.py --last-days 7

今日 / 昨日成本

python3 {baseDir}/scripts/extract_cost.py --today
python3 {baseDir}/scripts/extract_cost.py --yesterday

开销最高的会话（Top 10）

python3 {baseDir}/scripts/extract_cost.py --top-sessions 10

JSON 输出（适用于仪表盘集成）

python3 {baseDir}/scripts/extract_cost.py --last-days 30 --json

3) 成本字段缺失时（备用估算方式）

部分服务商可能未提供 usage.cost。此时可手动指定每百万 token 的单价：

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) 预算告警

该提取器可作为 预算检查工具 运行：

python3 {baseDir}/scripts/extract_cost.py --today --budget-usd 5

• 若超出预算，将打印 ALERT 并以退出码 2（默认）终止执行。
• 如需非中断式检查（仅警告）：

python3 {baseDir}/scripts/extract_cost.py --today --budget-usd 5 --budget-mode warn

接入定时任务告警（推荐做法）

建议每日（或每小时）运行一次；若退出码为 2，则向自己发送 Telegram 消息。 （具体实现取决于你的 OpenClaw 通道配置；切勿在脚本中硬编码敏感信息。）

5) 节省 token 的操作指南（用于指导 AI 行为）

当用户提出“尽可能少用 token”时，请遵循以下原则：

• 默认响应长度限制：1–6 行；优先使用项目符号列表，而非段落描述
• 最多提问 1 次（仅在问题真正阻碍进展时才提出）
• 渐进式披露：仅在用户明确要求时，才提供额外细节
• 工具调用优化：批量执行；避免重复调用 status 或浏览器相关接口
• 禁止日志转储：不得将原始日志直接粘贴至聊天窗口；应做摘要并注明对应文件路径
• 硬性限制：每个任务最多执行 3 次网页操作（含 search/fetch）

可选自我约束提示语（推荐使用）：

“回答控制在 ≤6 行以内。如需更多信息，请先征得用户同意。”