使用情况跟踪

# 它是什么

• 直接从各提供商的用量端点拉取提供商用量/配额。
• 不估算费用；只显示提供商报告的窗口。
• 面向人的状态输出会规范化为 X% left，即使上游 API 报告的是已消耗配额、剩余配额或仅原始计数。
• 会话级 /status 和 session_status 可在实时会话快照稀疏时回退到最新的转录用量条目。该回退会补齐缺失的令牌/缓存计数器，可以恢复活跃运行时模型标签，并在会话元数据缺失或更小时优先使用更大的提示词导向总量。现有非零实时值仍然优先。

# 显示位置

• 聊天中的 /status：带有丰富表情符号的状态卡片，包含会话令牌 + 预估费用（仅 API key）。当可用时，会显示当前模型提供商的提供商用量，并规范化为 X% left 窗口。
• 聊天中的 /usage off|tokens|full：逐响应的用量页脚（OAuth 仅显示令牌）。
• 聊天中的 /usage cost：从 OpenClaw 会话日志聚合的本地费用摘要。
• CLI：openclaw status --usage 打印完整的逐提供商明细。
• CLI：openclaw channels list 在提供商配置旁打印相同的用量快照（使用 --no-usage 跳过）。
• macOS 菜单栏：Context 下的 “用量” 部分（仅在可用时）。

# 提供商 + 凭证

• Anthropic（Claude）：凭证配置文件中的 OAuth 令牌。
• GitHub Copilot：凭证配置文件中的 OAuth 令牌。
• Gemini CLI：凭证配置文件中的 OAuth 令牌。
  • JSON 用量会回退到 stats；stats.cached 会规范化为 cacheRead。
• OpenAI Codex：凭证配置文件中的 OAuth 令牌（存在 accountId 时使用）。
• MiniMax：API key 或 MiniMax OAuth 凭证配置文件。OpenClaw 将 minimax、minimax-cn 和 minimax-portal 视为同一个 MiniMax 配额表面，存在已存储的 MiniMax OAuth 时优先使用，否则回退到 MINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY 或 MINIMAX_API_KEY。配置后，用量轮询会从 models.providers.minimax-portal.baseUrl 或 models.providers.minimax.baseUrl 推导 Coding Plan 主机，否则使用 MiniMax CN 主机。MiniMax 的原始 usage_percent / usagePercent 字段表示剩余配额，因此 OpenClaw 会在显示前将其反转；存在基于计数的字段时，它们优先。
  • Coding-plan 窗口标签优先来自提供商的小时/分钟字段，存在时使用；否则回退到 start_time / end_time 时间跨度。
  • 如果 coding-plan 端点返回 model_remains，OpenClaw 会优先使用聊天模型条目，在缺少显式 window_hours / window_minutes 字段时从时间戳推导窗口标签，并在方案标签中包含模型名称。
• Xiaomi MiMo：通过环境变量/配置/凭证存储提供的 API key（XIAOMI_API_KEY）。
• z.ai：通过环境变量/配置/凭证存储提供的 API key。

当无法解析出可用的提供商用量认证时，会隐藏用量。提供商可以提供插件专用的用量认证逻辑；否则 OpenClaw 会回退到从凭证配置文件、环境变量或配置中匹配 OAuth/API-key 凭证。

# 相关

• 令牌使用和费用
• API 用量和费用
• 提示词缓存