Chi phí và nhà cung cấp API của NanoClaw: Claude, OpenCode và các tuyến local

NanoClaw có giá $0. Phần mềm được cấp phép MIT, tự lưu trữ, không có tài khoản người dùng và không có gói trả phí; trang tài liệu cũng hoàn toàn không công bố trang giá — vì vậy “giá NanoClaw” có nghĩa là hóa đơn mô hình từ nhà cung cấp bạn kết nối, cộng với gói đăng ký Docker Desktop nếu công ty bạn vượt ngưỡng sử dụng miễn phí của Docker. Con số cần lập ngân sách là khoản runtime mặc định tính phí, vì NanoClaw được cấu hình sẵn để trỏ đến Claude; Codex là lựa chọn thay thế duy nhất mà quá trình thiết lập có thể cài trực tiếp, còn các lựa chọn khác là tiện ích bổ sung cần cài sau.

Trước hết cần phân biệt hai điểm, vì trang kết quả trộn lẫn chúng. Clawland-AI/nanoclaw là một agent Python không liên quan dành cho máy tính bo mạch đơn, và chi phí phần cứng của nó không thuộc sản phẩm này. Một tiêu đề bên thứ ba được chia sẻ rộng rãi cũng gắn một con số đô la với cụm từ “nhà máy NanoClaw PR”; dù con số đó đo lường điều gì, nó không phải giá NanoClaw tính, vì NanoClaw không tính phí. Trang này nói về nanocoai/nanoclaw — MIT, chưa bị lưu trữ, 30.814 sao, được tạo ngày 31 tháng 1 năm 2026, đẩy lần cuối ngày 19 tháng 9 năm 2026 (GitHub API, ngày 21 tháng 9 năm 2026). Địa chỉ qwibitai/nanoclaw cũ hiện chuyển hướng 301 đến cùng kho đó, vì vậy bài viết hoặc mục thư mục vẫn trỏ đến địa chỉ này không mô tả một dự án thứ hai. Cách cài đặt NanoClaw được tài liệu hóa là bash nanoclaw.sh từ bản checkout đó, vì vậy hãy xem mục SourceForge là bản mirror thay vì kênh chính thức của dự án.

Chi phí của phần mềm và khoản thực sự tính phí bạn

FAQ trên trang chủ của NanoClaw trả lời câu hỏi về tiền bạc trong một dòng: phần mềm miễn phí và mã nguồn mở theo giấy phép MIT, đồng thời “nhà cung cấp agent của bạn có thể tính phí sử dụng mô hình”. Chỉ mục tài liệu liệt kê 56 trang và không có trang nào về giá, thanh toán hoặc gói dịch vụ. Khoản phí hoàn toàn nằm ở phía bên kia của container.

Tất cả được kiểm tra ngày 21 tháng 9 năm 2026. Dòng Docker là điểm nhiều người bỏ sót: Docker Engine trên Linux không kích hoạt điều khoản đó, nhưng bản cài đặt thương mại trên macOS hoặc Windows vượt các ngưỡng đó thì có. Trước tất cả những điều này, yêu cầu trong README là macOS hoặc Linux (Windows thông qua WSL2), Node.js 22+ và pnpm 10+, Docker và chính Claude Code — đây là điều kiện tiên quyết cho /customize, /debug, khôi phục lỗi thiết lập và mọi skill /add-<channel>, không chỉ nhà cung cấp mặc định. Bản phát hành hiện tại là v2.4.0, được xuất bản ngày 23 tháng 9 năm 2026, và package.json trên main cũng xác nhận điều này.

Runtime mặc định là Claude, và có ba cách thanh toán

Đây là điểm phân biệt mà hầu hết danh sách nhà cung cấp làm mờ. Khi cài đặt nguyên bản, NanoClaw chạy Claude Code bên trong container agent thông qua Anthropic Claude Agent SDK — container/cli-tools.json cố định @anthropic-ai/claude-code ở phiên bản 2.1.280. Hướng dẫn thông tin xác thực của NanoClaw mô tả ba cách trình hướng dẫn kết nối Claude — gói đăng ký Claude, API key hoặc OAuth token bạn đã có, hoặc điểm cuối tương thích Anthropic — và nêu rằng cả ba đều trở thành secret trong vault thay vì biến môi trường; quy trình đăng ký chạy claude setup-token và lưu OAuth token tạo ra. Giá nhà cung cấp bên dưới là mức các trang đó hiển thị vào ngày được nêu; hãy xác nhận con số trong trang thanh toán chính thức của nhà cung cấp trước khi cam kết.

