PicoClaw 定價與 API 設定：模型、通訊協定與金鑰

PicoClaw 軟體免費：儲存庫採 MIT 授權，而 picoclaw.io 自己的常見問題寫道「軟體是免費的。您只需支付 LLM API 使用費」——因此「PicoClaw 定價」指的是您的模型 API 帳單，加上裝置本身的任何費用。 Sipeed 未宣傳 PicoClaw 訂閱或託管方案。值得預算的數字是每個代理程式回合的權杖數，而最可能令人意外的設定是 PicoClaw 的工具迭代上限：欄位缺少時為 50，隨附的範例設定中為 20。

先釐清兩點，因為結果頁面將它們混在一起。官方網域是 picoclaw.io——它是 homepage（github.com/sipeed/picoclaw）的官方網域。仿冒網站 pico-claw.com 在自己的頁尾表示「與 Sipeed 或 PicoClaw 沒有官方關聯」，其上的每月套裝價格屬於該網站自己的託管模組，而不是 PicoClaw。第二個仿冒網站 picoclaw.net 也不是官方網域。它以「95% AI 生成程式碼」和「支援 3 種架構」為主標——x86_64、ARM64 與 RISC-V——而 picoclaw.io 的常見問題列出六種。PicoClaw 也不是 OpenClaw 的分支；它是獨立的 Go 實作，並以 OpenClaw 和 NanoBot 作為基準比較對象。

PicoClaw 定價，逐項說明

全部於 2026 年 9 月 21 日查核。記錄版本：最新標記版本是v0.3.1，發布於 2026 年 7 月 3 日，而儲存庫最後一次推送是在 2026 年 9 月 17 日——因此 main 上的程式碼領先於該標記，而 README 自己的新聞清單更為過時，最新發布項目仍是 2026 年 5 月 28 日的 v0.2.9。以下每項行為均讀取自 main，而不是您會下載的 v0.3.1 二進位檔；使用標記版本的讀者可能會看到不同結果。查核日的一項即時狀況：picoclaw.io 的 TLS 憑證已過期（有效期為 2026 年 2 月 25 日至 9 月 10 日），因此瀏覽器在官方下載頁面上會顯示安全性警告。這可能隨時修復，且不代表專案有問題；GitHub Releases 不受影響。

PicoClaw API 金鑰設定：model_list 與 .security.yml

picoclaw onboard會建立~/.picoclaw/config.json與工作區。模型會在model_list陣列中宣告，並從agents.defaults.model_name依名稱選取；兩者必須相符，這是 PicoClaw 疑難排解文件涵蓋的唯一情況。

{
  "agents": {
    "defaults": {
      "model_name": "gateway-sonnet"
    }
  },
  "model_list": [
    {
      "model_name": "gateway-sonnet",
      "provider": "openai",
      "model": "claude-sonnet-4-6",
      "api_base": "https://api.kunavo.com/v1",
      "enabled": true
    }
  ]
}

金鑰位於第二個檔案中。PicoClaw 的安全性文件將 config.json稱為「主要設定（可安全分享）」，將 .security.yml稱為「安全資料（永不分享）」，並告訴您要對 chmod 600執行該操作。YAML 結構是由 model_name鍵控的對映，而不是 config.json 使用的陣列；即使只有一把金鑰，api_keys仍是複數形式且必須是陣列。

# The map key must equal the model_name in config.json.
# api_keys is plural and is an array even for one key.
model_list:
  gateway-sonnet:
    api_keys:
      - "sk-kn-..."

有四個細節容易讓人困惑。provider是選用的：設定後，model會原封不動地傳送至上游；省略後，PicoClaw 會將model中第一個 /之前的所有內容讀作供應商，這是舊版的 protocol/model形式。設定採用結構描述版本控制，目前版本為 3；遷移會建立附日期的備份，而文件警告 V3 檔案無法由僅支援 V2 的舊版建置安全載入。在 V1 到 V2 的遷移期間，enabled會自動推斷——沒有 API 金鑰且名稱不是 local-model的項目，預設為停用——因此上述範例會在金鑰移至 .security.yml後，明確設定 enabled。串流預設為關閉，且受兩重條件限制：模型項目的 streaming.enabled與通道的 settings.streaming.enabled都必須為 true。

