Chi phí và thiết lập ZeroClaw API: runtime miễn phí, provider tùy chỉnh, chi phí token thực tế

Runtime ZeroClaw có giá $0: đây là phần mềm nguồn mở, được cấp phép kép MIT OR Apache-2.0, và FAQ riêng của zeroclaw.com cho biết không có gói đăng ký hay suất sử dụng dịch vụ do họ vận hành — bạn chỉ trả chi phí cho nhà cung cấp LLM của mình, hoặc không trả gì nếu chạy model cục bộ với Ollama. Tài liệu triết lý của dự án còn nói thẳng hơn: “Không phải SaaS. Không có phiên bản do chúng tôi vận hành, không có hệ thống tài khoản, không có cơ chế tính phí.” Vì vậy “giá ZeroClaw” trên thực tế có nghĩa là hai khoản khác — token mô hình tại endpoint mà bạn trỏ bí danh tới, và máy chạy daemon. Cả hai đều được kiểm tra ngày 21 tháng 9 năm 2026.

Có hai điều sẽ khiến bạn tốn tiền hoặc thời gian nếu bỏ qua. ZeroClaw Labs hoàn toàn không công bố giá hàng tháng, vì vậy gói đăng ký “ZeroClaw” hàng tháng mà bạn đã thấy là sản phẩm của người khác. Và sổ cái chi phí riêng của ZeroClaw sẽ báo chi tiêu bằng không trên gateway bên thứ ba cho đến khi bạn tự nhập mức giá, vì slot nhà cung cấp custom không có danh mục giá phía sau. Cả hai vấn đề đều được đề cập bên dưới.

Giá ZeroClaw: phần mềm tốn bao nhiêu và khoản nào thực sự tính phí

Hàng cuối là điểm neo sai mà một tìm kiếm “zeroclaw pricing” có thể dẫn tới. README của ZeroClaw nêu github.com/zeroclaw-labs/zeroclaw là kho mã chính thức duy nhất và khẳng định mọi kho mã, tổ chức, miền hoặc gói khác tự nhận là ZeroClaw đều không được ủy quyền và không liên kết. Một con số phí hàng tháng tính theo từng agent khác xuất hiện trong các đoạn trích tìm kiếm cho zeroclaw.live; trang đó trả về lỗi thay vì một trang vào ngày 21 tháng 9 năm 2026, nên không thể đọc con số này trên trang và con số đó được chủ ý không đăng lại ở đây. Riêng với các số liệu tiếp thị, hãy thận trọng ngay cả trên những miền mà chính dự án sử dụng: các trang đích tại zeroclaw.dev, zeroclaw.org và zeroclaw.net đều quảng cáo một tệp nhị phân 3.4MB, trong khi trang triết lý riêng của dự án nói một bản dựng phát hành điển hình có dung lượng khoảng 26 MiB. Đây là khoảng cách giữa tài liệu và trang đích, không phải bằng chứng về mạo danh — chính README hướng các báo cáo bảo mật tới một địa chỉ tại zeroclaw.dev. ZeroClaw so với OpenClaw phân tích chi tiết vấn đề nhận diện đó.

Một lưu ý về phạm vi, vì hai sự thật này có vẻ mâu thuẫn. “Không thanh toán” đúng với runtime ZeroClaw nhưng không đúng với ZeroClaw Labs với tư cách một tổ chức: cùng tổ chức GitHub đó cung cấp ZeroRouter, một gateway AGPL mà mô tả kho mã nêu có thanh toán Stripe trả trước, có thể truy cập từ ZeroClaw qua slot zerorouter riêng. Đây là một sản phẩm khác đang ở beta, không phải gói đăng ký ZeroClaw, và giá lưu trữ của nó là trạng thái gateway trực tiếp chứ không phải bảng giá được công bố.

Cấu trúc cấu hình cần viết hôm nay: schema 3, không phải đoạn trích phẳng

