> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # 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 `/usage off|tokens|full` đặt chân trang cho một phiên và được ghi nhớ cho phiên đó. `messages.responseUsage` khởi tạo chế độ đó cho các phiên chưa chọn, để chân trang có thể bật theo mặc định mà không cần gõ `/usage` mỗi lần. Đặt một chế độ cho mọi kênh, hoặc một map theo từng kênh với dự phòng `default`: ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "messages": { "responseUsage": "tokens", // or: { "default": "off", "discord": "full" } }, } ``` ### Ba trạng thái phiên riêng biệt Trường `responseUsage` của một phiên có ba trạng thái có thể biểu diễn, mỗi trạng thái có ngữ nghĩa khác nhau: | Trạng thái | Giá trị được lưu | Chế độ hiệu lực | | ---------------------- | --------------------------------- | ------------------------------------------------------------------------- | | **Chưa đặt / kế thừa** | `undefined` (vắng mặt) | Chuyển tiếp sang mặc định cấu hình `messages.responseUsage`, rồi `off`. | | **Tắt rõ ràng** | `"off"` (đã lưu) | Luôn tắt — mặc định cấu hình không phải off không thể bật lại chân trang. | | **Bật rõ ràng** | `"tokens"` hoặc `"full"` (đã lưu) | Chế độ đó, bất kể mặc định cấu hình. | ### Thứ tự ưu tiên Chế độ hiệu lực = ghi đè phiên → mục cấu hình kênh → `default` → `off`. Một `/usage off` rõ ràng được **lưu bền vững** dưới dạng giá trị literal `"off"` trong phiên, không giống với "chưa đặt." Điều này có nghĩa là mặc định `messages.responseUsage` không phải off không thể bật lại chân trang sau khi người dùng đã tắt nó rõ ràng. ### Đặ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 `/usage` không có đối số sẽ xoay vòng: off → tokens → full → off. Điểm bắt đầu của chu kỳ là chế độ hiện tại **hiệu lực** (ghi đè phiên chuyển tiếp sang mặc định cấu hình khi chưa đặt), nên chu kỳ luôn nhất quán với những gì người dùng thấy trong chân trang. ### Cấu hình Khi không có cấu hình, hành vi trước đây vẫn giữ nguyên (chân trang tắt cho đến khi dùng `/usage`). Dùng `/usage reset` để xóa ghi đè phiên và kế thừa lại mặc định đã cấu hình. ## Chân trang `/usage full` tùy chỉnh `/usage full` hiển thị chân trang gọn tích hợp sẵn với model, reasoning, nhanh/chậm, cửa sổ context, và chi phí khi các trường đó có sẵn. Các trường token và cache vẫn có sẵn cho template tùy chỉnh. Không cần tệp template. `messages.usageTemplate` chỉ dành cho các bố cục tùy chỉnh nâng cao. Giá trị là đường dẫn tệp JSON (hỗ trợ `~`) hoặc một đối tượng inline, và nó thay thế chân trang tích hợp khi hợp lệ: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Template bị thiếu hoặc rỗng sẽ âm thầm quay về chân trang tích hợp sẵn. Template được cấu hình nhưng không đọc được hoặc không hợp lệ cũng quay về chân trang tích hợp sẵn và phát cảnh báo cho operator. Bắt đầu template tùy chỉnh từ hình dạng tích hợp sẵn, rồi chỉnh các phần bạn muốn thay đổi: ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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 ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // string (1 glyph/char) or array "aliases": { "": { "": "