Với tùy chọn đăng ký, hai tuyên bố chính thức nằm cạnh nhau và trang này sẽ không tự giải quyết mâu thuẫn cho bạn. Trình hướng dẫn NanoClaw gắn nhãn đăng nhập bằng gói đăng ký là “được khuyến nghị nếu bạn có Pro hoặc Max”, còn trang giá của Claude liệt kê Pro ở mức $20 mỗi tháng khi thanh toán theo tháng, hoặc $17 mỗi tháng theo gói hằng năm với khoản $200 thanh toán trước, và Max từ $100 mỗi tháng. Tổng quan Agent SDK của Anthropic nêu riêng rằng, nếu chưa được phê duyệt trước, họ không cho phép nhà phát triển bên thứ ba cung cấp đăng nhập claude.ai hoặc giới hạn tốc độ cho sản phẩm của mình, bao gồm các agent được xây dựng trên Agent SDK. Không có nguồn công khai nào ở đây xác định được NanoClaw có phê duyệt như vậy hay không; hạn mức sử dụng mà gói đăng ký cấp cho một agent cũng không xác định được — Anthropic không công bố số token cho Pro hoặc Max.

API tùy chỉnh của NanoClaw: quy trình duy nhất được tài liệu hóa

Điểm cuối tương thích Anthropic là một quy trình thiết lập chính thức, và phạm vi của nó hẹp hơn README gợi ý. Việc đặt cả hai biến bên dưới khiến quá trình thiết lập tạo một secret OneCLI với cơ chế chèn header khóa theo hostname, chỉ ghi duy nhất base URL vào .env và đăng ký cấu hình nhà cung cấp điểm cuối tùy chỉnh.

# NanoClaw's credentials guide: set BOTH before running setup.
# Only one of the two is not enough — setup takes this branch only when
# no Anthropic secret exists yet, and the URL is an origin with no /v1.
export NANOCLAW_ANTHROPIC_BASE_URL=https://api.kunavo.com
export NANOCLAW_ANTHROPIC_AUTH_TOKEN=<your key>

# The same two values exist as setup flags:
#   --anthropic-base-url   --anthropic-auth-token

Có bốn ràng buộc xuất phát từ cách xây dựng này. Cả hai biến đều bắt buộc — nhánh của quá trình thiết lập kiểm tra cả cặp. Nhánh này chỉ chạy khi chưa có secret Anthropic, nên đây là quy trình cài đặt lần đầu, không phải cách đổi điểm đến của một máy đã kết nối Claude. Secret gắn với hostname được phân tích từ URL, vì vậy đổi domain đồng nghĩa với việc phải tạo lại nó. URL phải là một origin: tài liệu tham chiếu ANTHROPIC_BASE_URL của Kunavo giải thích rõ vì sao https://api.kunavo.com hoạt động còn https://api.kunavo.com/v1 tạo yêu cầu đến /v1/v1/messages.

Đồng thời hãy cố định model. Một group không có model riêng sẽ chạy mặc định của Claude Code, vốn theo Opus mới nhất — Opus 5.5 kể từ v2.4.0, theo changelog của NanoClaw — và model mà Kunavo chưa cung cấp sẽ trả về 404. NANOCLAW_DEFAULT_MODEL trong .env của bản cài đặt điền giá trị cho mọi group chưa đặt model; tài liệu tham chiếu biến môi trường cho biết thay đổi cần khởi động lại host rồi khởi động lại các session bị ảnh hưởng.

# NanoClaw 2.4.0+: the model for every agent group that has not set its
# own (a group's own model wins). Install-wide, so Codex and OpenCode groups
# without one get it too; on a mixed install set each Claude group instead:
#   ncl groups config update --id <group> --model <model>
NANOCLAW_DEFAULT_MODEL=claude-sonnet-5

Bên trong container, token của bạn không bao giờ xuất hiện. Nhà cung cấp Claude của NanoClaw chèn base URL cùng với ANTHROPIC_AUTH_TOKEN=placeholder, còn gateway của vault viết lại bearer trên đường truyền — điều này cũng có nghĩa việc chèn phụ thuộc vào container sử dụng HTTPS_PROXY đã cấu hình. Bất kỳ thứ gì bỏ qua proxy đó cũng bỏ qua thông tin xác thực. Trong v2.3.0, driver từ chối đặc tả container có chứa giá trị thông tin xác thực trong môi trường được đóng góp, vì vậy việc tự chỉnh sửa một key thật vào container.json được tạo sẽ bị chính sách từ chối thay vì chỉ bị khuyến cáo không nên làm.