在您寫入項目之前，有一項界線值得先說明：PicoClaw 的供應商表將 Groq 列為「LLM + 語音轉錄（Whisper）」，而 Kunavo 不提供語音轉文字、文字轉語音或嵌入功能——轉錄或嵌入項目必須指向其他供應商，只有聊天項目適合使用 Kunavo 金鑰。

協定名稱顛倒了，而這就是整個陷阱

在 PicoClaw 中，anthropic表示透過 OpenAI 線路格式傳送 Claude 形狀的模型，而anthropic-messages表示 Anthropic 的原生 Messages API。文件明確寫道：「anthropic協定使用 OpenAI 相容格式（/v1/chat/completions），而 anthropic-messages使用 Anthropic 的原生格式（/v1/messages）。」來源也一致——factory_provider.go會為 anthropic建立共用的 OpenAI 相容 HTTP 供應商，並為 anthropic-messages建立獨立的原生供應商。PicoClaw 自己的「所有支援的供應商」表卻同時與兩者矛盾，將 anthropic列的協定欄標為「Anthropic」；只閱讀該表的讀者會設定錯誤的協定。

於 2026 年 9 月 21 日讀取 main 分支上的 openai_compat/provider.go、common/anthropic_common.go、anthropic_messages/provider.go 與 factory_provider.go——根據程式碼推導，並非在線路上觀察到。具體後果是：您無法將 anthropic 或 anthropic-messages 指向路徑不得以 /v1 結尾的閘道，因為 PicoClaw 無論如何都會附加它。位於 https://gw.example.com/anthropic 的閘道會變成 https://gw.example.com/anthropic/v1/messages。對於這類端點，原樣使用路徑的 openai 協定是唯一能表達該 URL 的協定。只查核了這三種協定；不要將此規則推廣到 gemini、azure 或其餘協定。

原生途徑還有兩項限制，都可從同一個檔案中讀到。anthropic-messages 需要 API 金鑰，若未提供就會直接報錯，因此無法透過它進入 OAuth 分支；factory_provider.go 將該分支連接至 anthropic 和 openai，並同時連接 CLI 橋接層與 antigravity。此外，雖然 factory_provider.go 中有五個分支會傳遞 cfg.CustomHeaders，但 anthropic-messages 分支並不在其中：其建構函式只接受金鑰、基底 URL、使用者代理及逾時設定。因此，文件中所述、供使用非標準驗證方式的閘道採用的 custom_headers 替代途徑，似乎只能通往 OpenAI 相容協定，而無法通往原生 Messages 協定。這是根據原始碼閱讀所得的判斷，並非執行階段測試結果。原生途徑不會讓你失去的是工具呼叫功能：它會使用 input_schema 建立原生 tools，並處理 tool_use 和 tool_result 區塊。

對 Kunavo 而言，文件記載的兩個基礎 URL 分別是聊天完成的 https://api.kunavo.com/v1與 Messages 路由的 https://api.kunavo.com/v1/messages；Kunavo 的 Messages 處理程式也會從 x-api-key以及 Authorization: Bearer讀取金鑰。從文件表面看，這兩者從兩個方向都符合 PicoClaw 的 URL 算術。這是對兩組文件所做的算術——此處未向 Kunavo 發出任何 PicoClaw 請求，本頁也未聲稱任何 PicoClaw 協定已在其上測試。請參閱Anthropic 基礎 URL 文件與聊天端點文件以了解確切結構，然後自行傳送一次範圍受限的請求。

PicoClaw API 成本估算範例

這些是示意性的權杖算術，不是實測工作成本，也不是帳單上限。假設一個代理程式回合在8 個工具回合後完成，其中每一回合重新傳送平均12,000 個輸入權杖的逐字記錄，並回傳700 個輸出權杖。這些比例只是示意假設。第二欄以相同形狀執行到 pkg/config/defaults.go中編譯內建的 max_tool_iterations預設值50；該值在欄位缺少時套用——隨附的 config/config.example.json寫入 20，因此在將 50 視為上限前，請先讀取您自己的檔案。費率是Kunavo 目錄中每百萬權杖的即時價格。