Tài liệu chính thức hiện tại; phần lớn cấu hình ZeroClaw bạn tìm thấy trong kết quả tìm kiếm thì không. Phiên bản schema cấu hình hiện tại là 3 — CURRENT_SCHEMA_VERSION: u32 = 3 trong crates/zeroclaw-config/src/migration.rs tại thẻ phát hành v0.8.5, với chuỗi di chuyển từ V1 đến V2 đến V3. Cấu trúc phẳng lưu hành trong các hướng dẫn cũ là schema 1. Tệp cấu hình không có schema_version được xem là phiên bản 1 và di chuyển trong bộ nhớ khi tải, nên bản thân thao tác tải không ghi lại tệp trên đĩa.

Lưu ý về cách gọi: “ZeroClaw V3” không phải một bản phát hành. Bản phát hành mới nhất là v0.8.5, được công bố ngày 5 tháng 9 năm 2026 (API GitHub, kiểm tra ngày 21 tháng 9 năm 2026); schema 3 là định dạng cấu hình bên trong bản đó. Hai con số này không liên quan nhau.

Tên trường schema-1 được đọc từ lăng kính di chuyển V1 tại v0.8.5; các hàng schema-2 lấy từ chú thích tài liệu trên lăng kính V2 ở master, cả hai đều được đọc vào ngày 21 tháng 9 năm 2026. Trong quá trình di chuyển, một tệp cũ được phân tích theo những lăng kính đó, vì vậy chúng là bằng chứng tốt về tên trường cũ. Ở hàng cuối, hai nguồn đưa ra thông tin khác nhau ở các thời điểm khác nhau: lăng kính V2 ghi rằng V3 đã loại bỏ cost.prices và chuyển việc định giá nội tuyến vào từng nhà cung cấp mô hình, trong khi tài liệu theo dõi chi phí hiện tại gọi trường pricing nội tuyến theo từng bí danh là trường kiểu cũ và xác định [cost.rates.*] là cấu trúc dành cho tương lai, được ưu tiên khi có xung đột. Hãy viết [cost.rates.*].

Trong schema 3, mọi model provider nằm tại [providers.models.<type>.<alias>], trong đó type là slot họ chuẩn — “Mỗi nhà cung cấp có một slot, không có từ đồng nghĩa” — còn alias là tên do bạn đặt. Tổng quan về nhà cung cấp nêu rõ “không có nút ‘nhà cung cấp mặc định’ hay ‘model mặc định’ toàn cục”, và Config::validate() sẽ báo lỗi rõ ràng lúc khởi động nếu bất kỳ tham chiếu nào không được phân giải. Một đoạn trích schema-1 được sao chép không bị từ chối chỉ vì cũ — chuỗi di chuyển gộp api_key, api_url và default_model cấp cao nhất vào một mục nhà cung cấp có tên do default_provider chỉ định, còn lăng kính V1 thay thế bằng openrouter khi thiếu khóa đó, vì vậy một đoạn phẳng chỉ mang khóa và URL sẽ rơi vào mục openrouter thay vì gateway bạn định dùng. Chế độ lỗi là tham chiếu không được phân giải, không phải tên trường cũ.

Nhà cung cấp tùy chỉnh ZeroClaw: trỏ một bí danh tới API tương thích OpenAI

Endpoint sử dụng chat-completions của OpenAI được đặt vào slot custom, và trang nhà cung cấp tùy chỉnh tại v0.8.5 cho biết đây là thay đổi chỉ trong cấu hình: “Slot custom yêu cầu uri (enum endpoint của họ không có giá trị mặc định).” Endpoint sử dụng giao thức Anthropic Messages được đặt vào slot anthropic với uri được đặt để ghi đè — không phải custom. Kunavo cung cấp cả hai dạng giao thức dưới https://api.kunavo.com/v1 với một khóa, nên về lý thuyết cả hai slot đều phù hợp. Đoạn trích bên dưới hợp nhất các trường custom-slot được tài liệu ghi nhận với cấu trúc bốn tiêu đề từ ví dụ hoàn chỉnh trong chính tài liệu; đây là một bản điều chỉnh, không phải khối chính thức được sao chép.

# Four section headers is the smallest config that loads clean.
[providers.models.custom.kunavo]
uri     = "https://api.kunavo.com/v1"   # REQUIRED: the custom family has no default endpoint
model   = "claude-sonnet-4-6"
api_key = "sk-kn-..."                   # or the secrets store, op://, or a ZEROCLAW_ env override

