ZeroClaw API 費用與設定：免費執行環境、自訂提供者、實際 token 費用

ZeroClaw 執行環境的成本為 $0：它是開放原始碼，採 MIT OR Apache-2.0 雙重授權，而 zeroclaw.com 自己的 FAQ 表示沒有訂閱方案，也沒有代管席位——你只需支付自己的 LLM 提供者費用；如果使用 Ollama 執行本機模型，則完全不需支付費用。 專案的理念文件說得更直接：「不是 SaaS。沒有代管版本、沒有帳戶系統、沒有計費。」因此，實務上的「ZeroClaw 定價」代表另外兩筆費用——你將別名指向的端點所產生的模型 token 費用，以及執行 daemon 的機器費用。兩者均已於 2026 年 9 月 21 日查核。

如果略過以下兩件事，你會付出金錢或時間成本。ZeroClaw Labs 完全沒有公布月費，因此你已經看過的每月「ZeroClaw」訂閱方案是其他人的產品。而在你手動輸入費率之前，ZeroClaw 自己的成本帳本會對第三方閘道回報 零支出，因為 custom 提供者插槽背後沒有價格目錄。以下將涵蓋這兩點。

ZeroClaw 定價：軟體成本與實際向你收費的項目

最後一列是搜尋「zeroclaw pricing」時可能導向的錯誤依據。ZeroClaw 的 README 將 github.com/zeroclaw-labs/zeroclaw 列為唯一官方儲存庫，並聲明任何其他聲稱是 ZeroClaw 的儲存庫、組織、網域或套件，均未獲授權且沒有關聯。搜尋摘要中也流傳 zeroclaw.live 的另一個每代理程式月費數字；但該網站在 2026 年 9 月 21 日回傳錯誤而非頁面，因此無法在頁面上讀取該數字，本文刻意不重新刊載。另一方面，即使是在專案本身使用的網域上，也應謹慎看待行銷數字：zeroclaw.dev、zeroclaw.org 與 zeroclaw.net 的登陸頁面都宣稱二進位檔大小為 3.4MB，而專案的 自身理念頁面則表示典型發布版本約為 26 MiB。這是文件與登陸頁面之間的差異，而不是冒名的證據——README 本身也將安全性報告導向 zeroclaw.dev 的地址。ZeroClaw 與 OpenClaw 詳細說明了這個識別問題。

這裡補充一項範圍說明，因為這兩項事實看似互相矛盾。「沒有計費」適用於 ZeroClaw 執行環境，但不適用於 ZeroClaw Labs 組織本身：同一個 GitHub 組織推出了 ZeroRouter，這是一個 AGPL 閘道，其儲存庫說明列出了預付式 Stripe 計費，並可透過 ZeroClaw 自己的 zerorouter 插槽使用。它是處於 beta 的不同產品，不是 ZeroClaw 訂閱方案；其代管價格是即時閘道狀態，而非公布的價格表。

今天應採用的設定檔結構：schema 3，而不是扁平片段

官方文件是最新的；你在搜尋結果中找到的大量 ZeroClaw 設定資訊並不是。目前的設定檔 schema 版本是 3——v0.8.5 發布標籤中的 CURRENT_SCHEMA_VERSION: u32 = 3 位於 crates/zeroclaw-config/src/migration.rs，遷移鏈為 V1 到 V2 再到 V3。舊教學中流傳的扁平結構是 schema 1。沒有 schema_version 的設定檔會被視為版本 1，並在載入時於記憶體中遷移，因此載入本身不會改寫磁碟上的檔案。

請注意命名：「ZeroClaw V3」並不是發行版本。最新的發行版本是 v0.8.5，於 2026 年 9 月 5 日發布（資料來源為 GitHub API，於 2026 年 9 月 21 日查核）；schema 3 是該版本內使用的設定格式。這兩個數字互不相關。

Schema-1 欄位名稱取自 v0.8.5 的 V1 遷移解析結構；schema-2 列則取自 master 上 V2 遷移解析結構的文件註解，兩者均查核於 2026 年 9 月 21 日。這些解析結構是舊檔案在遷移期間被解析為的形式，因此是舊欄位名稱的可靠證據。最後一列的兩個來源因撰寫時間不同而說法不一致：V2 遷移解析結構記錄 V3 捨棄了 cost.prices，並將定價內嵌至每個模型提供者；而目前的 成本追蹤文件則將這個每別名內嵌的 pricing 欄位稱為舊式欄位，並指出 [cost.rates.*] 是未來應採用、且發生衝突時優先採用的介面。請寫入 [cost.rates.*]。

