IronClaw 以一個四欄位區塊接收自訂 API：位於 ~/.ironclaw/reborn/config.toml 的 [llm.default] 區塊，包含 provider_id、base_url、model 與 api_key_env；如果不存在區塊，則退回使用 LLM_BACKEND / LLM_BASE_URL / LLM_API_KEY 環境變數。兩種形式目前都有效且有文件記載。設定頁面未集中列出的，是自訂端點因此無法取得的功能清單——包括原生串流、模型探索、Anthropic cache_control 斷點與準確的成本顯示；在選擇供應商前，這份清單值得先閱讀。
先釐清一點，因為搜尋結果大多被其他產品占據。本頁討論的是github.com/nearai/ironclaw；其儲存庫中繼資料自述「IronClaw 是一個專注於隱私、安全性與可擴充性的代理程式作業系統」：使用 Rust、未封存且不是 fork，擁有 12,626 顆星，建立於 2026 年 2 月 3 日，最後推送於 2026 年 9 月 21 日（GitHub API，同日）。它不是同名的 Corsair 電競滑鼠、Sanguine Productions 桌上角色扮演遊戲、IRONCLAW 加密代幣，也不是無關的 JoasASantos/ironclaw 儲存庫——這些產品的價格或設定都不應出現在本頁。標準文件位於 docs.ironclaw.com 與儲存庫自身的 docs/ 樹狀目錄；第三方 Mintlify 鏡像站也會針對相同標題排名，且可能已過時。
值得引用原文而非改寫歸屬資訊，因為供應商自身的頁面說法不同：ironclaw.com 在 NEAR 標誌旁放置「Built by」，正文寫著「Near Foundation」，頁尾則寫「— by NEAR AI」；GitHub 組織則是 nearai。
最精簡的 IronClaw 自訂供應商設定
ironclaw_config 中的區塊結構恰好接受四個選填欄位，其自身的文件註解將這些欄位描述為型錄項目的覆寫值：model 覆寫供應商的 default_model，api_key_env 覆寫其 api_key_env，而 base_url 覆寫其 default_base_url。供應商文件補充說，base_url「在你需要透過代理或區域端點路由時，也適用於任何其他供應商」——因此這不只是通用介面卡的功能。
[llm.default]
provider_id = "openai_compatible"
base_url = "https://api.kunavo.com/v1"
model = "claude-sonnet-4-6"
api_key_env = "LLM_API_KEY"三項關鍵規則。省略 base_url 會造成致命錯誤，不會採用預設值：文件說這會「使區塊無指向任何位置，模型解析失敗」，而 openai_compatible 型錄項目包含 base_url_required: true。api_key_env 接受的是變數名稱，絕不是金鑰——貼上的機密值會「在解析時遭拒，而不是靜默接受」，而 ironclaw config set <provider>.api_key 會在輸入時隱藏內容。重新啟動前不會套用任何變更：config set「永遠不會重新啟動任何東西」，它只會列印你仍須執行的 ironclaw service restart 步驟。而且不要期待 config set 替你寫入區塊——設定頁面將 [llm.default] 列在「直接於 config.toml 中編輯」的區段內，且 config set「會拒絕不支援的金鑰，而不是靜默不做任何事」。
當 [llm.default] 不存在時，環境變數形式是文件記載的退回方案，文件也清楚說明了選擇：「兩者都能運作……永久安裝優先使用 TOML 區塊，而一次性執行與容器優先使用環境變數形式。」
export LLM_BACKEND=openai_compatible
export LLM_BASE_URL=https://api.kunavo.com/v1
export LLM_API_KEY=sk-kn-...
export LLM_MODEL=claude-sonnet-4-6
# optional: LLM_EXTRA_HEADERS is the openai_compatible entry's
# extra_headers_env; the timeout is a general .env.example setting
export LLM_EXTRA_HEADERS=X-Title:MyAgent
export LLM_REQUEST_TIMEOUT_SECS=120解析順序為 compiled defaults < config.toml < environment variables < CLI flags，因此已匯出的變數會靜默優先於你剛編輯的檔案。CLI 路徑可完全避免手動編輯：先執行 ironclaw models list，再執行 ironclaw models set-provider <id> --model <model>，最後執行 ironclaw models status。請使用 ironclaw config path 確認路徑，不要盲信任一份文件記載的位置——快速入門頁面表示所有內容位於 ~/.ironclaw 下，而設定與入門頁面則表示位於 ~/.ironclaw/reborn 下。託管使用者有一個操作陷阱：設定頁面指出，ironclaw service 指令「無法在 NEAR AI 託管執行個體上運作——沒有可供它們連線的使用者服務管理員」，因此你必須透過 SSH 登入以執行 ironclaw config，再從 Agent Dashboard 重新啟動。所有引文皆取自 2026 年 9 月 21 日的 main 分支。
自訂端點無法觸及的範圍
這些是 IronClaw 對其預期執行時行為的自行陳述，內容取自 main 上的原始碼與契約檔案。這些並非實際執行結果，而且在讀取時，main 已超前於 1.4.0 發布標籤——根據 GitHub releases API，該標籤於 2026 年 8 月 28 日發布。
| 能力 | 在自訂的 OpenAI 相容插槽上 | 該資訊的陳述位置 |
|---|---|---|
| 原生 SSE 串流 | 否——採用緩衝。僅在「IronClaw 能觀察到具權威性的終止事件」時啟用：NEAR AI、Anthropic OAuth 與 Codex Responses。Anthropic API 金鑰傳輸與 OpenRouter 也採用緩衝 | ironclaw_llm/CONTRACT.md |
| 模型探索 | 否——can_list_models 對 openai_compatible 與 openrouter 均為 false，因此識別碼會完全手動輸入 | assets/providers.json |
| 透過環境變數設定基底 URL | 這一個可以——openai_compatible 宣告了 LLM_BASE_URL。在 26 個目錄項目中，只有 7 個宣告了基底 URL 變數，而它就是其中之一；openrouter、together、fireworks、groq、deepseek、mistral 以及其餘項目都必須使用 config.toml 欄位 | assets/providers.json |
| 依原樣撰寫的工具結構描述 | 否——在供應商邊界會重寫為 OpenAI 嚴格模式：additionalProperties: false，所有屬性都強制納入 required，選用欄位則改為可為 null | ironclaw_llm/CONTRACT.md |
| 提示快取 | 情況混合，並非單純不存在。Anthropic 的 cache_control 中斷點只有兩種 Anthropic 傳輸會發出，因此 OpenAI 相容插槽不會傳送任何中斷點。但 OpenAI 的 prompt_cache_key 確實會傳到該插槽：此旗標由「通用 OpenAI 相容、DeepSeek 與 OpenRouter 工廠設定為 true」，唯一提供值的接點是迴圈主機閘道。至於你的端點之後是否快取任何內容，則是端點自身的行為；IronClaw 不會要求，也看不到這件事 | ironclaw_llm/CONTRACT.md |
| 跨供應商故障轉移 | 否——故障轉移裝飾器透過 NEARAI_FALLBACK_MODEL 在 NEAR AI 模型之間切換；跨供應商類型的切換「需要手動建構」 | ironclaw_llm/CONTRACT.md |
| 工具回合回應快取 | 永不快取——complete_with_tools() 因為具有副作用而被排除 | ironclaw_llm/CONTRACT.md |
| 多使用者安裝中可由使用者選取 | 不會自動完成——「僅設定供應商不會向使用者發布模型」；管理員需在 Settings → Inference → User model access 下加入每個識別碼 | 供應商文件 |
IronClaw 的目錄是聊天目錄，而 Kunavo 不提供嵌入、文字轉語音或語音轉文字模型，因此設定中任何需要這些模型的部分，都必須完全指向其他位置。
IronClaw 顯示的成本不是你的帳單
IronClaw 內部有兩條不同的路徑會計算費用，兩者彼此不一致，而且都不會讀取你的供應商。price_usage() 位於 ironclaw_common 中，會依寫死的每 token 表格定價，並回退至 default_cost()——每個 token 的輸入為 0.0000025、輸出為 0.00001，也就是採用 GPT-4o 形式的每百萬 token $2.50 / $10.00——理由是「新的付費模型絕不會在無聲無息中被定價為零」。另一方面，迴圈主機的 StaticModelCostTable 在預算預留上採取相反做法：表格中找不到的設定檔「會回退至 None，而會計系統將其視為零成本」。而在 llm_costs 路徑上，快取讀取折扣會依模型名稱的子字串猜測——claude 除以十，gpt 或 o1/o3/o4 前綴除以二，其餘則除以一。
實際結果是，IronClaw 的 budget.user_daily_usd、budget.pause_at 及其餘 [budget] 索引鍵管理的是估算值，而非收費金額。對於長時間運作的代理程式，仍值得設定這些值——及早停止失控迴圈正是其用途——但請以供應商記錄的用量核對，而不是以畫面上的數字核對。
代理程式一天的實際估算
這是 token 算術，不是經測量的工作成本，也不是帳單上限。假設代理程式一天的活動總計為 1,000,000 個未快取輸入 token 與 40,000 個輸出 token——這是用於說明的假設，之所以如此選擇，是因為長時間運作的執行環境會透過心跳週期與例行程序累積輸入，而不是透過長篇回覆累積。費率是即時的 Kunavo 目錄每百萬 token 價格。
| 模型 | 每 1M 的輸入／輸出 | 估算的代理程式日成本 | 此識別碼是否符合視覺模式？ |
|---|---|---|---|
| Claude Haiku 4.5 | $0.70 / $3.50 | $0.840 | 是 |
| GPT-5.6 Terra | $0.70 / $4.20 | $0.868 | 否 |
| Claude Sonnet 4.6 | $2.10 / $10.50 | $2.520 | 是 |
| Claude Opus 5 | $3.50 / $17.50 | $4.200 | 是 |
最後一欄才是值得注意的意外，而且它是識別碼字串的屬性，不是模型的屬性。vision_models.rs 會比對固定清單中的子字串，該清單包括 claude-opus-、claude-sonnet-、claude-haiku- 與 claude-fable-，因此這些識別碼會路由影像附件；上表中的其他識別碼均不符合 gpt-4o、gemini-1.5、gemini-2 或清單中的其餘項目，因此會被分類為僅限文字。比對失敗時，迴圈主機閘道會移除影像部分，只傳送訊息文字，且不會引發錯誤——持久化轉錄內容會保留 <attachments> 指標，但模型看不到影像。在假設影像輸入可用前，請先將模式清單與你打算輸入的確切識別碼比對。將美元數字按你自己的天數換算後，再把它們視為預算。Kunavo 的目錄金額是計費下限，而非上限：上游回報其費用時，帳單金額取目錄成本與上游成本乘以適用加成兩者中的較高者。快取費用與外部工具不包含在此範例中，最低加值金額為預付額度 $10——這是資金最低門檻，不是工作費用或訂閱費。請參閱 計費詳細資訊。
哪條路徑勝出，以及 IronClaw 本身的成本
軟體免費：儲存庫根目錄同時包含 LICENSE-APACHE 與 LICENSE-MIT，其 README 宣告採用 MIT OR Apache 2.0 授權。二進位檔沒有付費版本，也沒有授權費。你支付的是 token 費用，以及使用供應商代管服務時的託管費用。
| 方式 | 公布價格 | 適用時機 |
|---|---|---|
| 自行託管 IronClaw | $0 軟體，MIT OR Apache-2.0 | 你已經有主機，並希望完全控制端點 |
| ironclaw.com Starter | 目前為 $0，原列 $5 劃線顯示；「包含 $5 額度」 | 嘗試代管路徑。請將其視為促銷，而非永久性的 $0 方案 |
| ironclaw.com Basic | $20/月，「包含 $20 額度」 | 「最多 2 個代理程式執行個體」，各部署之間共用用量 |
| ironclaw.com Pro+ | $200/月，「包含 $200 額度」 | 「最多 5 個代理程式執行個體」、提前使用進階模型、優先支援 |
| NEAR AI Cloud token | 每 1M 為 $0.15 / $0.50（GLM 5.3 Flash），最高每 1M 為 $3.30 / $16.50（Kimi K3） | 供應商建議的預設值，也是內建故障轉移會切換模型的唯一後端 |
| OpenAI 相容閘道 | 你閘道的每 token 費率 | 你會依工作切換模型系列，並希望使用一組金鑰——接受緩衝串流與手動輸入識別碼 |
| 透過 Ollama 使用本機模型 | 不收取每次請求費用 | 小型或私人工作；依 .env.example 的建議提高 LLM_REQUEST_TIMEOUT_SECS |
代管方案價格取自 ironclaw.com，讀取日期為 2026 年 9 月 21 日；沒有 /pricing 頁面，方案位於首頁，而呈現的標記顯示 $5 位於劃線 span 中，$0 為目前價格。首頁也聲稱「在受信任執行環境中啟動最多 5 個代理程式，每月最多 130M token」——這句話位於三張方案卡片之上，且未指明任何方案，因此不要將它歸屬於其中一個方案。本指南無法確定、也不會猜測的三件事：代管方案是否允許使用第三方金鑰、包含的額度實際可購買什麼或用完後會發生什麼，以及 130M 數字屬於哪個方案。Token 費率同日取自 near.ai/pricing，該頁面表示「模型費率之外不收取平台費用」，且僅涵蓋其機密文字模型。
有一項隱私邊界需要明確說明，因為這正是人們選擇此執行環境的原因。IronClaw 自身 README 與安全性頁面描述的控制措施——秘密資訊「靜態加密」並在主機邊界注入、用於不受信任工具的 WASM 沙箱、端點允許清單、洩漏偵測——都是在執行代理程式的機器上運作的本機控制措施。硬體證明是獨立的 NEAR AI Cloud 屬性：near.ai 表示其中的推論「在 Intel TDX + NVIDIA 機密 GPU 安全隔離區中執行」，且「每個回應都附帶可驗證的硬體報告」。將 IronClaw 指向第三方端點，會依該端點的條款將提示內容傳送給該端點，而兩份清單中的任何措施都不會隨之延伸到那裡。ironclaw.com 上由供應商撰寫的「OpenClaw vs IronClaw」表格是單方面的行銷內容，而非中立比較——也請小心搜尋結果，因為在 2026 年 9 月 17 日擷取的搜尋結果頁面樣本中，四種查詢形式 best api for ironclaw、cheapest api for ironclaw、best model for ironclaw 與 ironclaw custom provider 各自在前十名中回傳了八個以上的 OpenClaw 結果，其模型排名描述的是不同產品。
設定完成後，檢查第一筆費用
Kunavo 在 https://api.kunavo.com/v1 提供OpenAI 形式的端點，並在 提供 Anthropic 形式的端點，分別對應至 openai_compatible 與 anthropic 供應商識別碼。Kunavo 尚未對 IronClaw 進行執行時測試，因此請將上方區塊視為以已記錄協定為基礎的起點，而非相容性聲明：保留一條可運作的路徑，執行一項有界限的工作，並讀取帳戶實際記錄的費用。如果你透過 ACP 從 IronClaw 驅動 Goose——.env.example 說明 Agent Client Protocol 沙箱與指令 ironclaw acp add goose——Goose 整合 會另外涵蓋該部分，而建立 Kunavo 帳戶可在你準備好時為金鑰加值。關於周邊選項，請參閱OpenAI 相容 API 參考、OpenRouter 替代方案 與AI 成本最佳化。
常見問題
如何在 IronClaw 中設定自訂供應商？
在 ~/.ironclaw/reborn/config.toml 中撰寫 [llm.default] 區塊，並填入 provider_id、base_url、model 與 api_key_env——這四個欄位是該區塊結構接受的選填欄位，而對任何供應商 ID 而言，base_url 都會覆寫供應商的 default_base_url，不僅限於通用供應商。當端點沒有專用型錄項目時，使用 provider_id = "openai_compatible"；供應商文件列出的適用案例包括 vLLM、LiteLLM、LM Studio 與內部閘道。api_key_env 必須是環境變數名稱，因為將實際金鑰直接貼在此處，檔案解析時會遭拒，而不是靜默接受。`ironclaw config set` 不是用來處理此事的工具：設定文件將 `[llm.default]` 列在「直接於 config.toml 中編輯」的區段內，並說明 `config set` 只接受具有路由目的地的設定鍵，遇到不支援的設定鍵會拒絕。請編輯檔案，或使用 `ironclaw models set-provider`；供應商文件指出，該指令會將選擇以模型區塊的形式寫入 config.toml。接著重新啟動——直到執行 `ironclaw service restart` 前，任何變更都不會套用。已依據 2026 年 9 月 21 日的 nearai/ironclaw main 分支核對。
IronClaw 支援 OpenRouter 嗎？
支援，但兩種有文件記載的做法彼此不一致。內建供應商型錄在自身的 open_router 通訊協定上有專用的 openrouter 項目，以 OPENROUTER_API_KEY 環境變數提供 API 金鑰；供應商文件指出，OpenRouter、Together AI 與 Fireworks 現在各自都有 provider_id 項目，應直接使用，不要透過通用介面卡。儲存庫的 .env.example 仍提供較舊的做法，將 LLM_BACKEND 設為 openai_compatible，並將 LLM_BASE_URL 指向 OpenRouter 的 API。這兩個檔案在 2026 年 9 月 21 日都位於 main 分支。優先使用專用 ID；請注意，openrouter 項目未宣告 base URL 環境變數，因此若要透過代理路由，必須改用 config.toml 的 base_url 欄位。價格方面，OpenRouter 自己的常見問題集（openrouter.ai/docs/faq，於 2026 年 9 月 21 日讀取）指出，其會原價轉嫁底層供應商價格、不加價；以信用卡購買額度時收取 5.5%，最低 $0.80；使用加密貨幣時收取 5%；自帶金鑰的用量超過每月額度後，超出部分按等值 OpenRouter 成本的 5% 收費，同一頁將隨用隨付方案的該每月額度列為 $25,000。
IronClaw 最好的 API 是哪一個？
沒有單一勝者；在這裡尋找勝者尤其容易誤導，因為搜尋結果頁會改寫這個品牌：在 2026 年 9 月 17 日取樣時，「best api for ironclaw」與「cheapest api for ironclaw」在前十名中各自有八個以上的 OpenClaw 結果，因此你以這些詞組找到的排名通常描述的是不同產品。根據 IronClaw 自身程式碼的行為，可清楚區分四條路線。NEAR AI Cloud 是供應商建議的預設選項，也是內建故障轉移實際會切換模型的唯一後端。若全天使用同一供應商並希望使用其原生快取，直接使用供應商 API 最有利——IronClaw 只會在兩個 Anthropic 傳輸上發出 Anthropic cache_control 斷點，但 OpenAI 相容區塊仍會攜帶 OpenAI 的 prompt_cache_key，因此具備自動前綴快取的端點並未被排除。若希望在不同模型系列間共用一組金鑰與餘額，OpenAI 相容閘道最合適，但代價是使用緩衝串流而非原生串流，且必須手動輸入模型 ID。若要進行私密、小型且不按請求收費的工作，透過 Ollama 使用本機模型最合適。請根據你能承受哪些限制來選擇，而不是根據醒目的費率。
IronClaw 最便宜的 API 是哪一個？
列出的最低價格與完成工作所需的最低成本是不同的主張；對於持續運作的代理程式而言，差距會更大，因為無論你是否正在輸入，心跳計時、例行程序與背景工作都會計費。若以供應商建議的後端作為價格基準，near.ai/pricing 在 2026 年 9 月 21 日列出 GLM 5.3 Flash 每百萬 Token 的輸入價格為 $0.15、輸出價格為 $0.50，是其價格最低的機密文字模型；Kimi K3 則為 $3.30 與 $16.50，是價格最高的模型，且模型費率之外沒有平台費。無論選擇哪個端點，都應根據供應商自己的用量報告編列預算，而不是 IronClaw 顯示的成本；後者是依寫死的表格計算，遇到無法辨識的模型 ID 時，會退回採用類似 GPT-4o 的費率。
IronClaw 最好的模型是哪一個？
在考量能力之前，IronClaw 會對這項選擇施加兩個機械性限制，而且兩者都由模型 ID 的字面內容決定。影像附件會依據 vision_models.rs 中固定的視覺模式清單進行子字串比對——原始碼註解警告，若比對失敗，影像附件會被靜默捨棄——因此，若 ID 被重新命名，或別名不再符合 claude-sonnet-、gpt-4o、gemini-2 或 pixtral 等形式，就會失去影像輸入，且不會出現錯誤。思考提示較安全：相應的推理模式清單目前為空，因此未知名稱、別名與原生思考模型都會落入直接回答格式。除此之外，請優先選擇工具呼叫表現可靠的模型，因為透過 RigAdapter 路徑傳送的工具定義，會在供應商邊界被改寫為 OpenAI 嚴格模式。這三種行為都取自 2026 年 9 月 21 日的 main 分支。
我可以將 IronClaw 指向 Kunavo 嗎？
Kunavo 提供位於 https://api.kunavo.com/v1 的 OpenAI 形式端點，以及位於 https://api.kunavo.com/v1/messages 的 Anthropic 形式端點，分別對應 IronClaw 的 openai_compatible 與 anthropic 供應商 ID。這是從雙方文件讀出的通訊協定相符，不是經過測試的整合：Kunavo 未執行任何 IronClaw 對 Kunavo 的請求，也未聲稱已驗證相容性。依賴之前，請自行確認兩項細節。openai_compatible 項目設定了 base_url_required，因此沒有 base URL 時，區塊會無法解析模型。IronClaw 在 anthropic 通訊協定下附加的確切路徑後綴，本次研究未予確認——文件記載的 ANTHROPIC_BASE_URL 預設值是裸主機 https://api.anthropic.com，這表示執行階段會加入路徑，但在確定設定前，請先用一次請求確認。Kunavo 最低儲值金額為預付額度 $10。
儲存庫中繼資料、providers.json、CONTRACT.md、llm_costs.rs、vision_models.rs、docs/ 樹狀結構、ironclaw.com 與 near.ai/pricing 均於 2026 年 9 月 21 日讀取，來源為 main 分支，而非 1.4.0 發布標籤。未有任何 IronClaw 請求傳送至 Kunavo 端點；此處每一項相容性陳述都是對雙方文件的解讀。Kunavo token 費率取自即時目錄，每個美元範例都是說明性的 token 算術。