[agents.assistant]
model_provider  = "custom.kunavo"       # there is no global default provider
risk_profile    = "supervised"
runtime_profile = "resident"

[risk_profiles.supervised]
level                            = "supervised"
workspace_only                   = true
require_approval_for_medium_risk = true
block_high_risk_commands         = true

[runtime_profiles.resident]
max_actions_per_hour   = 10             # example values from the docs, not defaults
max_cost_per_day_cents = 100
max_tool_iterations    = 4
agentic_timeout_secs   = 120

Bốn lưu ý thực tế. Thông tin xác thực có thể được cung cấp theo bốn cách — inline api_key, tham chiếu op://vault/item/field của 1Password, kho mã hóa tại ~/.zeroclaw/secrets, hoặc ghi đè env chung ZEROCLAW_providers__models__custom__kunavo__api_key, trong đó dấu gạch dưới kép ánh xạ tới dấu chấm. Một tên shell mặc định của hệ sinh thái như $ANTHROPIC_API_KEY không được đọc trực tiếp trừ khi họ nhà cung cấp ghi nhận cầu nối env gốc của riêng mình — tài liệu yêu cầu bạn tự mở rộng nó thành tên schema-mirror — và biến env schema-mirror là một lần tiêm lúc chạy, không bao giờ trở thành cấu hình bền vững. Slot custom mặc định dùng giao thức chat-completions, còn wire_api được tôn trọng trên các họ mang endpoint riêng (openai, llamacpp, custom) trong khi các slot nhà cung cấp mang thương hiệu có giao thức cố định và bỏ qua nó, với opencode được nêu là ngoại lệ duy nhất. Nếu gateway của bạn từ chối trường temperature, hãy để trống: tài liệu nêu rằng temperature không được đặt sẽ bị loại hoàn toàn khỏi phần thân yêu cầu. Và việc khởi động sạch chứng minh ít hơn vẻ ngoài — bước làm nóng kết nối là một GET đọc phần thân và chấp nhận các mã trạng thái không thành công, nên daemon vẫn khởi động trong cả hai trường hợp; trang nhà cung cấp tùy chỉnh trên master ghi nhận nó là GET {base_url}/models, trong khi mã v0.8.5 làm nóng URL chat-completions thay thế.

Xác thực theo thứ tự được tài liệu nêu, cả ba đều ở v0.8.5: zeroclaw config list tải cấu hình và in các lỗi xác thực ra stderr, zeroclaw models refresh --model-provider custom.kunavo liệt kê những gì endpoint công bố, còn zeroclaw agent -a assistant -m "hello" kiểm tra nhanh agent. /v1/models của Kunavo trả về HTTP 401 nếu không có khóa (đã xác minh ngày 21 tháng 9 năm 2026), nhưng đây không phải trở ngại: lệnh refresh gửi khóa của alias. Kunavo chưa kiểm thử ZeroClaw trong thời gian chạy — mọi nội dung trong phần này đều là đánh giá các tài liệu nguồn của ZeroClaw, vì vậy hãy tự chạy một tác vụ có giới hạn trước khi tin cậy route này.

Kunavo không cung cấp mô hình embedding, chuyển văn bản thành giọng nói hoặc chuyển giọng nói thành văn bản, vì vậy agent cần các bước đó phải trỏ đến một endpoint khác, bất kể mô hình chat nằm ở slot ZeroClaw nào.

Đồng hồ đo chi phí hiển thị $0 cho đến khi bạn ghi bảng giá