請將兩欄視為同一項事實。從 8 回合增加到 50 回合上限，會使每一列都乘以相同的 6.25倍，因為迴圈長度與費率無關：一次 Claude Sonnet 4.6回合在 8 回合時是 $0.260，在上限時是 $1.627；而同一上限下，Claude Haiku 4.5是 $0.542。因此，在尋找更低費率前，請先將 max_tool_iterations限制在您實際觀察過的數字；它位於 agents.defaults之下，並可由 PICOCLAW_AGENTS_DEFAULTS_MAX_TOOL_ITERATIONS環境變數覆寫。然後再依每日回合數縮放。

Kunavo 的目錄金額是計費下限，而不是上限：上游回報費用時，帳單金額取目錄成本與上游成本乘以適用加成兩者中的較高者。快取讀取與寫入會依各自費率計費，本文兩個方向都未建模，外部工具呼叫也不包含在此範例中。最低儲值是預付額度 $10，這是資金下限，而不是工作費用或訂閱——請參閱計費詳細資訊與AI 成本最佳化了解測量方法。

PicoClaw 的最佳 API：各路由在何種情況下勝出

這裡不以供應商數量作為比較軸：PicoClaw 自己的檔案集合對於有哪些供應商彼此矛盾，因此重述其 README 所說的「30+ 個 LLM 供應商」是最穩妥的做法。若要了解 PicoClaw 在其他單一二進位檔代理程式中的位置，AI 代理程式 API 目錄會將它的設定介面與其他代理程式並列，而OpenRouter 替代方案則依資金條款比較閘道路由，而不是整合深度。

第一次請求、第一個工具回合，以及 404

執行一項範圍受限的工作，並依序閱讀三件事。model_list 中找不到模型是文件記載的情況，原因是名稱不相符：agents.defaults.model_name必須等於一個 model_name項目，而未設定 provider的未加前綴 ID 不會選取您想要的供應商——它會退回 openai協定；文件記載的 "model": "free"情況是 OpenRouter 收到字面上的 ID free並拒絕它。第一次請求收到 404表示您選錯 Anthropic 協定——PicoClaw 自己的指南表示，當「現有的 anthropic協定回傳 404 錯誤（表示端點不支援 OpenAI 相容格式）」時，應改用 anthropic-messages。在進行其他變更前，先對照上表檢查組合後的 URL；這沒有官方疑難排解條目，因此該診斷來自供應商註記與來源，而不是支援頁面。第三，如果純聊天正常但第一個工具回合失敗，請懷疑結構描述嚴格性，而不是認證：PicoClaw 預設會原封不動轉送工具結構描述，而 tool_schema_transform: "simple"是每個模型的選用停用設定，適用於拒絕 $ref、$defs、anyOf、oneOf、allOf或 pattern的端點。

Kunavo 未發布 PicoClaw 設定頁面，也未進行任何 PicoClaw 相容性測試；試用時請保留可運作的路徑，然後讀取帳戶實際為該工作記錄的費用，不要依本頁估算。準備為金鑰儲值時，請建立 Kunavo 帳戶；若您已決定使用 Claude 系列，請在最便宜的 Claude API比較模型費率。

常見問題

於 2026 年 9 月 21 日檢查：GitHub 儲存庫與 releases API、picoclaw.io（因其憑證已過期，在停用憑證驗證的情況下讀取）、README、docs/guides/providers.md、docs/security/security_configuration.md、docs/reference/config-versioning.md、docs/guides/configuration.md、docs/operations/troubleshooting.md、config/config.example.json，以及分支 main 上的七個原始碼檔案——factory_provider.go、openai_compat/provider.go、common/anthropic_common.go、anthropic_messages/provider.go、provider_metadata.go、pkg/config/defaults.go 和 pkg/config/config.go——另加兩個相似網域。未檢查：PicoClaw 自有比較表中的第三方配額、零售硬體價格，以及 v0.3.1 發行說明。未安裝或執行任何內容：未向任何端點發送 PicoClaw 請求。Kunavo 的 token 費率來自即時目錄，本頁所有美元範例都是用於說明的 token 費用計算，而非實測的任務成本。