NanoClaw 的費用是 $0。它採 MIT 授權、由使用者自行託管、沒有使用者帳戶,也沒有付費層級,其文件網站完全沒有發布定價頁面——因此「NanoClaw 定價」指的是你連接的供應商所產生的模型帳單,加上公司超過 Docker 免費使用門檻時的 Docker Desktop 訂閱費。值得規劃的數字是預設執行階段產生的帳單,因為 NanoClaw 出貨時已設定為使用 Claude;Codex 是設定程序可以內嵌安裝的唯一替代方案,其餘都是之後安裝的附加元件。
先釐清兩件事,因為結果頁面把它們混在一起。Clawland-AI/nanoclaw 是供單板電腦使用、無關的 Python 代理,其硬體成本不屬於本產品。廣泛分享的第三方標題也將一個美元數字附加在「NanoClaw PR factory」這幾個字上;無論該數字衡量的是什麼,都不是 NanoClaw 收取的價格,因為 NanoClaw 完全不收費。本頁討論的是 nanocoai/nanoclaw——MIT 授權、未封存、30,814 顆星,建立於 2026 年 1 月 31 日,最後一次推送於 2026 年 9 月 19 日(GitHub API,2026 年 9 月 21 日)。較舊的 qwibitai/nanoclaw 位址現在會對相同儲存庫回傳 301,因此仍指向該位址的文章或目錄項目並不是在描述第二個專案。NanoClaw 文件記載的安裝方式是從該簽出執行 bash nanoclaw.sh,因此應將 SourceForge 清單視為鏡像,而非專案自己的管道。
軟體的成本,以及實際向你收費的項目
NanoClaw 的首頁常見問答用一句話回答費用問題:它在 MIT 授權下免費且開放原始碼,而且「你的代理供應商可能會收取模型使用費」。文件索引列出 56 個頁面,其中沒有任何定價、計費或方案頁面。帳單完全在容器的另一側。
| 項目 | 費用 | 來源 |
|---|---|---|
| NanoClaw 本身 | $0、MIT、無帳戶 | 儲存庫授權,以及 README 中的「NanoClaw 沒有使用者帳戶」 |
| 免費的 NanoClaw 帳戶 | $0 且選用——只有兩項優點 | 本機映像建置是預設方式,不需要帳戶,詳見強化映像文件 |
| OneCLI 憑證保存庫 | $0 自行託管(Apache-2.0);其 ee/ 功能在正式環境使用時需要訂閱 | OneCLI 儲存庫;NanoClaw 預設會安裝本機執行個體 |
| Docker | Docker Desktop Personal $0;Pro $11、Team $16 和 Business $24,按每位使用者每月計費且按月結算;Pro 年繳為 $9,Team 年繳為 $15 | Docker 定價;依據授權條款,免費使用僅限個人、教育、非商業開源,以及員工人數少於 250 人且營收低於 $10 million 的企業 |
| 模型權杖 | 供應商的每 token 費率 | 供應商自行計費 |
所有資訊均於 2026 年 9 月 21 日查核。Docker 這一點最容易被忽略:Linux 上的 Docker Engine 不會觸發該條款,但超過這些門檻的商業 macOS 或 Windows 安裝則會。在此之前,README 需求包括 macOS 或 Linux(Windows 需透過 WSL2)、Node.js 22+ 與 pnpm 10+、Docker,以及 Claude Code 本身——它是 /customize、/debug、設定錯誤復原和每個 /add-<channel> 技能的必要條件,而不僅是預設提供者的必要條件。目前版本為v2.4.0,發布於 2026 年 9 月 23 日,而 main 上的 package.json 也一致。
預設執行環境是 Claude,付費方式有三種
這是大多數提供者清單會混淆的差異。NanoClaw 開箱即用時,會透過 Anthropic 的 Claude Agent SDK,在代理程式容器內執行 Claude Code——container/cli-tools.json 將 @anthropic-ai/claude-code 固定為 2.1.280。NanoClaw 的憑證指南說明精靈連線 Claude 的三種方式——Claude 訂閱、你已持有的 API 金鑰或 OAuth 權杖,或 Anthropic 相容端點——並指出三者最後都會成為保存庫密鑰,而不是環境變數;訂閱方式會執行 claude setup-token 並儲存產生的 OAuth 權杖。以下供應商價格是指定日期各頁面顯示的金額;在承諾前,請於供應商自己的結帳頁面確認價格。
關於訂閱選項,有兩項官方說法並列存在,本頁不替你調和兩者。NanoClaw 的精靈將訂閱登入標示為「如果你有 Pro 或 Max,建議使用」,而Claude 定價頁面列出的 Pro 價格為每月 $20、按月計費;年繳方案則為每月 $17,預先支付 $200;Max 則自每月 $100 起。Anthropic 的Agent SDK 概覽另行聲明,除非事先獲得核准,否則不允許第三方開發者在其產品中提供 claude.ai 登入或速率限制,包括建置於 Agent SDK 上的代理程式。任何此處公開來源都無法確認 NanoClaw 是否持有這類核准;同樣也無法確認訂閱提供給代理程式的使用配額——Anthropic 沒有公布 Pro 或 Max 的權杖數量。
NanoClaw 自訂 API:唯一有文件記載的路徑
Anthropic 相容端點是正式支援的設定路徑,而且比 README 所暗示的範圍更窄。設定以下兩個變數後,設定流程會建立一個 OneCLI 密鑰,依你的主機名稱設定標頭注入,只將基礎 URL 寫入 唯一的 .env,並註冊自訂端點提供者設定。
# 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這種建置方式帶來四項限制。兩個變數都是必要的——設定流程的分支會檢查這一對變數。只有在尚未存在 Anthropic 密鑰時才會執行該分支,因此這是首次安裝路徑,不是重新指向已連接 Claude 的機器的方法。密鑰會綁定到從 URL 解析出的主機名稱,因此變更網域就代表必須重新建立密鑰。此外,URL 必須是 origin:Kunavo 自己的ANTHROPIC_BASE_URL 參考明確說明為何 https://api.kunavo.com 可行,而 https://api.kunavo.com/v1 會產生前往 /v1/v1/messages 的請求。
模型也要固定。沒有自行指定模型的群組會執行 Claude Code 的預設模型,而該模型會跟隨最新的 Opus——根據 NanoClaw 的變更記錄,自 v2.4.0 起為 Opus 5.5;尚未由 Kunavo 提供的模型則會回應 404。在此安裝的 .env 中設定的 NANOCLAW_DEFAULT_MODEL 會為每個尚未設定模型的群組補上模型;環境變數參考指出,變更需要重新啟動主機,接著再重新啟動受影響的工作階段。
# 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在容器內,你的權杖永遠不會出現。NanoClaw 的Claude 提供者會注入基礎 URL 與 ANTHROPIC_AUTH_TOKEN=placeholder,而保存庫閘道會在傳輸過程中重寫 bearer——這也表示注入作業取決於容器使用其設定的 HTTPS_PROXY。任何繞過該 Proxy 的作法也會同時繞過憑證。在 v2.3.0 中,驅動程式會拒絕任何在貢獻的環境中攜帶憑證值的容器規格,因此將真正的金鑰手動寫入產生的 container.json 會因政策而遭拒絕,而不只是受到勸阻。
兩個官方來源對純 .env 版本的說法不一致,但兩者都值得了解。README 在 .env 中提供 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN,說明用途是「一次性實驗」;而環境變數參考則表示,只有在設定流程註冊自訂端點提供者設定後,ANTHROPIC_BASE_URL 才會啟用。在目前的 main 上,權杖部分永遠不會到達請求:上方連結的 Claude 提供者檔案只會向 .env 索取 ANTHROPIC_BASE_URL,並將 ANTHROPIC_AUTH_TOKEN 設為字串 placeholder。請將 README 片段視為實驗,正如其標示所述;將上方的設定路徑視為你實際會執行的設定方式。
預設與擴充:每條路徑實際安裝的內容
| 方式 | 取得方式 | 憑證儲存位置 | 新增內容或產生成本 |
|---|---|---|---|
| Claude(預設) | 內建提供 | OneCLI 保存庫,主機模式 api.anthropic.com | Anthropic API 金鑰,或 Pro/Max 訂閱權杖 |
| Anthropic 相容端點 | 兩個設定變數,僅限首次安裝 | 保存庫,依你的主機名稱建立索引 | 你的閘道每權杖費率;NanoClaw 不收取費用 |
| OpenCode | /add-opencode | 保存庫,搭配相符的主機模式——絕不使用 .env | 透過 OpenCode 自己的設定路由:OpenRouter、DeepSeek、OpenAI、Google、Anthropic 或 OpenCode Zen。在固定的強化執行環境安裝中,它會編輯代理程式執行器鎖定檔,因此重新建置會降級為本機建置 |
| Codex | 設定流程的執行環境選擇器會直接安裝,或稍後執行 /add-codex | 保存庫,主機模式為 api.openai.com / chatgpt.com;主機會移除 OPENAI_API_KEY | ChatGPT 訂閱或 OpenAI API 金鑰;ChatGPT 列出的價格為 Go $8、Plus $20、Pro 自 $100 起、Business 每位使用者每月 $20 且按年計費 |
| Ollama(本機) | /add-ollama-provider——請參閱注意事項 | 不適用;依據NanoClaw 的 Ollama 說明,該路徑會設定 NO_PROXY,因此請求會跳過注入憑證的 Proxy | 沒有託管模型費用;改由硬體與營運產生成本 |
來源查核日期為 2026 年 9 月 21 日:NanoClaw 的提供者指南、其 /add-opencode 與 /add-codex 技能檔案、docs/ollama.md,以及ChatGPT 的定價頁面(舊的 Codex 定價 URL 現在會重新導向至該頁面)。第一欄沿用同一份提供者指南;該指南指出,設定流程的執行環境選擇器會提供 Codex 作為內嵌安裝,而 OpenCode 則在設定完成後透過 /add-opencode 新增。Ollama 的注意事項來自供應商自身:提供者指南指出,該技能仍保留在儲存庫中,但針對較舊的設定路徑;這些舊版編輯「不是目前 main 上受支援的即插即用切換」,而且整合需要先移植與測試——但 README 仍將其列為受支援路徑。兩者不一致時,以較新且更具體的提供者指南為準。OpenRouter 透過 OpenCode 後端連接 NanoClaw,而不是透過 Anthropic 基礎 URL;OpenRouter 的常見問答指出,使用卡片購買額度會收取 5.5% 且最低為 $0.80,使用加密貨幣則收取 5%,推理本身不加價。
NanoClaw API 成本估算範例
這是根據所述假設進行的權杖算術,不是實測任務成本,也不是帳單上限。假設一個代理程式群組每天處理 40 個回合,每個回合傳送 30,000 個輸入權杖並回傳 1,500 個輸出權杖,且沒有任何內容由快取提供。費率是目前Kunavo 目錄中每百萬權杖的價格。
| 模型 | 每 1M 的輸入/輸出 | 估計單日 | 估計 30 天月份 |
|---|---|---|---|
| Claude Haiku 4.5 | $0.70 / $3.50 | $1.05 | $31.50 |
| Claude Sonnet 4.6 | $2.10 / $10.50 | $3.15 | $94.50 |
| Claude Sonnet 5 | $1.40 / $7.00 | $2.10 | $63.00 |
| Claude Opus 5 | $3.50 / $17.50 | $5.25 | $157.50 |
三點解讀。第一,Claude Sonnet 5 和 Claude Opus 5 不再使用相同的目錄費率,因此選擇前請直接比較這兩列——若按Anthropic 公布的同一 Opus 5 模型 ID 費率,即每百萬個 token 的輸入費率 $5.00 與輸出費率 $25.00 計算,相同月份工作負載的估算成本為 $225.00。第二,快取比模型列更具影響力,因為同一頁面將快取讀取價格定為基礎輸入價格的 0.1 倍、五分鐘快取寫入價格定為 1.25 倍:如果上述輸入的 70% 是快取讀取,並按目錄中每百萬個 token $0.35 的快取輸入費率計費,則相同的 Claude Opus 5 月份工作負載估算成本為 $78.12,而不是 $157.50。第三,在將任何數字視為預算前,請依你自己的頻道調整回合數——連接繁忙群組聊天的 NanoClaw 代理程式,與連接單一使用者的代理程式,工作負載並不相同。
Kunavo 的目錄金額是計費下限,而不是上限:上游回報費用時,帳單會取目錄成本與上游成本乘以適用加價率兩者中較高者。最低加值金額為預付額度中的$10最低預存額——這是資金最低額度,不是任務費用或訂閱費用。請參閱計費詳細資訊與使用量報告。
最低限度的驗證,以及之後擴充的成本
最便宜且實用的檢查很小:setup/index.ts會註冊一個 verify 步驟,而 /add-opencode 技能本身的驗收方式是傳送一則訊息、確認回覆,然後再傳送第二則訊息以確認工作階段仍可繼續。對於自訂端點,docker exec <container> env | grep ANTHROPIC 應在預留位置權杖旁顯示你的基礎 URL——如果那裡顯示真正的金鑰,表示路徑有問題,而不是設定正確。
接著計算維護成本,因為擴充提供者是固定版本的軟體。NanoClaw 的變更記錄指出,先前的 Codex 固定版本預設使用了 OpenAI 於 2026 年 8 月 31 日從 Codex 退役的模型,而且重新執行 /add-codex 不會為既有安裝重新固定版本——自 v2.4.0 起,目前固定的 @openai/codex 版本為 0.155.1。OpenCode 的固定版本本身也存在來源衝突:儲存庫的技能檔案指出兩個固定版本都必須保持為 1.18.25,而已發布的提供者指南仍寫著 1.4.17。儲存庫是更具體的來源;此外,OpenCode 已另行移轉組織——sst/opencode 現在會以 301 重新導向至anomalyco/opencode,最新版本為 v1.18.31,發布於 2026 年 9 月 14 日。在 OneCLI 1.41.0 上的安裝,如果 OpenCode ChatGPT 登入過期,也需要手動重新驗證。
根據提供者指南,離開 Claude 提供者後,能力會有所變化:OpenCode 和 Codex 都宣告沒有原生斜線指令,兩者都會將後續訊息排入佇列,而不是接受回合中途的輸入;Codex 讀取 AGENTS.md 時上限為 32 KiB,相較之下 Claude 為 4 MiB;只有 Claude 提供者會輪替逐字稿。切換群組時會保留 memory/ 樹狀結構,但不會保留進行中的對話內容,而且變更要到下一次產生容器時才會生效。
將 NanoClaw 指向 Kunavo
Kunavo 為這類用戶端發布了設定參考——Claude Agent SDK 與 Claude Code 指南涵蓋預設執行環境,OpenCode 與 Codex CLI 指南則涵蓋兩個擴充執行環境。這些是已發布的設定參考,不是相容性測試:NanoClaw 尚未在此進行執行環境測試,以上內容全部是對其儲存庫與文件的解讀。嘗試時請保留一條可運作的路徑,執行一項有界限的任務,然後查看你的帳戶記錄。準備好為金鑰儲值時,建立 Kunavo 帳戶。
你是在代理程式之間而非提供者之間做選擇嗎?NanoClaw 與 OpenClaw比較隔離能力與提供者自由度,而OpenCode 定價、Codex 定價與OpenRouter 替代方案涵蓋本頁視為附加項目的三條路徑。Claude Code 定價則更詳細說明預設執行環境本身的計費方式。
常見問題
NanoClaw 的費用是多少?
NanoClaw 本身的費用是 $0。其首頁常見問答表示,它在 MIT 授權下免費且開放原始碼,而且你的代理供應商可能會收取模型使用費;nanocoai/nanoclaw 儲存庫採用 MIT 授權;文件網站自己的頁面索引列出 56 個頁面,其中沒有定價、計費或方案頁面(2026 年 9 月 21 日檢查)。沒有使用者帳戶,也沒有付費層級。你實際需要編列預算的是三件事:你連接的供應商所產生的模型 API 帳單、如果公司超過 Docker 的免費使用門檻則需支付 Docker Desktop 訂閱費,以及在本機執行模型時所需的硬體。另一個專案 Clawland-AI/nanoclaw 是供單板電腦使用的 Python 代理,其硬體成本不屬於本產品。
NanoClaw 可以使用自訂 API 端點嗎?
可以,透過一條有文件記載的路徑:在執行設定前設定 NANOCLAW_ANTHROPIC_BASE_URL 和 NANOCLAW_ANTHROPIC_AUTH_TOKEN(或相應的 --anthropic-base-url 和 --anthropic-auth-token 旗標)。兩者必須同時設定,且只有在尚未存在 Anthropic 密鑰時才會執行該分支;base URL 必須是沒有 /v1 路徑的來源,因為 Anthropic SDK 會自行附加 /v1/messages——Kunavo 自己的 ANTHROPIC_BASE_URL 參考說明了這個陷阱。設定程序接著會將權杖儲存至以該主機名稱為鍵的 OneCLI 保存庫,只將 base URL 寫入 .env,並註冊自訂端點供應商。NanoClaw README 中的兩行 .env 片段在其中被描述為一次性實驗用途;而在目前的 main 中,沒有任何內容會從 .env 讀取 ANTHROPIC_AUTH_TOKEN 值並傳送至上游——Claude 供應商只會從 .env 取得 ANTHROPIC_BASE_URL,並將權杖寫死為 placeholder——因此該片段不是正式環境路徑。Kunavo 尚未對此路徑進行執行階段測試;這是對 NanoClaw 自身文件與原始碼的解讀。
NanoClaw 能與 OpenRouter 搭配使用嗎?
NanoClaw 自己的文件支援的路徑是 /add-opencode,並選擇 OpenRouter 作為 OpenCode 後端,而不是覆寫 Anthropic base URL——OpenCode 會讀取 OPENCODE_PROVIDER、OPENCODE_MODEL 和 OPENCODE_BASE_URL,其金鑰位於 OneCLI 保存庫而非 .env。OpenRouter 自己的 NanoClaw works-with 頁面(openrouter.ai/works-with-openrouter/nanoclaw,2026 年 9 月 21 日檢查)是三步驟的目錄佔位頁——建立帳戶、加入額度並建立金鑰,然後在 NanoClaw 中設定——其中沒有列出環境變數、設定檔或模型 ID,且仍連結至舊的 qwibitai 位址,因此不能作為經測試整合的證據。至於成本,OpenRouter 的常見問答表示,推理費用不加價;使用卡片購買額度時收取 5.5% 且最低為 $0.80、使用加密貨幣時收取 5%,以及在每月免費額度以上使用自帶金鑰時收取 5%(2026 年 9 月 21 日檢查)。
NanoClaw 最適合使用哪個 API?
這取決於你要支付哪個執行階段,因為 NanoClaw 的預設並不是一般性的供應商清單。開箱即用時,它會透過 Anthropic Claude Agent SDK 在容器內執行 Claude Code,因此選項是 Anthropic API 金鑰、Claude 訂閱權杖,或透過設定註冊的 Anthropic 相容端點。除此之外,供應商指南指出,設定程序的執行階段選擇器可以內嵌安裝 Codex,而 OpenCode 則在設定後透過 /add-opencode 加入;Ollama 工作流程則被標示為舊版——每個替代方案都有自己的憑證介面、固定的 CLI 版本和維護需求。當你想使用供應商自己的快取與批次折扣時,直接使用供應商金鑰較適合。當你想在不同模型系列間共用一把金鑰和一個餘額時,閘道較適合。當你每天大量使用且偏好固定費率時,訂閱較適合。本機模型適合需要隱私或小型工作的情境,且不會按請求收費;但 NanoClaw 的文件目前將其 Ollama 技能標示為舊版,並非目前 main 上受支援的即插即用切換。
NanoClaw 最便宜的 API 是哪個?
列出的費率最低,與完成工作的方式最便宜,是兩個不同問題;對長時間執行的訊息代理而言,差距主要來自快取。Anthropic 的定價頁面指出,對本頁列出價格的 Claude 模型,快取讀取價格為基礎輸入價格的 0.1 倍,五分鐘快取寫入價格則為 1.25 倍。因此,若代理每回合都重新傳送大型且穩定的提示,快取行為對帳單的影響會大於模型層級調整一級。有一條文件記載的路徑會失去這項優勢:NanoClaw 自己的 Ollama 備註(docs/ollama.md)指出,Claude Agent SDK 會在每個請求前面加上該請求專屬的雜湊值,使 Ollama 的提示快取失效,除非你在前方執行過濾代理;同一份備註也指出 Codex 和 OpenCode 永遠不會產生該雜湊值。請選擇能在不重試的情況下完成回合的最低價模型,然後查看你的供應商帳戶實際記錄的內容。
NanoClaw 最適合使用哪個模型?
在預設的 Claude 供應商上,群組的模型可接受別名 sonnet、opus 或 haiku,也可接受完整模型 ID,effort 則可設為 low、medium、high、xhigh 或 max;未設定模型時,會回退至 NANOCLAW_DEFAULT_MODEL,然後再回退至 SDK 預設值。這表示模型選擇是每個群組可調整的設定,能依代理分別微調,而不是單一全域決策。關於費用,有兩點實務注意事項。Kunavo 的目錄將 Claude Sonnet 5 列為每百萬個 token $1.40 / $7.00,將 Claude Opus 5 列為 $3.50 / $17.50,因此在假設費用會往哪個方向變動前,請先確認兩者。 而 NANOCLAW_FAST_MODE 的文件說明,將其設為 1 或 true 可啟用 Claude 的快速服務層,並明確指出這可能改變供應商計費方式——Anthropic 的定價頁面將該層級描述為處於研究預覽階段,Claude Opus 5 和 Claude Opus 4.8 的價格為每百萬個輸入 token $10、每百萬個輸出 token $50,且僅適用於第一方 Claude API(2026 年 9 月 21 日查閱)。NANOCLAW_DEFAULT_MODEL 和 NANOCLAW_FAST_MODE 都在 2026 年 9 月 23 日的 v2.4.0 中發布(2026 年 9 月 24 日查閱),而預設模型是全安裝共用的,因此沒有自行設定模型的 Codex 和 OpenCode 群組也會使用它。
撰寫本頁時於 2026 年 9 月 21 日直接取得:nanocoai/nanoclaw 儲存庫記錄與版本發布清單、package.json、container/cli-tools.json、README、強化映像檔文件、nanoclaw.dev、文件索引、憑證、環境變數與提供者頁面、docs/ollama.md、變更記錄、/add-opencode 與 /add-codex 技能檔案、OneCLI 儲存庫,以及 Anthropic 的定價頁面。Docker、Claude 訂閱、ChatGPT 與 OpenRouter 的金額,是引用同日記錄的各供應商定價頁面,而非在此重新取得,因此請在供應商結帳頁面確認。Kunavo 權杖費率來自目前的目錄。v2.4.0 發布版本、其變更記錄、container/cli-tools.json 與環境變數參考,已於 2026 年 9 月 24 日重新查核,當時加入了模型固定版本。本頁內容未針對 NanoClaw 安裝進行執行環境測試,所有美元數字都是示意性的權杖算術。