在 schema 3 中，每個模型提供者都位於 [providers.models.<type>.<alias>]，其中 type 是標準系列插槽——「每個廠商只有一個插槽，不使用同義名稱」——而 alias 則由你命名。提供者概覽明確指出「沒有全域的『預設提供者』或『預設模型』設定」，並且若任何參照無法解析，Config::validate() 會在啟動時直接失敗。複製的 schema-1 片段不會因為過時而被拒絕——遷移鏈會將其頂層 api_key、api_url 與 default_model 折疊至由 default_provider 指定名稱的提供者項目中；若該鍵不存在，V1 lens 會代用 openrouter，因此只帶有金鑰與 URL 的扁平片段會落到 openrouter 項目，而不是你原本要使用的閘道。失敗模式是參照無法解析，而不是欄位名稱過時。

ZeroClaw 自訂提供者：將別名指向 OpenAI 相容 API

支援 OpenAI chat-completions 的端點應放在 custom 插槽；v0.8.5 的 自訂提供者頁面表示，這只需修改設定：「custom 插槽要求 uri（該系列的端點列舉沒有預設值）。」支援 Anthropic Messages wire 的端點則應放在 anthropic 插槽，並將 uri 設為 override，而不是放在 custom。Kunavo 在 https://api.kunavo.com/v1 下以同一個金鑰提供兩種 wire 形式，因此從理論上來說兩個插槽都適用。以下片段將文件所述的自訂插槽欄位，與文件自身工作範例中的四標頭結構合併；這是改編內容，不是複製的官方區塊。

# 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

四項實務注意事項。憑證可透過四種方式提供——內嵌的 api_key、1Password 的 op://vault/item/field 參照、位於 ~/.zeroclaw/secrets 的加密儲存區，或通用的環境變數覆寫 ZEROCLAW_providers__models__custom__kunavo__api_key，其中兩個底線會對應至一個點。除非提供者系列在文件中說明自己的原生環境變數橋接，否則像 $ANTHROPIC_API_KEY 這類生態系預設的 shell 名稱不會直接讀取——文件要求你自行將其展開為 schema-mirror 名稱；而 schema-mirror 環境變數只是執行階段注入，永遠不會成為持久設定。custom 插槽預設使用 chat-completions wire；在可自帶端點的系列（openai、llamacpp、custom）中會採用 wire_api，而品牌廠商插槽使用固定 wire 並忽略它，opencode 是唯一列出的例外。如果你的閘道拒絕 temperature 欄位，請不要設定它：文件指出，未設定的 temperature 會完全從請求本文中省略。而乾淨啟動所證明的事情比看起來少——連線預熱是一個會讀取消耗本文並接受非成功狀態碼的 GET，因此 daemon 無論如何都會啟動；master 上的自訂提供者頁面將其記錄為 GET {base_url}/models，但 v0.8.5 程式碼實際預熱的是 chat-completions URL。

請依文件所述順序驗證，三項指令均針對 v0.8.5：zeroclaw config list 會載入設定並將驗證失敗輸出至 stderr，zeroclaw models refresh --model-provider custom.kunavo 會列出端點所宣告的內容，而 zeroclaw agent -a assistant -m "hello" 會對代理程式進行冒煙測試。Kunavo 自己的 /v1/models 在沒有金鑰時會回應 HTTP 401（已於 2026 年 9 月 21 日驗證），這不是阻礙：refresh 指令會傳送該別名的金鑰。Kunavo 尚未對 ZeroClaw 進行執行階段測試——本節全部內容都是對 ZeroClaw 原始文件的審閱，因此請先自行執行一項有界任務，再信任這條路徑。

Kunavo 不提供 embedding、文字轉語音或語音轉文字模型，因此需要這些步驟的代理程式，無論聊天模型位於哪個 ZeroClaw 插槽，都必須將它們指向不同的端點。

在你寫入費率表之前，成本計量器會顯示 $0

