使用情况跟踪

​

它是什么

• 直接从每个提供商的用量端点拉取提供商用量/配额。不估算提供商计费；只使用提供商报告的方案名称、配额窗口、余额、支出、预算、每日成本历史、token/模型归因或账号状态摘要。
• 人类可读的配额窗口输出会归一化为 X% left，即使提供商报告的是已消耗配额、剩余配额，或仅报告原始计数。没有可重置配额窗口的提供商会改为显示提供商摘要文本（例如余额）。
• 会话级 /status 和 session_status 工具会在实时会话快照缺少 token/模型数据时回退到该会话的转录日志。该回退会填补缺失的 token/缓存计数器，可以恢复活跃运行时模型标签，并在会话元数据缺失或更小（totalTokensFresh !== true、为零，或低于从转录推导的值）时优先使用更大的面向提示词的总数。非零实时值始终优先于回退值。

​

显示位置

• 聊天中的 /status：状态卡片，包含会话 token 和预估成本（仅 API key 模型）。提供商用量会在可用时针对当前模型提供商显示，形式为归一化的 X% left 窗口或提供商摘要文本。
• 聊天中的 /usage off|tokens|full：每次响应的用量页脚。
• 聊天中的 /usage cost：从 OpenClaw 会话日志聚合的本地成本摘要。
• CLI：openclaw status --usage 打印完整的逐提供商用量/配额明细。
• CLI：openclaw models status 列出 OAuth/token 凭证配置文件，并在每个有用量窗口的提供商旁显示用量窗口摘要。
• Control UI：用量 在 OpenClaw 从会话推导的 token 和预估成本分析上方显示提供商方案与计费卡片。Anthropic 和 OpenAI Admin API 凭证会添加提供商报告的今日、7 日和 30 日支出、每日趋势、token 总量、热门模型和成本类别。
• macOS 菜单栏：当提供商用量快照可用时，根级“用量”部分会显示在上下文下方。参见菜单栏。

​

Anthropic 和 OpenAI 成本历史

• Anthropic 订阅/设置凭证继续显示 Claude 配额窗口和可选的额外用量预算。设置 ANTHROPIC_ADMIN_KEY 或 ANTHROPIC_ADMIN_API_KEY 可改为显示组织 Usage and Cost API 历史。以 sk-ant-admin 开头的 Anthropic 提供商凭证会被自动检测。
• OpenAI ChatGPT/Codex OAuth 继续显示方案、配额窗口和信用余额。设置 OPENAI_ADMIN_KEY 可改为显示组织成本和 completions 用量历史；也可设置 OPENAI_PROJECT_ID 将范围限定到一个项目。OpenClaw 绝不会把来自 OPENAI_API_KEY、提供商配置或凭证配置文件的推理凭证发送到组织 API，因为这些 key 可能属于自定义端点。

​

默认用量页脚模式

{
  "messages": {
    "responseUsage": "tokens",
    // or: { "default": "off", "discord": "full" }
  },
}

​

三种不同的会话状态

​

优先级

​

重置与关闭

• /usage off 强制关闭页脚并持久化该选择。已配置的非 off 默认值不能覆盖它。
• /usage reset（别名：default、inherit、inherited、clear、unpin）清除会话覆盖。随后该会话会继承生效的配置默认值（messages.responseUsage）。如果未配置默认值，页脚保持关闭。
• 完整会话重置（/reset 或 /new）或会话滚动会保留显式用量模式偏好，因此用户的显示选择会跨会话滚动保留。只有 /usage reset（及其别名）会清除覆盖。

​

切换行为

​

配置

​

自定义 /usage full 页脚

{
  "messages": {
    "usageTemplate": "~/.openclaw/usage-footer.json"
  }
}

