Token Guard 是一款面向 OpenClaw 的 token 用量与成本监控工具，核心目标是帮助用户避免在 AI 智能体长时间运行时产生意外的高额费用。
用途
该工具针对 AI 智能体 24/7 运行、可能在夜间或后台任务中消耗大量高价位模型 token 的场景。资料指出，Opus 的输出 token 价格为 $75/百万，一次通宵编码会话可能消耗 $50 以上。Token Guard 通过监控、预算和优化三类能力，在花费失控前进行干预。
主要能力
监控方面，Token Guard 可以按天和按模型追踪 token 使用量，根据模型定价估算成本，并展示使用历史与趋势。
预算方面，用户可以设置每日支出上限，在达到可配置阈值（默认 80%）时发出警告，并可启用硬性上限，在超支时自动降级模型。
优化方面，工具提供模型成本对比、路由建议（例如推理任务用 Opus、后台任务用 Haiku），以及任务运行前的成本估算。
使用方式
Token Guard 通过命令行脚本使用，主要命令包括：
查看当前用量和模型成本： bash scripts/token-guard.sh status
设置每日预算并启用警告： bash scripts/token-guard.sh set-budget 10
设置硬性上限并在超支时自动降级到 Haiku： bash scripts/token-guard.sh set-budget 10 80 true claude-haiku-3-5
在运行任务前估算成本： bash scripts/token-guard.sh estimate claude-opus-4 50000 10000 10
查看使用历史： bash scripts/token-guard.sh history 7
对于 AI 智能体，可将以下命令加入心跳或定时任务： bash /path/to/token-guard/scripts/token-guard.sh monitor
当启用硬性上限且预算超支时，脚本会自动降级主模型。
安装
clawdhub install token-guard 或：git clone https://github.com/jzOcb/token-guard
运行要求
bash 4+、python3、curl。
模型成本对比
资料提供了以下模型的输入/输出价格（每百万 token）及相对倍数：
Claude Opus 4：输入 $15.00，输出 $75.00，相对 100x Claude Sonnet 4：输入 $3.00，输出 $15.00，相对 20x Claude Haiku 3.5：输入 $0.80，输出 $4.00，相对 5x GPT-4o：输入 $2.50，输出 $10.00，相对 13x Gemini Flash：输入 $0.075，输出 $0.30，相对 1x DeepSeek：输入 $0.27，输出 $1.10，相对 1.5x
推荐路由
Tier 1（推理/创意）：claude-opus-4，谨慎使用 Tier 2（日常工作）：claude-sonnet-4，主模型 Tier 3（后台/子智能体）：claude-haiku-3-5，子智能体模型 Tier 4（批量/心跳）：gemini-2.0-flash，心跳/定时任务
资料称，将后台任务从 Opus 路由到 Haiku 可节省这些任务 95% 的成本。
适用场景
适合运行 OpenClaw 智能体、需要控制 token 花费的用户，尤其是存在夜间运行、后台心跳检查、子智能体调用等容易产生高额费用的场景。
限制
资料未提供关于平台兼容性、并发限制、数据存储方式或与其他模型提供商集成的更多细节。部分功能（如自动降级）依赖硬性上限的启用。