Mức sử dụng API & chi phí

Tài liệu này liệt kê các tính năng có thể gọi khóa API và nơi chi phí của chúng xuất hiện. Tài liệu tập trung vào các tính năng OpenClaw có thể tạo mức sử dụng nhà cung cấp hoặc các lệnh gọi API có trả phí.

Nơi chi phí xuất hiện (chat + CLI)

Ảnh chụp chi phí theo phiên

/status hiển thị mô hình phiên hiện tại, mức sử dụng ngữ cảnh và token của phản hồi gần nhất.
Nếu mô hình dùng xác thực bằng khóa API, /status cũng hiển thị chi phí ước tính cho phản hồi gần nhất.
Nếu siêu dữ liệu phiên trực tiếp còn thưa, /status có thể khôi phục bộ đếm token/cache và nhãn mô hình runtime đang hoạt động từ mục mức sử dụng transcript mới nhất. Các giá trị trực tiếp khác 0 hiện có vẫn được ưu tiên, và tổng transcript theo kích thước prompt có thể thắng khi tổng đã lưu bị thiếu hoặc nhỏ hơn.

Chân trang chi phí theo tin nhắn

/usage full thêm chân trang mức sử dụng vào mọi phản hồi, bao gồm chi phí ước tính (chỉ khóa API).
/usage tokens chỉ hiển thị token; các luồng OAuth/token kiểu đăng ký và CLI ẩn chi phí bằng tiền.
Ghi chú Gemini CLI: khi CLI trả về đầu ra JSON, OpenClaw đọc mức sử dụng từ stats, chuẩn hóa stats.cached thành cacheRead, và suy ra token đầu vào từ stats.input_tokens - stats.cached khi cần.

Ghi chú Anthropic: Nhân viên Anthropic đã cho chúng tôi biết rằng mức sử dụng Claude CLI kiểu OpenClaw đã được cho phép trở lại, vì vậy OpenClaw xem việc tái sử dụng Claude CLI và mức sử dụng claude -p là được phê chuẩn cho tích hợp này, trừ khi Anthropic công bố chính sách mới. Anthropic vẫn không cung cấp ước tính chi phí bằng tiền theo từng tin nhắn mà OpenClaw có thể hiển thị trong /usage full. Cửa sổ mức sử dụng CLI (hạn mức nhà cung cấp)

openclaw status --usage và openclaw channels list hiển thị cửa sổ mức sử dụng của nhà cung cấp (ảnh chụp hạn mức, không phải chi phí theo từng tin nhắn).
Đầu ra cho người dùng được chuẩn hóa thành X% left trên các nhà cung cấp.
Các nhà cung cấp cửa sổ mức sử dụng hiện tại: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi và z.ai.
Ghi chú MiniMax: các trường thô usage_percent / usagePercent của nó nghĩa là hạn mức còn lại, vì vậy OpenClaw đảo ngược chúng trước khi hiển thị. Các trường dựa trên số lượng vẫn được ưu tiên khi có mặt. Nếu nhà cung cấp trả về model_remains, OpenClaw ưu tiên mục mô hình chat, suy ra nhãn cửa sổ từ dấu thời gian khi cần, và đưa tên mô hình vào nhãn gói.
Xác thực mức sử dụng cho các cửa sổ hạn mức đó đến từ hook riêng của nhà cung cấp khi có sẵn; nếu không, OpenClaw quay về dùng thông tin đăng nhập OAuth/khóa API khớp từ hồ sơ xác thực, env hoặc config.

Xem Mức dùng token & chi phí để biết chi tiết và ví dụ.

Cách khóa được phát hiện

OpenClaw có thể nhận thông tin đăng nhập từ:

Hồ sơ xác thực (theo agent, được lưu trong auth-profiles.json).
Biến môi trường (ví dụ: OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY).
Config (models.providers.*.apiKey, plugins.entries.*.config.webSearch.apiKey, plugins.entries.firecrawl.config.webFetch.apiKey, memorySearch.*, talk.providers.*.apiKey).
Skills (skills.entries.<name>.apiKey) có thể xuất khóa sang env của tiến trình skill.

Các tính năng có thể tiêu tốn khóa

1) Phản hồi mô hình lõi (chat + công cụ)

Mọi phản hồi hoặc lệnh gọi công cụ đều dùng nhà cung cấp mô hình hiện tại (OpenAI, Anthropic, v.v.). Đây là nguồn mức sử dụng và chi phí chính. Điều này cũng bao gồm các nhà cung cấp hosted kiểu đăng ký vẫn tính phí bên ngoài UI cục bộ của OpenClaw, chẳng hạn như OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI / GLM Coding Plan, và đường dẫn đăng nhập Claude của OpenClaw thuộc Anthropic với Extra Usage được bật. Xem Mô hình để biết config giá và Mức dùng token & chi phí để biết cách hiển thị.