{
  "schema": "openclaw.usageBar.v1",
  "scales": {
    "braille": "⠐⡀⡄⡆⡇⣇⣧⣷⣿",
    "block": "░▏▎▍▌▋▊▉█",
    "shade": "░▒▓█",
    "moon": "🌑🌘🌗🌖🌕",
    "level": "▁▂▃▄▅▆▇█",
    "weather": ["🥶", "☁️", "🌥", "⛅️", "🌤", "☀️"],
    "plants": ["🪾", "🍂", "🌱", "☘️", "🍀", "🌿"],
    "moons6": ["🌑", "🌚", "🌘", "🌗", "🌖", "🌝"],
  },
  "aliases": {
    "models": {
      "claude-opus-4-6": "opus46",
      "claude-opus-4-8": "opus48",
      "claude-sonnet-4-6": "sonnet46",
      "claude-haiku-4-5": "haiku45",
      "gpt-5.5": "gpt5.5",
    },
    "reasoning": {
      "off": "🌑",
      "minimal": "🌚",
      "low": "🌘",
      "medium": "🌗",
      "high": "🌕",
      "xhigh": "🌝",
    },
  },
  "output": {
    "sep": "",
    "default": [
      { "text": "{model.provider}{identity.emoji|🤖}{model.display_name|alias:models}" },
      { "map": "model.is_fallback", "cases": { "true": "🔄" } },
      { "map": "model.is_override", "cases": { "true": "📌" } },
      { "when": "model.reasoning", "text": "{model.reasoning|alias:reasoning}" },
      { "map": "state.fast_mode", "cases": { "true": "⚡️", "false": "🐌" } },
      {
        "when": "context.max_tokens",
        "text": " | 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
      },
      { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" },
    ],
    "surfaces": {
      "discord": [
        { "text": "-# -\n" },
        { "text": "-# {model.provider}{identity.emoji|🤖}{model.display_name|alias:models}" },
        { "map": "model.is_fallback", "cases": { "true": "🔄" } },
        { "map": "model.is_override", "cases": { "true": "📌" } },
        { "when": "model.reasoning", "text": "{model.reasoning|alias:reasoning}" },
        { "map": "state.fast_mode", "cases": { "true": "⚡️", "false": "🐌" } },
        {
          "when": "context.max_tokens",
          "text": " | 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
        },
        { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" },
      ],
    },
  },
}

​

形状

{
  "schema": "openclaw.usageBar.v1",
  "scales": { "<name>": "low-to-high glyphs" }, // string (1 glyph/char) or array
  "aliases": { "<table>": { "<value>": "<label>" } },
  "output": {
    "sep": "", // joins surviving pieces
    "default": [
      /* pieces */
    ], // fallback for any surface
    "surfaces": {
      "discord": [
        /* pieces */
      ],
      "telegram": [
        /* pieces */
      ],
    },
  },
}

​

合约路径

​

动词

​

片段形式

• { "text": "📚 {context.max_tokens|num}" }：字面量 + 插值。
• { "when": "<path>", "text": "..." }：仅当路径为真值时渲染。
• { "map": "<path>", "cases": { "true": "⚡", "false": "🐌" } }：值到字形的映射（_default case 覆盖未匹配的值）。
• { "each": "<array-path>", "item": "{label}" }：迭代数组值路径（当前没有契约路径是数组）。

​

示例

{
  "schema": "openclaw.usageBar.v1",
  "scales": { "braille": "⠐⡀⡄⡆⡇⣇⣧⣷⣿" },
  "aliases": { "reasoning": { "medium": "🌗", "high": "🌕" } },
  "output": {
    "surfaces": {
      "discord": [
        { "text": "{model.display_name}" },
        { "when": "model.reasoning", "text": " {model.reasoning|alias:reasoning}" },
        { "map": "state.fast_mode", "cases": { "true": " ⚡", "false": " 🐌" } },
        {
          "when": "context.max_tokens",
          "text": " | 📚 [{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
        },
      ],
    },
  },
}

​

提供商 + 凭证

• Anthropic（Claude）：auth profile 中的 OAuth token。如果 OAuth token 缺少 user:profile scope，则在已设置时 fallback 到 claude.ai web session（CLAUDE_AI_SESSION_KEY、 CLAUDE_WEB_SESSION_KEY，或 CLAUDE_WEB_COOKIE 中的 sessionKey= cookie）。 当 Anthropic 返回时，会包含 model 级别限制和已启用的额外用量月度支出/预算。 显式 Anthropic Admin API key，或 自动检测到的 sk-ant-admin... provider profile，则会改为显示 30 天 组织成本和 Messages API 历史。
• ClawRouter：API key（CLAWROUTER_API_KEY）。配置后显示月度预算窗口 和类型化 USD 预算；否则显示聚合支出以及 请求/token/成本摘要。
• DeepSeek：通过环境变量/配置/auth store 获取 API key（DEEPSEEK_API_KEY）。 显示每个 provider 返回的币种余额。
• GitHub Copilot：auth profile 中的 OAuth token。
• Gemini CLI：auth profile 中的 OAuth token。
• MiniMax：API key 或 MiniMax OAuth auth profile。OpenClaw 将 minimax、minimax-cn 和 minimax-portal 视为同一个 MiniMax 配额 表面，存在已存储的 MiniMax OAuth 时优先使用，否则 fallback 到 MINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY 或 MINIMAX_API_KEY。 用量轮询会在配置了 models.providers.minimax-portal.baseUrl 或 models.providers.minimax.baseUrl 时从中派生 Coding Plan host，否则使用 MiniMax CN host。 MiniMax 的原始 usage_percent / usagePercent 字段表示剩余 配额，因此 OpenClaw 会在显示前将其反转；存在基于计数的字段时 优先使用。
  • 窗口标签优先来自 provider 的小时/分钟字段（如果存在），然后 fallback 到 start_time / end_time 时间跨度。
  • 如果 coding-plan 端点返回 model_remains，OpenClaw 会优先选择 chat-model 条目，在缺少显式 window_hours / window_minutes 字段时从时间戳派生窗口标签，并在计划标签中包含 model 名称。
• OpenAI（Codex/ChatGPT 计划）：auth profile 中的 OAuth token（存在 account id 时发送 ChatGPT-Account-Id header）。显示 ChatGPT 计划、可重置的 Codex 窗口，以及返回时的 credit 余额。Credit 仍是 provider credit；OpenClaw 不会将其标记为美元。OPENAI_ADMIN_KEY 会在 key 拥有 Usage Dashboard 访问权限时添加 30 天组织成本和 completions-usage 历史。 推理凭证绝不会转发到组织 API。
• OpenRouter：API key 或 OAuth 支持的 API key（OPENROUTER_API_KEY 或 auth profile）。将账户 credit 端点与 key 配额端点合并， 因此在凭证可访问时会显示账户余额/支出、key 预算以及每日/每周/每月用量。 任一端点都可以独立丰富快照。
• Venice：通过环境变量/配置/auth store 获取 API key（VENICE_API_KEY）。显示 USD 和 DIEM 余额，以及返回时的 DIEM epoch allocation 用量。
• Xiaomi MiMo：两个独立的用量表面。按量付费用 API key （XIAOMI_API_KEY）；Token Plan 使用单独的 key（XIAOMI_TOKEN_PLAN_API_KEY）。 两者目前都不返回配额窗口。
• z.ai：通过环境变量/配置/auth store 获取 API key（ZAI_API_KEY 或 Z_AI_API_KEY）。

​

相关

• Token 使用和成本
• API 用量和成本
• Prompt caching
• 菜单栏