Hai nguồn chính thức không thống nhất về phiên bản .env thuần túy, và cả hai đều đáng biết. README trình bày ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN trong .env “dành cho các thử nghiệm một lần”, trong khi tài liệu tham chiếu biến môi trường cho biết ANTHROPIC_BASE_URL chỉ hoạt động sau khi quá trình thiết lập đã đăng ký cấu hình nhà cung cấp điểm cuối tùy chỉnh. Trên nhánh main hiện tại, phần token không bao giờ đến được yêu cầu: tệp nhà cung cấp Claude được liên kết ở trên chỉ yêu cầu .env đối với ANTHROPIC_BASE_URL, và đặt ANTHROPIC_AUTH_TOKEN thành chuỗi ký tự placeholder. Hãy xem đoạn mã README là một thử nghiệm, đúng như nhãn của nó, và xem quy trình thiết lập ở trên là cấu hình bạn sẽ chạy.

Mặc định và mở rộng: mỗi quy trình thực sự cài đặt gì

Các nguồn được kiểm tra ngày 21 tháng 9 năm 2026: hướng dẫn nhà cung cấp của NanoClaw, các tệp skill /add-opencode và /add-codex, docs/ollama.md, cùng trang giá của ChatGPT (URL giá Codex cũ hiện chuyển hướng đến đó). Cột đầu tiên tuân theo cùng hướng dẫn nhà cung cấp, trong đó nêu rằng trình chọn runtime của quá trình thiết lập cung cấp Codex dưới dạng cài đặt trực tiếp, còn OpenCode được thêm sau khi thiết lập bằng /add-opencode. Lưu ý về Ollama đến từ chính nhà cung cấp: hướng dẫn nhà cung cấp cho biết skill vẫn nằm trong kho nhưng nhắm đến một đường dẫn cấu hình cũ, các chỉnh sửa cũ đó “không phải là cách chuyển đổi được hỗ trợ có thể áp dụng trực tiếp trên nhánh main hiện tại”, và trước tiên cần chuyển đổi, kiểm thử tích hợp — trong khi README vẫn liệt kê đây là một quy trình được hỗ trợ. Khi hai nguồn mâu thuẫn, hướng dẫn nhà cung cấp mới hơn và cụ thể hơn được ưu tiên. OpenRouter kết nối với NanoClaw thông qua backend OpenCode, không phải qua base URL Anthropic; FAQ của OpenRouter tính 5,5% với mức tối thiểu $0,80 cho giao dịch mua credit bằng thẻ và 5% cho crypto, đồng thời không áp dụng markup cho chính hoạt động suy luận.

Một ước tính chi phí API NanoClaw có tính toán

Đây là phép tính token dựa trên các giả định đã nêu, không phải chi phí tác vụ đo được và không phải mức trần hóa đơn. Giả sử một group agent xử lý 40 lượt mỗi ngày, mỗi lượt gửi 30.000 token input và trả về 1.500 token output, với không có nội dung nào được phục vụ từ cache. Mức giá là giá trực tiếp hiện tại của catalog Kunavo cho mỗi triệu token.

Ba cách diễn giải. Thứ nhất, Claude Sonnet 5 và Claude Opus 5 không còn có cùng mức giá trong catalog, vì vậy hãy so sánh trực tiếp hai hàng đó trước khi chọn — so với mức giá Anthropic công bố cho cùng model id Opus 5 đó, $5,00 và $25,00 trên mỗi triệu, tổng chi phí mô hình trong cùng tháng là $225,00. Thứ hai, caching là đòn bẩy lớn hơn hàng mô hình, vì cùng trang đó đặt giá đọc cache ở mức 0,1x input cơ bản và ghi cache trong năm phút ở mức 1,25x: nếu 70% lượng input ở trên đến dưới dạng lượt đọc cache theo mức giá input đã cache là $0,35 trên mỗi triệu, chi phí cho cùng tháng đó khi dùng Claude Opus 5 sẽ là $78,12 thay vì $157,50. Thứ ba, hãy điều chỉnh số lượt theo các kênh của riêng bạn trước khi xem bất kỳ con số nào là ngân sách — agent NanoClaw kết nối với một nhóm chat bận rộn và agent kết nối với một người duy nhất không có cùng khối lượng công việc.

Số tiền trong catalog của Kunavo là mức sàn thanh toán chứ không phải mức trần: khi upstream báo khoản phí, hóa đơn là giá trị lớn hơn giữa chi phí trong catalog và chi phí upstream nhân với markup áp dụng. Mức nạp tối thiểu là $10 dưới dạng tín dụng trả trước — đây là mức tối thiểu để nạp tiền, không phải phí tác vụ hay gói đăng ký. Xem chi tiết thanh toán và báo cáo sử dụng.

Kiểm tra tối thiểu và chi phí mở rộng về sau

Cách kiểm tra hữu ích rẻ nhất rất nhỏ: setup/index.ts đăng ký một bước verify, còn tiêu chí chấp nhận của skill /add-opencode là gửi một tin nhắn, xác nhận có phản hồi, rồi gửi tin nhắn thứ hai để xác nhận session tiếp tục. Với điểm cuối tùy chỉnh, docker exec <container> env | grep ANTHROPIC phải hiển thị base URL của bạn cạnh token placeholder — nếu key thật xuất hiện ở đó thì đường dẫn đang có vấn đề, chứ đó không phải dấu hiệu đúng.