ZeroClaw tự đo khoản chi tiêu của mình, và trên một gateway bên thứ ba, đồng hồ đo đó bắt đầu với giá trị sai. Việc theo dõi chi phí được kiểm soát bởi cost.enabled, còn các bản ghi được ghi vào sổ cái chỉ-ghi-thêm tại <workspace>/state/costs.jsonl, mỗi dòng một đối tượng JSON. Vấn đề nằm ở nguồn giá. Trong catalog.rs ở v0.8.5, catalog_source_for không trả về khóa models.dev cũng như tiền tố nhà cung cấp OpenRouter cho họ custom — hầu hết các slot mang thương hiệu có ít nhất một trong hai, dù một số (zerorouter, telnyx, nearai) không có cả hai. Tùy chọn live_pricing bị tắt theo mặc định, và khi được bật, nó trước tiên đọc danh sách /models của chính endpoint rồi dự phòng sang models.dev, dùng tên models.dev của họ; họ custom không có khóa như vậy, nên với slot này, danh sách của chính endpoint là nguồn duy nhất. Danh sách của Kunavo không có trường giá theo token, được đọc từ mã nguồn route thay vì từ phản hồi production đã xác thực. Vì vậy, alias custom-slot ghi nhận cost_usd = 0 với unpriced_tokens lớn hơn 0 cho đến khi bạn tự nhập mức giá.

[cost]
enabled = true

# Keyed by the UPSTREAM model id as it appears in usage telemetry,
# not by your alias. USD per 1M tokens.
[cost.rates.providers.models.custom.claude-sonnet-4-6]
input        = 2.1
output       = 10.5
cached_input = 0.21

Ba hành vi bắt nguồn từ đó, tất cả đều được nêu trong tài liệu theo dõi chi phí, đã kiểm tra ngày 21 tháng 9 năm 2026. Các mục giá được lập khóa theo model id upstream như xuất hiện trong telemetry sử dụng, không phải theo alias của bạn. Việc so sánh ngân sách sử dụng cost_usd đã ghi nhận, vì vậy tổng theo ngày hoặc tháng thấp hơn hạn mức không phải là bảo đảm an toàn khi tháng đó chứa các token chưa được định giá. Các dòng sổ cái hiện có không bao giờ được định giá lại: "không có việc định giá lại hồi tố", nên mức giá chỉ áp dụng cho các yêu cầu được thực hiện sau khi bạn cấu hình chúng. Cơ chế thực thi có ba chế độ — warn (mặc định), block và route_down, thay thế bằng một route_down_model rẻ hơn — cùng với allow_override, mặc định là false và cho phép yêu cầu bỏ qua block bằng một token ghi đè trên CLI.

Một ước tính minh họa dựa trên hạn mức hằng ngày của ZeroClaw

Đây là phép tính token minh họa, không phải chi phí của một tác vụ được đo lường và không phải mức trần hóa đơn. Ví dụ [runtime_profiles] trong tài liệu giới hạn một agent ở max_actions_per_hour = 10 và max_cost_per_day_cents = 100 — các giá trị ví dụ cho một mô hình cục bộ nhỏ, không phải giá trị mặc định. Hãy áp dụng đúng mức trần này cho tám giờ hoạt động mỗi ngày: 80 lượt mỗi ngày, mỗi lượt gửi 6.000 token đầu vào chưa cache và trả về 500 token đầu ra. Mức giá là giá catalog Kunavo hiện hành trên mỗi triệu token.

Điều cần đọc không phải là thứ hạng, mà là cách nó tương tác với hạn mức. Một profile được viết cho mô hình cục bộ nhỏ sẽ đặt mô hình frontier dưới cùng các giới hạn: max_actions_per_hour giới hạn số lượt, còn hạn mức chi phí hằng ngày chỉ từ chối một yêu cầu khi enforcement.mode là block. Với warn, chế độ mặc định, hạn mức hoàn toàn không chặn — nó ghi nhật ký sự kiện và cho phép yêu cầu tiếp tục. (warn_at_percent, mặc định 80%, là một nút điều khiển riêng: nó xác định thời điểm gateway hiển thị biểu ngữ cảnh báo trước giới hạn cứng.) Tệ hơn, nếu bạn chưa ghi bảng giá ở trên, không điều gì trong số này được kích hoạt, vì hạn mức không thể nhìn thấy các token chưa được định giá. Hãy điều chỉnh bảng theo số lượt và tỷ lệ đầu vào-đầu ra của riêng bạn trước khi coi đây là ngân sách; bảng không bao gồm phí cache, lệnh gọi công cụ và lần thử lại, đồng thời giả định mô hình rẻ hơn hoàn thành công việc mà không cần thêm lần thử.