ZeroClaw 會計量自己的支出，而在第三方閘道上，該計量器一開始會是錯的。成本追蹤由 cost.enabled 控制，記錄會寫入 <workspace>/state/costs.jsonl 的只能附加帳本，每行一個 JSON 物件。問題在於價格來源。在 v0.8.5 的 catalog.rs 中，catalog_source_for 不會為 custom 系列傳回 models.dev 金鑰或 OpenRouter 廠商前綴——大多數品牌插槽至少具備其中一項，但若干插槽（zerorouter、telnyx、nearai）兩者皆無。live_pricing 選用功能預設關閉；開啟後會先讀取端點自己的 /models 清單，再回退至以該系列 models.dev 名稱為索引的 models.dev；custom 系列沒有這類金鑰，因此對此插槽而言，端點自己的清單是唯一來源。Kunavo 的清單不包含每 token 價格欄位；該資訊是從路徑來源讀取，而不是從經驗證的生產回應中取得。因此，自訂插槽別名會記錄 cost_usd = 0，且 unpriced_tokens 大於零，直到你自行輸入費率。

[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

由此會產生三項行為，全部來自於 成本追蹤文件，並已於 2026 年 9 月 21 日查核。費率項目以使用量遙測中出現的 上游模型 ID作為索引，而不是你的別名。預算比較使用已記錄的 cost_usd，因此當該月份包含未定價 token 時，每日或每月總額低於上限並不代表安全保證。而且既有帳本列永遠不會重新定價：「不會追溯重新定價」，因此費率只適用於設定完成後發出的請求。預算限制的強制執行有三種模式——warn（預設）、block，以及會改用較便宜的 route_down_model 的 route_down——另有 allow_override，預設為 false，允許請求透過 CLI 上的覆寫 token 繞過 block。

以 ZeroClaw 自己的每日上限進行估算範例

這是示意性的 token 算術，不是經測量的任務成本，也不是帳單上限。文件中的 [runtime_profiles] 工作範例將代理程式限制為 max_actions_per_hour = 10 與 max_cost_per_day_cents = 100——這些是小型本機模型的範例值，不是預設值。若每天有 8 個活躍小時，請將此上限直接解讀為：每天 80 個回合，每個回合傳送 6,000 個未快取輸入 token，並回傳 500 個輸出 token。費率是每百萬 token 的即時 Kunavo 目錄價格。

有用的解讀不在於排名，而在於它與上限的互動。為小型本機模型撰寫的設定檔，會將前沿模型置於相同上限之下：max_actions_per_hour限制回合量，而每日成本上限只有在 enforcement.mode 為 block 時才會拒絕請求。在預設的 warn 下，上限完全不會阻擋請求——它只記錄事件並讓請求通過。（warn_at_percent 預設為 80%，是另一項設定：它控制閘道何時在硬性上限前顯示警告橫幅。）更糟的是，如果你從未寫入上方的費率表，這些機制都不會觸發，因為上限看不到未定價的 token。在將其視為預算之前，請依你自己的回合量與輸入輸出比例縮放表格；其中不包含快取費用、工具呼叫與重試，並假設較便宜的模型能在不需額外嘗試的情況下完成工作。

Kunavo 的目錄金額是計費底線，而不是上限：上游回報其費用時，帳單金額會取目錄成本與上游成本乘以適用加成兩者中較高者。最低加值金額為預付額度中的 $10，這是資金最低門檻，而不是任務費用或訂閱費——請參閱 計費詳細資訊。

ZeroClaw 的最佳模型與最佳 API：專案會告訴你什麼、不會告訴你什麼

ZeroClaw 沒有發布推薦模型，也拒絕正式做出推薦。其 多模型設定頁面指出：「此工作流程不會建立 ZeroClaw 驗證過的模型清單」，並且「針對某一組建置、模型、量化方式與上下文設定取得的證據，無法驗證其他組合」。這就是對「ZeroClaw 最適合哪個模型」的誠實回答：沒有可引用的官方排名，因此請根據兩項可測試的特性進行選擇。

第一項是原生工具呼叫，同一頁面也為此設定了嚴格標準：「檢查執行過程，確認有實際的工具呼叫、其執行結果，以及使用該結果的 assistant 後續回應。合理的答案或僅輸出的工具呼叫標記，不足以通過工具測試。」執行階段設定 strict_tool_parsing 會將看似 XML 或 JSON 的回退文字視為普通 assistant 文字，除非提供者傳回真正的工具呼叫，因此只描述工具呼叫的模型看似正在運作，卻永遠不會採取行動。第二項是模型能否在不需額外嘗試的情況下完成你的任務——這就是列出的最低價格與完成任務的最低成本是不同說法的原因。

啟用容錯移轉前，有兩種行為值得先編列預算。串流的契約較為嚴格：provider-routing-lifecycle 頁面指出，包裝器會「選擇第一個支援所要求串流能力且未處於冷卻狀態的排序項目」，接著「只開啟該串流一次」，並且「串流開始後不會切換項目」——但若串流在任何輸出提交之前失敗，會透過非串流路徑重試；該路徑會重新進入對 fallback_models 與 fallback 執行的完整可靠性檢查。這些非串流重試涵蓋逾時、連線錯誤、429 與 503，明確不涵蓋 400、永久性驗證失敗或模型輸出錯誤。此外，備援項目可能會將工作移至不同價格層級，因此請先為此編列預算。如需更廣泛比較各閘道路徑，請參閱OpenAI 相容 API 指南與OpenRouter 替代方案。

固定工作：風險設定檔、上限，以及重新啟動它的服務

自主性是以代理程式為單位，而非全域設定。v0.8.5 的 自主性頁面只接受三個層級——readonly、supervised 與 full——並會在載入設定時拒絕帶有底線的 read_only。在預設的 supervised 下，低風險工具會自動執行，中風險工具會提出操作員核准提示，高風險工具則會被封鎖。核准提示會在該通道的 approval_timeout_secs 後逾期；大多數通道為 120 秒，而逾時會視為拒絕——因此無人看管的代理程式會安全地拒絕執行，而不是排入佇列。

固定工作有兩個界線。重新啟動行為並非所有平台都一致：已安裝的 systemd 使用者單元設定了 Restart=always 與 RestartSec=3，且沒有退出碼允許清單，因此設定錯誤而快速失敗的常駐程式會反覆啟停；macOS LaunchAgent 設定了 RunAtLoad 與 KeepAlive；Windows 上的 zeroclaw service install 會註冊一個 ONLOGON 工作排程器工作，在登入時啟動常駐程式，但不會加入失敗時重新啟動的原則。排程工作本身是宣告式的，並以 [cron.<alias>] 中的別名為鍵，與 [scheduler] 區段自身的設定分開。此外，專案自己的功能矩陣將確定性 SOP 引擎標示為實驗性——周邊裝置與行事曆觸發條件已定義並完成比對，但尚未路由至即時來源——因此目前不要以它為基礎設計無人看管的工作流程。

完成設定並檢查第一筆費用

Kunavo 沒有發布 ZeroClaw 專用整合頁面，也未對該用戶端進行執行期測試，因此請將上述設定視為來源文件路徑，而非相容性結果。實際步驟很短：建立金鑰、儲值最低額度、寫入四個標頭、依序執行三個驗證指令，接著在第一次長時間執行之前寫入 [cost.rates.*] 區塊，讓帳本有可記錄的內容。請從快速入門取得基礎 URL 與金鑰格式，從聊天完成參考了解 custom 插槽所使用的線路，準備儲值時則建立 Kunavo 帳戶。如果您的代理程式使用 Anthropic 線路，Anthropic 基礎 URL 文件涵蓋 anthropic 插槽路徑。

常見問題

已於 2026 年 9 月 21 日檢查。本頁直接重新閱讀的資料包括：zeroclaw.com 的常見問題、儲存庫 README、用於確認儲存庫狀態與 v0.8.5 發行版的 GitHub API、v0.8.5 標籤中的 migration.rs、schema/v1.rs、catalog.rs、compatible.rs、providers/custom.md、security/autonomy.md 與 ops/service.md，以及 master 上的 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 與 reference/feature-matrix.md；此外還包括 zerorouter 儲存庫、上述提及的第三方與登陸頁面網站，以及對 Kunavo 的 /v1/models 所執行的未經身分驗證的 GET 請求。凡引用 master 的內容都是開發分支文件，進度可能超前於穩定版本。Kunavo 未對 ZeroClaw 進行執行期測試：未執行安裝、config list 或代理程式執行，因此透過此路徑的串流、原生工具呼叫與視覺能力在此均未經驗證。Kunavo 的權杖費率取自即時目錄，本頁每個美元數字都只是說明性的權杖算術。