2) Hiểu media (âm thanh/hình ảnh/video)

Media đầu vào có thể được tóm tắt/phiên âm trước khi phản hồi chạy. Việc này dùng API mô hình/nhà cung cấp.

Âm thanh: OpenAI / Groq / Deepgram / DeepInfra / Google / Mistral.
Hình ảnh: OpenAI / OpenRouter / Anthropic / DeepInfra / Google / MiniMax / Moonshot / Qwen / Z.AI.
Video: Google / Qwen / Moonshot.

Xem Hiểu media.

3) Tạo hình ảnh và video

Các khả năng tạo dùng chung cũng có thể tiêu tốn khóa nhà cung cấp:

Tạo hình ảnh: OpenAI / Google / DeepInfra / fal / MiniMax
Tạo video: DeepInfra / Qwen

Tạo hình ảnh có thể suy ra mặc định nhà cung cấp có hỗ trợ xác thực khi agents.defaults.imageGenerationModel chưa được đặt. Tạo video hiện yêu cầu một agents.defaults.videoGenerationModel rõ ràng, chẳng hạn như qwen/wan2.6-t2v. Xem Tạo hình ảnh, Qwen Cloud, và Mô hình.

4) Embedding bộ nhớ + tìm kiếm ngữ nghĩa

Tìm kiếm bộ nhớ ngữ nghĩa dùng API embedding khi được cấu hình cho nhà cung cấp từ xa:

memorySearch.provider = "openai" → embedding OpenAI
memorySearch.provider = "gemini" → embedding Gemini
memorySearch.provider = "voyage" → embedding Voyage
memorySearch.provider = "mistral" → embedding Mistral
memorySearch.provider = "deepinfra" → embedding DeepInfra
memorySearch.provider = "lmstudio" → embedding LM Studio (cục bộ/tự host)
memorySearch.provider = "ollama" → embedding Ollama (cục bộ/tự host; thường không có tính phí API hosted)
Tùy chọn fallback sang nhà cung cấp từ xa nếu embedding cục bộ thất bại

Bạn có thể giữ nó cục bộ bằng memorySearch.provider = "local" (không dùng API). Xem Bộ nhớ.

5) Công cụ tìm kiếm web

web_search có thể phát sinh phí sử dụng tùy theo nhà cung cấp của bạn:

Brave Search API: BRAVE_API_KEY hoặc plugins.entries.brave.config.webSearch.apiKey
Exa: EXA_API_KEY hoặc plugins.entries.exa.config.webSearch.apiKey
Firecrawl: FIRECRAWL_API_KEY hoặc plugins.entries.firecrawl.config.webSearch.apiKey
Gemini (Google Search): GEMINI_API_KEY hoặc plugins.entries.google.config.webSearch.apiKey
Grok (xAI): XAI_API_KEY hoặc plugins.entries.xai.config.webSearch.apiKey
Kimi (Moonshot): KIMI_API_KEY, MOONSHOT_API_KEY, hoặc plugins.entries.moonshot.config.webSearch.apiKey
MiniMax Search: MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, MINIMAX_API_KEY, hoặc plugins.entries.minimax.config.webSearch.apiKey
Ollama Web Search: không cần khóa cho host Ollama cục bộ có thể truy cập và đã đăng nhập; tìm kiếm trực tiếp https://ollama.com dùng OLLAMA_API_KEY, và các host được bảo vệ bằng xác thực có thể tái sử dụng xác thực bearer thông thường của nhà cung cấp Ollama
Perplexity Search API: PERPLEXITY_API_KEY, OPENROUTER_API_KEY, hoặc plugins.entries.perplexity.config.webSearch.apiKey
Tavily: TAVILY_API_KEY hoặc plugins.entries.tavily.config.webSearch.apiKey
DuckDuckGo: fallback không cần khóa (không tính phí API, nhưng không chính thức và dựa trên HTML)
SearXNG: SEARXNG_BASE_URL hoặc plugins.entries.searxng.config.webSearch.baseUrl (không cần khóa/tự host; không tính phí API hosted)

Các đường dẫn nhà cung cấp tools.web.search.* cũ vẫn được tải qua shim tương thích tạm thời, nhưng chúng không còn là bề mặt config được khuyến nghị. Tín dụng miễn phí Brave Search: Mỗi gói Brave bao gồm $5/tháng tín dụng miễn phí được gia hạn. Gói Search có giá $5 cho mỗi 1.000 yêu cầu, vì vậy tín dụng này bao phủ 1.000 yêu cầu/tháng miễn phí. Đặt giới hạn sử dụng trong bảng điều khiển Brave để tránh các khoản phí ngoài dự kiến. Xem Công cụ web.