Mức giá trong danh mục của Kunavo là mức tính phí tối thiểu, không phải mức trần: khi nhà cung cấp thượng nguồn báo cáo khoản phí của họ, khoản phí phải trả là giá trị lớn hơn giữa chi phí trong danh mục và chi phí từ nhà cung cấp thượng nguồn nhân với hệ số cộng giá áp dụng. Số tiền nạp tối thiểu là $10 dưới dạng tín dụng trả trước; đây là mức nạp tiền tối thiểu, không phải phí cho một tác vụ hay phí thuê bao — xem chi tiết về thanh toán.

Mô hình tốt nhất và API tốt nhất cho ZeroClaw: những gì dự án sẽ và sẽ không cho bạn biết

ZeroClaw không công bố mô hình được khuyến nghị nào và từ chối đưa ra tuyên bố chính thức. Trang thiết lập đa mô hình của dự án nêu rằng "quy trình này không thiết lập danh sách mô hình đã được ZeroClaw xác minh" và "bằng chứng cho một bản build, mô hình, lượng tử hóa và thiết lập context không xác minh các tổ hợp khác". Đó là câu trả lời trung thực cho câu hỏi "mô hình tốt nhất cho ZeroClaw": không có bảng xếp hạng chính thức để trích dẫn, vì vậy hãy lựa chọn dựa trên hai thuộc tính có thể kiểm thử.

Thuộc tính đầu tiên là gọi công cụ native, và cùng trang đó đặt ra tiêu chuẩn nghiêm ngặt cho việc này: "Kiểm tra lần chạy để xác định có một lệnh gọi công cụ thực tế, kết quả thực thi của lệnh gọi đó và phần trả lời tiếp theo của trợ lý sử dụng kết quả ấy hay không. Chỉ có một câu trả lời có vẻ hợp lý hoặc phần đánh dấu lệnh gọi công cụ được in ra thì không đạt bài kiểm tra công cụ." Thiết lập hồ sơ thời gian chạy strict_tool_parsing coi văn bản dự phòng trông giống XML hoặc JSON là văn bản trợ lý thông thường, trừ khi nhà cung cấp trả về các lệnh gọi công cụ thực; vì vậy một mô hình chỉ mô tả lệnh gọi công cụ sẽ có vẻ đang hoạt động nhưng không bao giờ hành động. Thuộc tính thứ hai là liệu mô hình có hoàn thành tác vụ của bạn mà không cần thêm lần thử hay không — đó là lý do giá niêm yết thấp nhất và chi phí thấp nhất để hoàn thành là hai tuyên bố khác nhau.

Có hai hành vi đáng tính ngân sách trước khi bạn bật chuyển đổi dự phòng. Streaming có hợp đồng hẹp hơn: trang vòng đời định tuyến provider nói rằng wrapper "chọn mục đầu tiên theo thứ tự có hỗ trợ các khả năng stream được yêu cầu và không đang trong thời gian hạ nhiệt", sau đó "mở stream đó một lần" và "không chuyển sang mục khác sau khi stream đã bắt đầu" — tuy nhiên một stream bị lỗi trước khi bất kỳ đầu ra nào được ghi nhận sẽ được thử lại qua đường dẫn không streaming, đường dẫn này đi lại toàn bộ quy trình độ tin cậy trên fallback_models và fallback. Các lần thử lại không streaming đó bao gồm timeout, lỗi kết nối, 429 và 503, và rõ ràng không bao gồm 400, lỗi xác thực vĩnh viễn hoặc lỗi đầu ra mô hình. Một mục dự phòng cũng có thể chuyển công việc sang một bậc giá khác, vì vậy hãy lập ngân sách cho nó trước. Để so sánh rộng hơn về các route gateway, xem hướng dẫn API tương thích với OpenAI và các lựa chọn thay thế OpenRouter.

Công việc duy trì: profile rủi ro, hạn mức và dịch vụ khởi động lại nó

