--- read_when: - Bạn đang kết nối các giao diện hiển thị mức sử dụng/hạn ngạch của nhà cung cấp - Bạn cần giải thích hành vi theo dõi mức sử dụng hoặc các yêu cầu xác thực summary: Các giao diện theo dõi mức sử dụng và yêu cầu về thông tin xác thực title: Theo dõi mức sử dụng x-i18n: generated_at: "2026-07-12T07:53:49Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: c413dcbe838d94c57ba3f6ef9609331e139de6d0abbdb3860753a519bd490314 source_path: concepts/usage-tracking.md workflow: 16 --- ## Đây là gì - Lấy trực tiếp mức sử dụng/hạn mức của nhà cung cấp từ endpoint sử dụng của từng nhà cung cấp. Không ước tính hóa đơ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ổ theo 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 `còn X%`, 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` dùng dự phò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 đó điền các bộ đếm token/bộ nhớ đệm còn thiếu, có thể khôi phục nhãn mô hình thời gian chạy đang hoạt động và ưu tiên tổng số lớn hơn theo hướng prompt 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. ## Xuất hiện ở đâu - `/status` trong cuộc trò chuyện: thẻ trạng thái có số token của phiên và chi phí ước tính (chỉ với 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ó sẵn, dưới dạng khoảng thời gian `còn X%` đã 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ảng 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ê 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 mỗi 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à hóa đơn của nhà cung cấp phía trên phần phân tích token và chi phí ước tính do OpenClaw suy ra từ phiên. Thông tin xác thực API quản trị của Anthropic và OpenAI 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à các danh mục chi phí. - Giao diện điều khiển: cửa sổ bật lên 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) cùng thời gian đặ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 token; các phiên được tính phí qua API vẫn giữ `Chi phí ước tính` và bảng phân tích chi phí theo loại. Các thiết lập CLI Claude Code (`claude-cli`) sử dụng lại cùng dữ liệu mức sử dụng thuê bao Anthropic. - Thanh menu macOS: mục gốc "Mức sử dụng" 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à hóa đơn API là hai 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ử API Mức sử dụng và Chi phí của tổ chức. 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 lượt hoàn thành của tổ chức; tùy chọn đặ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 các API tổ chức vì những 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 hóa đơ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 chủ ý 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à lựa chọn này đượ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 một ánh xạ theo từng kênh với phương án dự phòng `default`: ```jsonc { "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ế độ có hiệu lực | | -------------------------- | ------------------------------- | --------------------------------------------------------------------------------- | | **Chưa đặt / kế thừa** | `undefined` (không có) | Chuyển tiếp đến mặc định cấu hình `messages.responseUsage`, sau đó là `off`. | | **Tắt rõ ràng** | `"off"` (được lưu) | Luôn tắt; mặc định cấu hình khác `off` 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ể mặc định cấu hình. | ### Thứ tự ưu tiên Chế độ có hiệu lực = ghi đè của phiên → mục cấu hình kênh → `default` → `off`. Lệnh `/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 trạng thái "chưa đặt". Mặc định `messages.responseUsage` khác `off` không thể bật lại chân trang sau khi người dùng đã tắt rõ ràng. ### Đặt lại và tắt - `/usage off` buộc tắt chân trang và lưu bền vững lựa chọn đó. Mặc định khác `off` đã cấu hình không thể ghi đè lựa chọn này. - `/usage reset` (các bí danh: `default`, `inherit`, `inherited`, `clear`, `unpin`) xóa ghi đè của phiên. Sau đó, phiên **kế thừa** mặc định cấu hình có hiệu lực (`messages.responseUsage`). Nếu không cấu hình 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 được duy trì 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ẽ tuần tự chuyển đổi: tắt → token → đầy đủ → tắt. Điểm bắt đầu của chu kỳ là chế độ hiện tại **có hiệu lực** (ghi đè của phiên chuyển tiếp đến mặc định 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 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 thuần túy `Mức sử dụng: X vào / Y ra` (cùng các hậu tố bộ nhớ đệm và chi phí ước tính khi có). Chỉ `/usage full` 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, mức suy luận, nhanh/chậm, cửa sổ ngữ cảnh và chi phí khi các trường đó có sẵn. 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ải lại trực tiếp khi có thay đổi. ```json { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Mẫu bị thiếu hoặc rỗng sẽ âm thầm dùng chân trang tích hợp sẵn làm phương án dự phòng. Mẫu đã cấu hình nhưng 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 sẽ dùng chân trang tích hợp sẵn làm phương án dự phòng và phát cảnh báo cho người vận hành. Hãy 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 { "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 { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // chuỗi (1 ký hiệu/ký tự) hoặc mảng "aliases": { "": { "": "