5) Công cụ fetch web (Firecrawl)

web_fetch có thể gọi Firecrawl khi có khóa API:

FIRECRAWL_API_KEY hoặc plugins.entries.firecrawl.config.webFetch.apiKey

Nếu Firecrawl chưa được cấu hình, công cụ sẽ fallback sang fetch trực tiếp cộng với plugin web-readability đi kèm (không dùng API trả phí). Tắt plugins.entries.web-readability.enabled để bỏ qua trích xuất Readability cục bộ. Xem Công cụ web.

6) Ảnh chụp mức sử dụng nhà cung cấp (trạng thái/sức khỏe)

Một số lệnh trạng thái gọi endpoint mức sử dụng của nhà cung cấp để hiển thị cửa sổ hạn mức hoặc tình trạng xác thực. Đây thường là các lệnh gọi khối lượng thấp nhưng vẫn chạm vào API nhà cung cấp:

openclaw status --usage
openclaw models status --json

Xem CLI mô hình.

7) Tóm tắt bảo vệ Compaction

Bảo vệ Compaction có thể tóm tắt lịch sử phiên bằng mô hình hiện tại, việc này gọi API nhà cung cấp khi chạy. Xem Quản lý phiên + Compaction.

8) Quét / thăm dò mô hình

openclaw models scan có thể thăm dò các mô hình OpenRouter và dùng OPENROUTER_API_KEY khi tính năng thăm dò được bật. Xem CLI mô hình.

9) Talk (lời nói)

Chế độ Talk có thể gọi ElevenLabs khi được cấu hình:

ELEVENLABS_API_KEY hoặc talk.providers.elevenlabs.apiKey

Xem Chế độ Talk.

10) Skills (API bên thứ ba)

Skills có thể lưu apiKey trong skills.entries.<name>.apiKey. Nếu một skill dùng khóa đó cho API bên ngoài, nó có thể phát sinh chi phí theo nhà cung cấp của skill đó. Xem Skills.

CLI commands

RPC and API

Templates

Technical reference

Concept internals

Project

Release and CI

Mức sử dụng API và chi phí

Mức sử dụng API & chi phí

Nơi chi phí xuất hiện (chat + CLI)

Cách khóa được phát hiện

Các tính năng có thể tiêu tốn khóa

1) Phản hồi mô hình lõi (chat + công cụ)

2) Hiểu media (âm thanh/hình ảnh/video)

3) Tạo hình ảnh và video

4) Embedding bộ nhớ + tìm kiếm ngữ nghĩa

5) Công cụ tìm kiếm web

5) Công cụ fetch web (Firecrawl)

6) Ảnh chụp mức sử dụng nhà cung cấp (trạng thái/sức khỏe)

7) Tóm tắt bảo vệ Compaction

8) Quét / thăm dò mô hình

9) Talk (lời nói)

10) Skills (API bên thứ ba)

Liên quan

CLI commands

RPC and API

Templates

Technical reference

Concept internals

Project

Release and CI

Documentation Index

​Mức sử dụng API & chi phí

​Nơi chi phí xuất hiện (chat + CLI)

​Cách khóa được phát hiện

​Các tính năng có thể tiêu tốn khóa

​1) Phản hồi mô hình lõi (chat + công cụ)

​2) Hiểu media (âm thanh/hình ảnh/video)

​3) Tạo hình ảnh và video

​4) Embedding bộ nhớ + tìm kiếm ngữ nghĩa

​5) Công cụ tìm kiếm web

​5) Công cụ fetch web (Firecrawl)

​6) Ảnh chụp mức sử dụng nhà cung cấp (trạng thái/sức khỏe)

​7) Tóm tắt bảo vệ Compaction

​8) Quét / thăm dò mô hình

​9) Talk (lời nói)

​10) Skills (API bên thứ ba)

​Liên quan

Mức sử dụng API & chi phí

Nơi chi phí xuất hiện (chat + CLI)

Cách khóa được phát hiện

Các tính năng có thể tiêu tốn khóa

1) Phản hồi mô hình lõi (chat + công cụ)

2) Hiểu media (âm thanh/hình ảnh/video)

3) Tạo hình ảnh và video

4) Embedding bộ nhớ + tìm kiếm ngữ nghĩa

5) Công cụ tìm kiếm web

5) Công cụ fetch web (Firecrawl)

6) Ảnh chụp mức sử dụng nhà cung cấp (trạng thái/sức khỏe)

7) Tóm tắt bảo vệ Compaction

8) Quét / thăm dò mô hình

9) Talk (lời nói)

10) Skills (API bên thứ ba)

Liên quan