> ## 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 ## Nội dung * Lấy trực tiếp mức sử dụng/hạn mức của nhà cung cấp từ endpoint mức sử dụng của từng nhà cung cấp. Không ước tính chi phí thanh toán của nhà cung cấp; chỉ hiển thị tên gói, khoảng thời gian hạn mức, số dư, mức chi tiêu, ngân sách, lịch sử chi phí hằng ngày, phân bổ token/mô hình hoặc bản tóm tắt trạng thái tài khoản do nhà cung cấp báo cáo. * Đầu ra khoảng thời gian hạn mức dễ đọc được chuẩn hóa thành `X% left`, ngay cả khi nhà cung cấp báo cáo hạn mức đã dùng, hạn mức còn lại hoặc chỉ số đếm thô. Các nhà cung cấp không có khoảng thời gian hạn mức có thể đặt lại sẽ hiển thị văn bản tóm tắt của nhà cung cấp thay thế (ví dụ: số dư). * `/status` ở cấp phiên và công cụ `session_status` sẽ chuyển sang dùng nhật ký bản chép lời của phiên khi ảnh chụp nhanh phiên trực tiếp thiếu dữ liệu token/mô hình. Cơ chế dự phòng này bổ sung các bộ đếm token/bộ nhớ đệm còn thiếu, có thể khôi phục nhãn mô hình runtime đang hoạt động và ưu tiên tổng số hướng đến prompt lớn hơn khi siêu dữ liệu phiên bị thiếu hoặc nhỏ hơn (`totalTokensFresh !== true`, bằng không hoặc thấp hơn giá trị suy ra từ bản chép lời). Các giá trị trực tiếp khác không luôn được ưu tiên hơn cơ chế dự phòng. ## Vị trí hiển thị * `/status` trong cuộc trò chuyện: thẻ trạng thái chứa token của phiên và chi phí ước tính (chỉ dành cho các mô hình dùng khóa API). Mức sử dụng của nhà cung cấp được hiển thị cho **nhà cung cấp mô hình hiện tại** khi có, dưới dạng khoảng thời gian `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 cuộc trò chuyện: chân trang mức sử dụng cho mỗi phản hồi. * `/usage cost` trong cuộc trò chuyện: bả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 ra bản phân tích đầy đủ về mức sử dụng/hạn mức theo từng nhà cung cấp. * CLI: `openclaw models status` liệt kê các hồ sơ xác thực OAuth/token và hiển thị bản tóm tắt khoảng thời gian sử dụng bên cạnh từng nhà cung cấp có dữ liệu này. * Giao diện điều khiển: **Mức sử dụng** hiển thị các thẻ gói và thanh toán của nhà cung cấp phía trên phần phân tích token và chi phí ước tính được suy ra từ phiên của OpenClaw. Thông tin xác thực Anthropic và OpenAI Admin API bổ sung mức chi tiêu hôm nay, trong 7 ngày và 30 ngày do nhà cung cấp báo cáo, xu hướng hằng ngày, tổng số token, các mô hình hàng đầu và danh mục chi phí. * Giao diện điều khiển: cửa sổ bật lên của vòng ngữ cảnh trong trình soạn tin nhắn trò chuyện hiển thị **mức sử dụng gói** cho các nhà cung cấp theo thuê bao — các thanh theo từng khoảng thời gian (5 giờ, hằng tuần, theo phạm vi mô hình) kèm thời điểm đặt lại, gói của nhà cung cấp khi đã biết (ví dụ: `Max (20x)`) và tín dụng sử dụng bổ sung. Các phiên được tính phí qua gói sẽ ẩn ước tính chi phí theo từng token; các phiên được tính phí qua API vẫn giữ `Est. cost` và bản phân tích chi phí theo loại. Các thiết lập Claude Code CLI (`claude-cli`) sử dụng lại cùng mức sử dụng thuê bao Anthropic. * Thanh menu macOS: mục "Mức sử dụng" cấp gốc xuất hiện bên dưới Ngữ cảnh khi có ảnh chụp nhanh mức sử dụng của nhà cung cấp. Xem [Thanh menu](/vi/platforms/mac/menu-bar). `openclaw channels list` không còn in mức sử dụng của nhà cung cấp; thay vào đó, lệnh này hướng người dùng đến `openclaw status` hoặc `openclaw models list`. ## Lịch sử chi phí Anthropic và OpenAI Hạn mức thuê bao và thanh toán API là các bề mặt khác nhau của nhà cung cấp: * Thông tin xác thực thuê bao/thiết lập Anthropic tiếp tục hiển thị các khoảng thời gian hạn mức Claude và ngân sách sử dụng bổ sung tùy chọn. Đặt `ANTHROPIC_ADMIN_KEY` hoặc `ANTHROPIC_ADMIN_API_KEY` để hiển thị lịch sử Usage and Cost API của tổ chức thay thế. Thông tin xác thực nhà cung cấp Anthropic bắt đầu bằng `sk-ant-admin` được tự động phát hiện. * OAuth OpenAI ChatGPT/Codex tiếp tục hiển thị gói, các khoảng thời gian hạn mức và số dư tín dụng. Đặt `OPENAI_ADMIN_KEY` để hiển thị lịch sử chi phí và mức sử dụng completions của tổ chức thay thế; có thể đặt `OPENAI_PROJECT_ID` để giới hạn trong một dự án. OpenClaw không bao giờ gửi thông tin xác thực suy luận từ `OPENAI_API_KEY`, cấu hình nhà cung cấp hoặc hồ sơ xác thực đến API tổ chức vì các khóa đó có thể thuộc về endpoint tùy chỉnh. Thông tin xác thực quản trị được ưu tiên vì cung cấp dữ liệu thanh toán thực tế của tổ chức. OpenClaw không kết hợp các tổng số do nhà cung cấp báo cáo này với ước tính phiên cục bộ; hai phần này được thiết kế để trả lời các câu hỏi khác nhau. ## 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ế độ này cho các phiên chưa chọn chế độ, nhờ đó chân trang có thể được bật theo mặc định mà không cần nhập `/usage` mỗi lần. Đặt một chế độ cho mọi kênh hoặc ánh xạ theo từng kênh với phương án dự phòng `default`: ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "messages": { "responseUsage": "tokens", // hoặc: { "default": "off", "discord": "full" } }, } ``` Các giá trị được chấp nhận: `"off"`, `"tokens"`, `"full"` và bí danh cũ `"on"` (được xử lý như `"tokens"`). ### 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` (không có) | Chuyển sang giá trị mặc định của cấu hình `messages.responseUsage`, rồi `off`. | | **Tắt rõ ràng** | `"off"` (được lưu) | Luôn tắt; giá trị mặc định cấu hình khác tắt không thể bật lại chân trang. | | **Bật rõ ràng** | `"tokens"` hoặc `"full"` (được lưu) | Chế độ đó, bất kể giá trị mặc định của cấu hình. | ### Thứ tự ưu tiên Chế độ hiệu lực = ghi đè của 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ị nguyên văn `"off"` trong phiên, không giống với "chưa đặt". Giá trị mặc định `messages.responseUsage` khác tắt không thể bật lại chân trang sau khi người dùng đã tắt rõ ràng. ### Đặt lại so với tắt * `/usage off` buộc tắt chân trang và lưu bền vững lựa chọn đó. Giá trị mặc định khác tắt đã cấu hình không thể ghi đè lựa chọn này. * `/usage reset` (bí danh: `default`, `inherit`, `inherited`, `clear`, `unpin`) xóa ghi đè của phiên. Sau đó, phiên sẽ **kế thừa** giá trị mặc định hiệu lực của cấu hình (`messages.responseUsage`). Nếu không cấu hình giá trị mặc định, chân trang vẫn tắt. * Việc đặt lại toàn bộ phiên (`/reset` hoặc `/new`) hay chuyển vòng phiên sẽ **giữ nguyên** tùy chọn chế độ mức 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 chuyển vòng phiên. Chỉ `/usage reset` (và các bí danh của nó) mới xóa ghi đè. ### Hành vi chuyển đổi `/usage` không có đối số sẽ luân chuyển: tắt → token → đầy đủ → tắt. Điểm bắt đầu của chu kỳ là chế độ **hiệu lực** hiện tại (ghi đè của phiên chuyển sang giá trị mặc định của cấu hình khi chưa đặt), vì vậy chu kỳ luôn khớp với nội dung người dùng hiện 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 được giữ nguyên (chân trang tắt cho đến khi dùng `/usage`). Dùng `/usage reset` để xóa ghi đè của phiên và kế thừa lại giá trị mặc định đã cấu hình. ## Chân trang `/usage full` tùy chỉnh `/usage tokens` luôn kết xuất một dòng `Usage: X in / Y out` thuần túy (cộng thêm hậu tố bộ nhớ đệm và chi phí ước tính khi có). Chỉ `/usage full` mới kết xuất chân trang phong phú hơn được mô tả bên dưới. `/usage full` hiển thị chân trang nhỏ gọn tích hợp sẵn với mô hình, suy luận, nhanh/chậm, cửa sổ ngữ cảnh và chi phí khi có các trường đó. Chân trang tích hợp sẵn không yêu cầu tệp mẫu. `messages.usageTemplate` chỉ dành cho bố cục tùy chỉnh nâng cao. Giá trị là đường dẫn tệp JSON (hỗ trợ `~`) hoặc đối tượng nội tuyến và sẽ thay thế chân trang tích hợp sẵn khi hợp lệ. Đường dẫn tệp được theo dõi và tự động tải lại trực tiếp khi có thay đổi. ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Các mẫu bị thiếu hoặc trống sẽ âm thầm chuyển sang chân trang tích hợp sẵn. Các mẫu đã cấu hình không thể đọc hoặc không hợp lệ (JSON lỗi hoặc cấu trúc không có phần đầu ra nào có thể kết xuất) cũng chuyển sang chân trang tích hợp sẵn và phát cảnh báo cho người vận hành. Bắt đầu mẫu tùy chỉnh từ cấu trúc tích hợp sẵn, sau đó chỉnh sửa 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": " | 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}", }, { "when": "cost.turn_usd", "text": " 💰{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": " | 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}", }, { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" }, ], }, }, } ``` ### Cấu trúc ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "schema": "openclaw.usageBar.v1", "scales": { "": "ký tự từ thấp đến cao" }, // chuỗi (1 ký tự/ký hiệu) hoặc mảng "aliases": { "": { "": "