OpenClaw API 用量与成本管理付费能力地图、密钥发现机制与用量可见性全景【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本文基于 OpenClaw 官方参考文档《API usage and costs》系统梳理 OpenClaw 中哪些功能会调用付费的第三方 API、每个功能从哪里读取凭证以及产生的花费在哪里可以查看。读完本文你可以准确回答三个问题OpenClaw 的哪些特性可能产生 API 账单、/status与/usage等用量报告的底层口径是什么、以及如何配置和审计本地定价以避免意外的费用。成本在哪里可见OpenClaw 提供四个层级的用量与成本视图会话级快照/status、逐消息页脚/usage、跨会话分析Control UI 的 Usage 页面以及 CLI 的供应商配额窗口。/status按会话快照展示当前会话的模型、上下文用量和上一次响应的 token 数。当 OpenClaw 拥有 usage 元数据且本地配置了当前模型的定价时会给出估算成本——这包括显式配置了价格的非 API-key 供应商例如 Bedrock 的aws-sdk模型。当实时会话快照信息稀疏时/status会从最新一条 transcript usage 记录中恢复 token/缓存计数器和活动模型标签。已存在的非零实时值优先于 transcript 数据但当存储的总值缺失或更小时按 prompt 规模计算的 transcript 总值仍会胜出。这一恢复逻辑保证了在会话状态不完整如进程重启后的场景下成本展示不至于完全断档。/usage逐消息页脚/usage full会为每条回复追加 usage 页脚在本地定价已配置且 usage 元数据可用时包含估算成本。/usage tokens只显示 token。订阅式的 OAuth/token 与 CLI 运行时默认只显示 token除非它们提供了兼容的 usage 元数据并附带显式本地价格。/usage cost打印本地成本汇总/usage off关闭页脚。Gemini CLI 注意点stream-json与旧版json输出都把 usage 放在stats下OpenClaw 会将stats.cached归一化为cacheRead并在必要时用stats.input_tokens - stats.cached推导输入 token。详细的 token 与成本展示机制包括上下文窗口构成、系统提示词组装、/context list等见 Token use and costs。Control UI → Usage跨会话分析展示所选日期范围内基于 transcript 推导的 token 与估算成本总计并按供应商、模型、agent、channel 和 token 类型分组。命名会话使用其存储的 agent owner不同 agent 下相同的 session ID 保持独立即使历史血缘lineage被归组时也是如此。会话重置后分组历史在首个新消息到达之前仍然可见。过滤与 JSON 导出会保留缺失模型价格的条目明细。对比窗口是以所选范围结束日期结尾的更短日历窗口缺失日期按零用量日历日计不会被跳过以制造更“稠密”的窗口。每日图表直接标注刻度出现√徽标表示启用了平方根压缩以保证低用量日仍然可见。重要口径这些总计描述的是本地会话历史不是供应商账单或全生命周期计费台账。当部分条目缺失定价时UI 会给出警告。CLI 用量窗口供应商配额而非逐消息成本openclaw status --usage与openclaw channels list以X% left的形式展示供应商用量窗口剩余配额。截至 2026.9.3 版本核对过支持用量窗口的供应商包括Anthropic、ClawRouter、DeepSeek、GitHub Copilot、MiniMax、OpenAI覆盖 ChatGPT/Codex 的 OAuth/token 认证、OpenRouter、Venice、xAI、Xiaomi、Xiaomi Token Plan 和 z.ai。这些快照由供应商插件提供因此新安装的插件也可以扩展该列表。完整的 provider/flag 列表见 Models CLI 与 Channels CLI。MiniMax 的原始usage_percent/usagePercent字段报告的是剩余配额OpenClaw 会将其反转存在基于计数的字段时以计数为准。若响应中包含model_remains数组OpenClaw 会挑选 chat-model 条目、在必要时从时间戳推导窗口标签并把模型名写入 plan 标签。这一行为可通过供应商插件实现验证例如 MiniMax 扩展。用量请求的凭证来自供应商专属钩子可用时否则回退到从 auth profiles、环境变量或配置中匹配 OAuth/API-key 凭证。相关参考文档中的提示截至 2026-07-05Anthropic 确认 Claude CLI 复用包括claude -p在未发布新政策前是受认可sanctioned的集成模式依赖它之前请重新核对 Anthropic 当前条款。由于 Anthropic 不暴露逐消息的美元估算/usage full无法为 Claude CLI 用量展示成本。密钥是如何被发现的OpenClaw 按以下优先级/来源发现凭证Auth profiles存储在 SQLite 中agent 本地 profile 覆盖共享的 read-through 基础库。详见 Auth credential semantics。环境变量例如OPENAI_API_KEY、BRAVE_API_KEY、FIRECRAWL_API_KEY。配置models.providers.*.apiKey、plugins.entries.*.config.webSearch.apiKey、plugins.entries.firecrawl.config.webFetch.apiKey、memory.search.*、talk.providers.*.apiKey。Skillsskills.entries.name.apiKey可能被导出到 skill 进程的环境变量中。理解这一发现顺序有助于审计当你发现某项功能产生了费用先按“auth profile → env → config → skill”的顺序排查凭证来自哪里。可能花费密钥的功能核心模型响应chat tools每条回复或工具调用都运行在当前模型供应商上这是用量和成本的主要来源。其中也包括在 OpenClaw 本地 UI 之外计费的订阅式托管计划OpenAI Codex、阿里云百炼 Coding Plan、MiniMax Coding Plan、Z.AI/GLM Coding Plan以及启用 Extra Usage 的 Anthropic Claude 登录路径。定价配置见 Models展示机制见 Token use and costs。媒体理解音频/图片/视频入站媒体在进入回复管道前可能先经供应商 API 做摘要或转写。供应商支持按插件注册随插件增减而变化当前列表与配置见 Media understanding。图像与视频生成image_generate与video_generate会路由到当前可用的已认证供应商当agents.defaults.mediaModels对应条目未设置时两者都可以推断出基于认证的供应商默认值。当前供应商列表见 Image generation 与 Video generation。记忆嵌入与语义搜索当memory.search.provider指向远程适配器例如openai、gemini、voyage、mistral、deepinfra、github-copilot、amazon-bedrock时语义记忆搜索会使用嵌入 API。memory.search.provider lmstudio或ollama针对本地/自建服务器运行通常没有托管计费memory.search.provider local完全在设备内运行无 API 用量。可选的memory.search.fallback供应商可以兜底本地嵌入失败。详见 Memory。Web 搜索工具web_search是否产生费用取决于所选供应商。每个供应商都先读环境变量再读plugins.entries.id.config.webSearch.apiKeyProviderEnv 变量Brave SearchBRAVE_API_KEYDuckDuckGo免费、非官方、基于 HTML无计费ExaEXA_API_KEYFirecrawlFIRECRAWL_API_KEYGemini (Google Search)GEMINI_API_KEYGrok (xAI)xAI OAuth profile 或XAI_API_KEYKimi (Moonshot)KIMI_API_KEY或MOONSHOT_API_KEYMiniMax SearchMINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY、MINIMAX_OAUTH_TOKEN或MINIMAX_API_KEYOllama Web Search可达的已登录本地主机免费直接https://ollama.com搜索使用OLLAMA_API_KEY受认证保护的主机复用常规 Ollama provider bearer 认证ParallelPARALLEL_API_KEYPerplexity Search APIPERPLEXITY_API_KEY或OPENROUTER_API_KEYSearXNGSEARXNG_BASE_URL免费/自建无托管计费TavilyTAVILY_API_KEY旧的tools.web.search.*配置路径仍通过兼容 shim 加载但不再推荐使用。对应实现可参考各搜索扩展如 brave 扩展、tavily 扩展。Brave Search 免费额度每个计划包含每月 $5 的续期免费额度。Search 计划价格为每 1,000 次请求 $5因此免费额度可覆盖每月 1,000 次免费请求。建议在 Brave 后台设置用量上限以避免意外扣费。更多见 Web tools。Web 抓取工具Firecrawlweb_fetch可以无 key 使用 Firecrawl 的 starter 访问添加FIRECRAWL_API_KEY或plugins.entries.firecrawl.config.webFetch.apiKey可获得更高限额。若未配置 Firecrawl工具回退为直接抓取加内置的web-readability插件无付费 API。设置plugins.entries.web-readability.enabled为禁用可跳过本地 Readability 提取。相关实现见 web-readability 扩展。供应商用量快照status/healthopenclaw status --usage与openclaw models status --json会调用供应商用量端点以展示配额窗口或认证健康。调用量很低但依然会命中供应商 API。见 Models CLI。压缩保护性摘要Compaction safeguard压缩保护机制会使用当前模型总结会话历史触发时即调用供应商 API。见 Session management and compaction。模型扫描/探测openclaw models scan探测 OpenRouter 模型时若启用探测会使用OPENROUTER_API_KEY。见 Models CLI。Talk语音Talk 模式在配置后可调用 ElevenLabsELEVENLABS_API_KEY或talk.providers.elevenlabs.apiKey。见 Talk mode实现可参考 elevenlabs 扩展。Skills第三方 APISkills 可以在skills.entries.name.apiKey中存储apiKey。若 skill 拿该 key 调用外部 API成本由该 skill 的供应商承担。见 Skills。小结与延伸阅读OpenClaw 的成本可见性设计可以概括为三条主线会话级/status快照与 transcript 回退恢复、逐消息级/usage页脚与本地定价估算、全局级Control UI 跨会话统计与 CLI 配额窗口。审计费用时建议按“密钥发现顺序”排查凭证来源再对照本文的功能清单确认哪些调用路径会产生账单。延伸阅读Token use and costsPrompt cachingUsage tracking【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考