Sau đó hãy tính chi phí bảo trì, vì các nhà cung cấp mở rộng là phần mềm được cố định phiên bản. Changelog của NanoClaw ghi nhận rằng phiên bản Codex cố định trước đây mặc định dùng một model mà OpenAI đã ngừng cung cấp cho Codex vào ngày 31 tháng 8 năm 2026, và chạy lại /add-codex không cố định lại phiên bản cho một bản cài đặt hiện có — phiên bản hiện tại là @openai/codex 0.155.1 kể từ v2.4.0. Phiên bản cố định của OpenCode cũng là một xung đột nguồn đang diễn ra: tệp skill của kho cho biết cả hai bản cố định phải chính xác là 1.18.25, trong khi hướng dẫn nhà cung cấp đã xuất bản vẫn ghi 1.4.17. Kho mã nguồn là nguồn cụ thể hơn, và OpenCode cũng đã chuyển tổ chức — sst/opencode hiện chuyển hướng 301 đến anomalyco/opencode, bản phát hành mới nhất là v1.18.31 ngày 14 tháng 9 năm 2026. Các bản cài đặt trên OneCLI 1.41.0 cũng cần xác thực thủ công lại khi đăng nhập ChatGPT của OpenCode hết hạn.

Theo hướng dẫn nhà cung cấp, năng lực thay đổi khi bạn rời nhà cung cấp Claude: OpenCode và Codex đều khai báo không có slash command tích hợp sẵn, cả hai đều xếp hàng các tin nhắn tiếp theo thay vì chấp nhận input giữa lượt, Codex đọc AGENTS.md với giới hạn 32 KiB so với 4 MiB của Claude, và chỉ nhà cung cấp Claude xoay vòng transcript. Việc chuyển một group mang theo cây memory/ nhưng không mang theo ngữ cảnh hội thoại đang diễn ra, và thay đổi chỉ có hiệu lực ở lần tạo container tiếp theo.

Trỏ NanoClaw đến Kunavo

Kunavo công bố các tài liệu tham chiếu cấu hình cho dạng client này — hướng dẫn Claude Agent SDK và Claude Code bao quát runtime mặc định, còn OpenCode và Codex CLI bao quát hai runtime mở rộng. Đây là tài liệu tham chiếu thiết lập đã công bố, không phải kiểm thử tương thích: NanoClaw chưa được kiểm thử khi chạy thực tế ở đây, và toàn bộ nội dung trên là cách đọc kho mã nguồn cùng tài liệu của nó. Hãy duy trì một quy trình đang hoạt động trong khi thử nghiệm, chạy một tác vụ có giới hạn, rồi kiểm tra những gì tài khoản đã ghi nhận. Tạo tài khoản Kunavo khi bạn sẵn sàng nạp tiền cho một khóa.

Đang cân nhắc giữa các agent thay vì các nhà cung cấp? NanoClaw vs OpenClaw so sánh khả năng cô lập và mức độ tự do lựa chọn nhà cung cấp, còn giá OpenCode, giá Codex và các lựa chọn thay thế OpenRouter bao quát ba hướng mà trang này xem là các tiện ích bổ sung. Giá Claude Code trình bày chi tiết hơn về cách tính phí riêng của runtime mặc định.

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

Được lấy trực tiếp trong quá trình viết trang này, vào ngày 21 tháng 9 năm 2026: bản ghi và danh sách bản phát hành của kho nanocoai/nanoclaw, package.json, container/cli-tools.json, README, tài liệu về image được tăng cường bảo mật, nanoclaw.dev, mục lục tài liệu, các trang thông tin xác thực, biến môi trường và nhà cung cấp, docs/ollama.md, changelog, các tệp skill /add-opencode và /add-codex, kho OneCLI và trang giá của Anthropic. Các mức phí Docker, gói đăng ký Claude, ChatGPT và OpenRouter được trích từ chính các trang giá của nhà cung cấp đó như đã ghi nhận cùng ngày, thay vì được lấy lại ở đây, vì vậy hãy xác nhận chúng trong bước thanh toán của nhà cung cấp. Mức giá token của Kunavo lấy từ danh mục trực tiếp. Bản phát hành v2.4.0, changelog, container/cli-tools.json và tài liệu tham chiếu biến môi trường đã được kiểm tra lại vào ngày 24 tháng 9 năm 2026, khi model pin được thêm vào. Không nội dung nào trên trang này được kiểm thử khi chạy với một bản cài đặt NanoClaw, và mọi con số đô la đều chỉ là phép tính token minh họa.