Tính tự chủ được thiết lập theo từng agent, không phải toàn cục. Trang autonomy ở v0.8.5 chấp nhận chính xác ba cấp độ — readonly, supervised và full — và từ chối read_only có dấu gạch dưới khi tải cấu hình. Với supervised mặc định, các công cụ rủi ro thấp chạy tự động, công cụ rủi ro trung bình hiển thị lời nhắc xin phê duyệt của người vận hành, còn công cụ rủi ro cao bị chặn. Lời nhắc phê duyệt hết hạn sau approval_timeout_secs của kênh, 120 giây đối với hầu hết các kênh, và timeout được tính là từ chối — vì vậy agent không có người giám sát sẽ đóng theo hướng an toàn thay vì xếp hàng chờ.

Có hai ranh giới đối với công việc duy trì. Hành vi khởi động lại không đồng nhất giữa các nền tảng: unit systemd user đã cài đặt đặt Restart=always với RestartSec=3 và không có danh sách cho phép mã thoát, vì vậy daemon thoát nhanh do cấu hình sai sẽ liên tục khởi động rồi dừng; macOS LaunchAgent đặt RunAtLoad và KeepAlive; còn trên Windows, zeroclaw service install đăng ký một tác vụ Task Scheduler ONLOGON khởi động daemon khi đăng nhập mà không thêm chính sách khởi động lại khi lỗi. Bản thân công việc đã lên lịch mang tính khai báo và được lập khóa theo alias tại [cron.<alias>], tách biệt với các nút điều khiển riêng của phần [scheduler]. Ngoài ra, công cụ SOP tất định được đánh dấu là thử nghiệm trong ma trận tính năng của chính dự án — các trigger ngoại vi và lịch được định nghĩa và đối sánh nhưng chưa được định tuyến đến nguồn trực tiếp — vì vậy hiện chưa nên thiết kế quy trình không người giám sát dựa trên nó.

Thiết lập và kiểm tra khoản phí đầu tiên

Kunavo không công bố trang tích hợp dành riêng cho ZeroClaw và chưa kiểm thử client trong thời gian chạy, vì vậy hãy coi cấu hình trên là route dựa trên tài liệu nguồn chứ không phải kết quả tương thích. Quy trình thực tế rất ngắn: tạo khóa, nạp mức tối thiểu, ghi bốn header, chạy ba lệnh xác thực theo thứ tự, sau đó ghi khối [cost.rates.*] trước lần chạy dài đầu tiên để sổ cái có dữ liệu ghi nhận. Bắt đầu tại hướng dẫn bắt đầu nhanh để xem base URL và định dạng khóa, tài liệu tham khảo chat-completions để xem wire mà slot custom sử dụng, và tạo tài khoản Kunavo khi bạn sẵn sàng nạp tiền. Nếu agent của bạn sử dụng wire Anthropic, tài liệu base URL Anthropic trình bày route cho slot anthropic.

Câu hỏi thường gặp

Đã kiểm tra ngày 21 tháng 9 năm 2026. Đã đọc lại trực tiếp cho trang này: FAQ của zeroclaw.com, README của kho mã, API GitHub để xem trạng thái kho mã và bản phát hành v0.8.5, migration.rs, schema/v1.rs, catalog.rs, compatible.rs, providers/custom.md, security/autonomy.md và ops/service.md tại tag v0.8.5; trên master là góc nhìn về chuyển đổi sang V2, providers/overview.md, providers/configuration.md, providers/catalog.md, providers/routing.md, providers/custom.md, architecture/provider-routing-lifecycle.md, ops/cost-tracking.md, getting-started/multi-model-setup.md, philosophy/minimal.md, philosophy/what-this-isnt.md và reference/feature-matrix.md; ngoài ra còn có kho mã zerorouter, các trang bên thứ ba và trang đích được nêu ở trên, cùng một yêu cầu GET không xác thực tới /v1/models của Kunavo. Mọi nội dung được trích dẫn từ master đều là tài liệu của nhánh phát triển và có thể đi trước bản phát hành ổn định. Kunavo chưa kiểm thử ZeroClaw trong thời gian chạy: chưa cài đặt, chưa chạy config list và chưa thực hiện lần chạy tác tử nào, vì vậy khả năng truyền dữ liệu dạng luồng, gọi công cụ native và xử lý hình ảnh qua tuyến này chưa được xác minh ở đây. Mức giá token của Kunavo được đọc từ danh mục đang được cập nhật và mọi con số đô la trên trang này đều là phép tính token minh họa.