Theo dõi mức sử dụng

​

Đây là gì

• Lấy mức sử dụng/hạn mức của nhà cung cấp trực tiếp từ các endpoint sử dụng của họ.
• Không có chi phí ước tính; chỉ có các khoảng hạn mức hoặc tóm tắt trạng thái tài khoản do nhà cung cấp báo cáo.
• Đầu ra trạng thái khoảng hạn mức dễ đọc cho con người được chuẩn hóa thành X% left, ngay cả khi API thượng nguồn báo cáo hạn mức đã dùng, hạn mức còn lại, hoặc chỉ các số đếm thô. Các nhà cung cấp không có khoảng hạn mức có thể đặt lại có thể hiển thị văn bản tóm tắt của nhà cung cấp thay thế, chẳng hạn như số dư.
• /status cấp phiên và session_status có thể dùng mục sử dụng transcript mới nhất làm dự phòng khi snapshot phiên trực tiếp còn thưa dữ liệu. Dự phòng đó điền các bộ đếm token/cache còn thiếu, có thể khôi phục nhãn model runtime đang hoạt động, và ưu tiên tổng lớn hơn theo hướng prompt khi siêu dữ liệu phiên bị thiếu hoặc nhỏ hơn. Các giá trị trực tiếp khác không bằng 0 hiện có vẫn được ưu tiên.

​

Nơi nó xuất hiện

• /status trong các cuộc trò chuyện: thẻ trạng thái nhiều emoji với token phiên + chi phí ước tính (chỉ API key). Mức sử dụng của nhà cung cấp hiển thị cho nhà cung cấp model hiện tại khi có sẵn dưới dạng khoảng X% left đã chuẩn hóa hoặc văn bản tóm tắt của nhà cung cấp.
• /usage off|tokens|full trong các cuộc trò chuyện: phần chân trang mức sử dụng theo từng phản hồi.
• /usage cost trong các cuộc trò chuyện: tóm tắt chi phí cục bộ được tổng hợp từ nhật ký phiên OpenClaw.
• CLI: openclaw status --usage in bảng phân tích đầy đủ theo từng nhà cung cấp.
• CLI: openclaw channels list in cùng snapshot mức sử dụng bên cạnh cấu hình nhà cung cấp (dùng --no-usage để bỏ qua).
• Thanh menu macOS: mục “Usage” trong Context (chỉ khi có sẵn).

​

Chế độ chân trang mức sử dụng mặc định

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

​

Ba trạng thái phiên riêng biệt

​

Thứ tự ưu tiên

​

Đặt lại so với tắt

• /usage off — buộc tắt chân trang và lưu lựa chọn đó. Mặc định được cấu hình không phải off không thể ghi đè điều này.
• /usage reset (bí danh: inherit, clear, default) — xóa ghi đè phiên. Sau đó phiên kế thừa mặc định cấu hình hiệu lực (messages.responseUsage). Nếu không có mặc định được cấu hình, chân trang sẽ tắt (không đổi so với trước). Dùng lệnh này để “quay lại mặc định” mà không bật chân trang một cách rõ ràng.
• Việc đặt lại toàn bộ phiên (/reset hoặc /new) hoặc rollover phiên giữ nguyên tùy chọn chế độ sử dụng rõ ràng để lựa chọn hiển thị của người dùng tồn tại qua các lần rollover phiên. Chỉ /usage reset (và các bí danh của nó) mới thực sự xóa ghi đè.

​

Hành vi chuyển đổi

​

Cấu hình

​

Chân trang /usage full tùy chỉnh

{
  "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": "\u00A0| 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
      },
      { "when": "cost.turn_usd", "text": "\u00A0💰{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": "\u00A0| 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
        },
        { "when": "cost.turn_usd", "text": "\u00A0💰{cost.turn_usd|fixed:4}" },
      ],
    },
  },
}

​

Hình dạng

{
  "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 */
      ],
    },
  },
}

​

Đường dẫn hợp đồng

​

Động từ

​

Dạng mảnh

• { "text": "📚 {context.max_tokens|num}" }: literal + nội suy.
• { "when": "<path>", "text": "..." }: chỉ render nếu đường dẫn là truthy.
• { "map": "<path>", "cases": { "true": "⚡", "false": "🐌" } }: ánh xạ giá trị sang glyph.
• { "each": "limits.windows", "item": "{label}" }: lặp qua một mảng.

​

Ví dụ

{
  "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}",
        },
      ],
    },
  },
}

​

Nhà cung cấp + thông tin xác thực

• Anthropic (Claude): Token OAuth trong hồ sơ xác thực.
• GitHub Copilot: Token OAuth trong hồ sơ xác thực.
• Gemini CLI: Token OAuth trong hồ sơ xác thực.
  • Mức sử dụng JSON quay về stats; stats.cached được chuẩn hóa thành cacheRead.
• OpenAI Codex: Token OAuth trong hồ sơ xác thực (accountId được dùng khi có).
• MiniMax: Khóa API hoặc hồ sơ xác thực OAuth của MiniMax. OpenClaw coi minimax, minimax-cn, và minimax-portal là cùng một bề mặt hạn mức MiniMax, ưu tiên OAuth MiniMax đã lưu khi có, và nếu không thì quay về MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, hoặc MINIMAX_API_KEY. Việc thăm dò mức sử dụng lấy máy chủ Coding Plan từ models.providers.minimax-portal.baseUrl hoặc models.providers.minimax.baseUrl khi được cấu hình, và nếu không thì dùng máy chủ MiniMax CN. Các trường thô usage_percent / usagePercent của MiniMax biểu thị hạn mức còn lại, nên OpenClaw đảo ngược chúng trước khi hiển thị; các trường dựa trên số lượng được ưu tiên khi có.
  • Nhãn cửa sổ coding-plan đến từ các trường giờ/phút của provider khi có, rồi quay về khoảng start_time / end_time.
  • Nếu endpoint coding-plan trả về model_remains, OpenClaw ưu tiên mục chat-model, suy ra nhãn cửa sổ từ dấu thời gian khi không có các trường window_hours / window_minutes rõ ràng, và đưa tên mô hình vào nhãn gói.
• Xiaomi MiMo: Khóa API qua env/config/kho xác thực (XIAOMI_API_KEY).
• z.ai: Khóa API qua env/config/kho xác thực.
• DeepSeek: Khóa API qua env/config/kho xác thực (DEEPSEEK_API_KEY). OpenClaw gọi endpoint số dư của DeepSeek và hiển thị số dư do provider báo cáo dưới dạng văn bản thay vì cửa sổ hạn mức phần trăm còn lại.

​

Liên quan

• Mức dùng token và chi phí
• Mức sử dụng API và chi phí
• Lưu bộ nhớ đệm prompt