Documentation Index
Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt
Use this file to discover all available pages before exploring further.
它是什么
- 直接从提供方的使用量/配额端点拉取数据。
- 不估算成本;只使用提供方报告的窗口。
- 人类可读的状态输出会标准化为
X% left,即使上游 API 报告的是已消耗配额、剩余配额,或者仅仅是原始计数。 - 会话级
/status和session_status在实时会话快照信息稀疏时,可以回退到最近的 transcript 使用条目。该回退会补全缺失的 token/cache 计数,能够恢复活动运行时模型标签,并且在会话元数据缺失或更小时,优先选择更大的、面向 prompt 的总数。现有的非零实时值仍然优先。
显示位置
- 聊天中的
/status:带 emoji 的状态卡,显示会话 token + 预估成本(仅 API key)。在可用时,提供方使用情况会以标准化的X% left窗口显示给 当前模型提供方。 - 聊天中的
/usage off|tokens|full:每次响应的使用情况页脚(OAuth 仅显示 token)。 - 聊天中的
/usage cost:从 OpenClaw 会话日志聚合得出的本地成本摘要。 - CLI:
openclaw status --usage将打印完整的按提供方拆分情况。 - CLI:
openclaw channels list会在提供方配置旁边打印相同的使用情况快照(使用--no-usage可跳过)。 - macOS 菜单栏:Context 下的“Usage”部分(仅在可用时)。
提供方 + 凭据
- Anthropic (Claude): auth profiles 中的 OAuth 令牌。
- GitHub Copilot: auth profiles 中的 OAuth 令牌。
- Gemini CLI: auth profiles 中的 OAuth 令牌。
- JSON 使用情况会回退到
stats;stats.cached会被规范化为cacheRead。
- JSON 使用情况会回退到
- OpenAI Codex: auth profiles 中的 OAuth 令牌(在存在时使用 accountId)。
- MiniMax: 通过 env/config/auth store 使用 API key 或 MiniMax OAuth auth profile。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 窗口标签在存在时取自提供方的 hours/minutes 字段,
然后再回退到
start_time/end_time区间。 - 如果 coding-plan 端点返回
model_remains,OpenClaw 会优先选择 chat-model 条目;当显式的window_hours/window_minutes字段缺失时,会根据时间戳推导窗口标签,并在计划标签中包含模型 名称。
- Coding-plan 窗口标签在存在时取自提供方的 hours/minutes 字段,
然后再回退到
- Xiaomi MiMo: 通过 env/config/auth store 提供的 API key(
XIAOMI_API_KEY)。 - z.ai: 通过 env/config/auth store 提供的 API key。