实践openclaw-concepts

Usage tracking · OpenClaw — OpenClaw 如何精确追踪 token 用量与配额，并优雅降级到会话日志。

OpenClaw 如何精确追踪 token 用量与配额，并优雅降级到会话日志。

2026-08-31原文

本文为要点摘要，完整细节以原文为准。

🧭 一图看懂

由原文自动提炼 · 以原文为准

点击任一分支，查看这一点的一句话解读

OpenClaw 用量追踪与配额

直接拉取各 provider 用量端点，不做估算，只报 provider 数据
- provider 上报的套餐名、配额窗口、余额、花费…
- 配额窗口统一归一化为 X% left
- 无重置窗口的 provider 显示摘要文本（如余额）

STEP 1拉取 provider 用量端点

STEP 2归一化为 X% left

STEP 3缺失时回退会话日志

STEP 4非零实时值优先

STEP 5多端展示用量

直接从各 provider 用量端点拉取配额，不估算计费；配额窗口统一显示为 X% left，无窗口则显示摘要文本。
/status 和 session_status 在实时快照缺 token/model 数据时，回退到会话 transcript 日志，补全缺失计数并恢复模型标签。
/usage 支持 off/tokens/full 三态，显式 off 持久化后不可被配置默认值覆盖；/usage reset 才清除覆盖。
自定义 footer 模板支持 JSON 文件热加载，无效模板静默回退内置样式并告警。
对 agent harness 设计：用量追踪需区分 provider 报告与本地估算，且状态覆盖需明确优先级。

原文：Usage tracking · OpenClaw

还没吃透？把这篇丢给 AI 助手，让它结合你的场景讲清楚。