Token 使用与成本

翻译自 docs.openclaw.ai

OpenClaw 跟踪的是 Token，而不是字符。Token 是模型特定的，但大多数 OpenAI 风格的模型对英文文本平均约 4 个字符为一个 Token。

系统提示是如何构建的

OpenClaw 在每次运行时组装自己的系统提示。它包括：

• 工具列表 + 简短描述
• 技能列表（仅元数据；说明通过 read 按需加载）
• 自我更新指令
• 工作区 + 引导文件（AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md，新工作区还包含 BOOTSTRAP.md）。大文件被 agents.defaults.bootstrapMaxChars（默认 20000）截断。
• 时间（UTC + 用户时区）
• 回复标签 + 心跳行为
• 运行时元数据（主机/操作系统/模型/思考模式）

完整分解请参阅 系统提示。

什么计入上下文窗口

模型接收到的所有内容都计入上下文限制：

• 系统提示（上面列出的所有部分）
• 对话历史（用户 + 助手消息）
• 工具调用和工具结果
• 附件/记录（图片、音频、文件）
• 压缩摘要和修剪产物
• 提供商包装器或安全头（不可见，但仍然计数）

要查看每个注入文件、工具、技能和系统提示大小的实际分解，请使用 /context list 或 /context detail。参见 上下文。

如何查看当前 Token 使用量

在聊天中使用这些命令：

• /status → 带表情符号的状态卡片，显示会话模型、上下文使用量、最后一次响应的输入/输出 Token，以及估算成本（仅 API 密钥）。
• /usage off|tokens|full → 在每个回复后附加使用量脚注。按会话持久化（存储为 responseUsage）。
• OAuth 认证隐藏成本（仅显示 Token）。
• /usage cost → 显示来自 OpenClaw 会话日志的本地成本摘要。

其他界面：

• TUI/Web TUI：支持 /status + /usage。
• CLI：openclaw status --usage 和 openclaw channels list 显示提供商配额窗口（不是每次响应的成本）。

成本估算（何时显示）

成本根据你的模型定价配置来估算：

models.providers.<provider>.models[].cost

这些是每 100 万个 Token 的 USD 价格，用于 input、output、cacheRead 和 cacheWrite。如果缺少定价信息，OpenClaw 仅显示 Token 数。OAuth Token 永远不显示美元成本。

缓存 TTL 和修剪影响

提供商的提示缓存仅在缓存 TTL 窗口内适用。OpenClaw 可以选择性地运行 cache-ttl 修剪：它在缓存 TTL 过期后修剪会话，然后重置缓存窗口，这样后续请求可以重用刚刚缓存的上下文，而不是重新缓存完整的历史记录。这使得会话在 TTL 过后的空闲期间，缓存写入成本更低。

在 Gateway 配置中进行配置，并参阅 会话修剪了解行为细节。

心跳可以在空闲间隙中保持缓存温暖。如果你的模型缓存 TTL 是 1 小时，将心跳间隔设置为略低于此值（例如 55 分钟）可以避免重新缓存完整提示，从而降低缓存写入成本。

示例：使用心跳保持 1 小时缓存温暖

agents:
  defaults:
    model:
      primary: "anthropic/claude-opus-4-5"
    models:
      "anthropic/claude-opus-4-5":
        params:
          cacheControlTtl: "1h"
    heartbeat:
      every: "55m"

降低 Token 压力的技巧

• 使用 /compact 来总结长会话。
• 在工作流中修剪大型工具输出。
• 保持技能描述简短（技能列表会被注入到提示中）。
• 对于冗长的探索性工作，优先使用较小的模型。

参见 技能了解精确的技能列表开销公式。