Skip to main content

​
令牌使用与成本

OpenClaw 追踪的是令牌，而非字符。令牌是特定于模型的，但对于大多数 OpenAI 风格的模型而言，英文文本平均每 4 个字符对应 1 个令牌。

​
系统提示的构建方式

OpenClaw 在每次运行时都会组装自己的系统提示。它包含以下内容：
  • 工具列表 + 简短描述
  • 技能列表（仅包含元数据；指令按需通过 read 加载）
  • 自我更新指令
  • 工作空间 + 引导文件（INLINE_CODE_1、INLINE_CODE_2、INLINE_CODE_3、INLINE_CODE_4、INLINE_CODE_5、INLINE_CODE_6、INLINE_CODE_7，在新建会话时加载）。大文件会通过 INLINE_CODE_8 截断（默认截断长度为 20000）。
  • 时间（UTC + 用户时区）
  • 回复标签 + 心跳行为
  • 运行时元数据（主机/操作系统/模型/思考状态）
完整细分请参见 系统提示。

​
哪些内容计入上下文窗口

模型接收到的所有内容都会计入上下文限制：
  • 系统提示（上述所有部分）
  • 对话历史（用户和助手消息）
  • 工具调用及工具结果
  • 附件/转录文件（图像、音频、文件）
  • 压缩摘要和修剪生成的内容
  • 提供商封装器或安全标头（不可见，但仍计入）
如需按注入文件、工具、技能和系统提示大小进行实际细分，请使用 /context list 或 /context detail。更多信息请参见 上下文。

​
如何查看当前令牌使用情况

在聊天中可使用以下命令：
  • /status → 显示带有会话模型、上下文使用情况、上次回复的输入/输出令牌以及预估成本的丰富表情符号状态卡（仅适用于提供 API 密钥的用户）。
  • /usage off|tokens|full → 在每条回复后附加一个每条回复的使用量页脚。
    • 持久保存在会话中（存储为 responseUsage）。
    • OAuth 身份验证会隐藏成本（仅显示令牌数量）。
  • /usage cost → 从 OpenClaw 会话日志中显示本地成本汇总。
其他界面支持：
  • TUI/Web TUI： 支持 /status 和 /usage。
  • CLI： openclaw status --usage 和 openclaw channels list 显示提供商配额窗口（不显示每条回复的成本）。
成本估算（何时显示） 成本根据您的模型定价配置估算： 
models.providers.<provider>.models[].cost
这些是针对 input、output、cacheRead 和 cacheWrite 的每100万令牌的美元价格。如果缺少定价信息，OpenClaw 将仅显示代币数量。OAuth 代币始终不显示美元成本。 缓存TTL与修剪的影响 提供商的提示缓存仅在缓存TTL窗口期内有效。OpenClaw可选择启用“缓存TTL修剪”：当缓存TTL到期后，系统会修剪会话并重置缓存窗口，以便后续请求可以重新使用新缓存的上下文，而无需重新缓存整个历史记录。这样一来，当会话空闲时间超过TTL时，缓存写入的成本就会显著降低。 您可以在网关配置中进行相关设置，并在会话修剪中查看详细行为。 心跳功能可在空闲期间使缓存保持“温暖”状态。如果您的模型缓存 TTL 是 1h，将心跳间隔设置为略低于 TTL（例如 55m），即可避免重新缓存完整提示，从而降低缓存写入成本。 对于 Anthropic API 的定价，缓存读取的成本远低于输入令牌的成本，而缓存写入则按更高的倍数收费。有关最新费率和 TTL 倍数，请参阅 Anthropic 的提示缓存定价： https://docs.anthropic.com/docs/build-with-claude/prompt-caching

​
示例：通过心跳保持1小时缓存“温暖”

agents:
  defaults:
    model:
      primary: "anthropic/claude-opus-4-5"
    models:
      "anthropic/claude-opus-4-5":
        params:
          cacheControlTtl: "1h"
    heartbeat:
      every: "55m"
减轻令牌压力的技巧
  • 使用 /compact 总结长时间会话。
  • 在工作流中裁剪大型工具的输出。
  • 保持技能描述简短（技能列表会被注入到提示中）。
  • 在需要大量文本的探索性任务中优先选择较小的模型。
有关确切的技能列表开销公式，请参见 技能。