使用 DeepSeek 的 OpenClaw：設定、模型 ID 與 API 費用

OpenClaw 透過需另外安裝的官方供應商外掛程式連接 DeepSeek — openclaw plugins install @openclaw/deepseek-provider — 供應商 ID 為 deepseek、金鑰為 DEEPSEEK_API_KEY，API 相容於 OpenAI，基底 URL 為 https://api.deepseek.com，不包含 /v1。 兩個事實決定你的首次執行是否成功。DeepSeek 的即時目錄包含兩個 ID：deepseek-flash 和 deepseek-v4-pro；較舊教學使用的 deepseek-chat 和 deepseek-reasoner 已於 2026 年 7 月 24 日停止服務。此外，OpenClaw 的初始設定會將 deepseek/deepseek-v4-pro 設為預設值，而這正是 DeepSeek 自己的頁面對目前計費方式有分歧的模型。

開始設定前先釐清一點，因為搜尋結果會將兩者混在一起。GitHub 上另一個 OpenClaw 將自己描述為「原始 Captain Claw (1997) 平台遊戲的多平台 C++ 重製版」；它的任何內容都不適用於此處。這裡的代理程式是位於 openclaw.ai 的專案，文件位於 docs.openclaw.ai — 請連結該主機，因為 documentation.openclaw.ai 只會重新導向至該主機。

按照兩個專案所記載的方式安裝與設定

# 1. Install the provider plugin — DeepSeek support is not bundled.
openclaw plugins install @openclaw/deepseek-provider

# 2. Interactive: prompts for the key, sets deepseek/deepseek-v4-pro as default.
openclaw onboard --auth-choice deepseek-api-key

# 2b. Or scripted, with the flags OpenClaw documents for a headless install.
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk

安裝外掛程式後不需要提供基底 URL：外掛程式會發布自己的目錄及自己的相容性行為。最小設定是在 JSON5 中提供金鑰和模型。

{
  env: { vars: { DEEPSEEK_API_KEY: "sk-..." } },
  agents: {
    defaults: {
      model: { primary: "deepseek/deepseek-v4-pro" },
    },
  },
}

OpenClaw 會按照文件記載的優先順序，從四種環境變數形式解析供應商金鑰：OPENCLAW_LIVE_DEEPSEEK_KEY 是優先順序最高的單一即時覆寫值，接著是以逗號或分號分隔的 DEEPSEEK_API_KEYS，再來是主要金鑰 DEEPSEEK_API_KEY，最後是編號項目 DEEPSEEK_API_KEY_*（Control UI and keys，查核日期為 2026 年 9 月 21 日）。Control UI 中的 Settings 再進入 Models，可新增或取代金鑰而不必編輯檔案，金鑰資料則會保留在驗證儲存區。伺服器安裝的陷阱在於作用域，而不是拼寫：OpenClaw 自己的頁面警告，如果 Gateway 以 launchd 或 systemd 下的 daemon 執行，金鑰必須對該程序可見，例如放在 ~/.openclaw/.env 或透過 env.shellEnv 提供。

哪些 DeepSeek 模型 ID 實際上仍可用

以下各列具有三種不同狀態，而不是單一狀態。DeepSeek 的 list-models 參考中的範例回應明確顯示兩個 ID：deepseek-flash 和 deepseek-v4-pro；但 OpenClaw 隨附的目錄仍提供四個參照。

請將兩段停止服務聲明分開理解，因為它們讀起來像是互相矛盾，但其實並非如此。OpenClaw 表示 DeepSeek 已停止提供 deepseek-chat 和 deepseek-reasoner，且「這些模型 ID 已無法存取」。DeepSeek 則另行表示，「舊版名稱 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 仍可接受，但相應模型已停止服務」。這是兩組不同的名稱，對應兩種不同的結果。DeepSeek 的 Models & Pricing 頁面為兩個仍可用的 ID 都提供 1M context length 和 384K maximum output，而 OpenClaw 的目錄表格則在其四個參照上都列出相同的 1,000,000 / 384,000 組合。

尚未解決的部分。 DeepSeek 的2026 年 9 月 10 日公告表示「我們正在逐步淘汰 V4-Pro」，並指出「自 2026 年 9 月 14 日 04:00 UTC 起，所有 deepseek-v4-pro 請求都會以 V4.1-Flash 費率路由至 V4.1-Flash」。同一版本的變更記錄卻表示相反內容：「因應使用者需求，我們決定在 2026 年 9 月 14 日之後繼續提供 DeepSeek V4 Pro 的 API 服務，計費方式維持不變」。Models & Pricing 頁面仍以自己的較高費率列出 V4 Pro，且沒有停止服務通知。兩者都是在 2026 年 9 月 21 日讀取，也就是相關日期一週後。本頁不會告訴你實際採用哪一種計費方式 — 在保留初始設定預設值之前，請先在自己的 DeepSeek 帳戶中確認，並注意該預設值正是有爭議的模型。

token 的成本，以及為什麼時間是價格的一部分

DeepSeek 發布尖峰和離峰費率，離峰費率為尖峰的一半。時段很窄：「尖峰時段為週一至週五的 01:00 - 04:00 和 06:00 - 10:00 UTC，不包括中國法定假日。其他所有時段皆為離峰，包括週末以及完整的中國法定假日。」平日只有七個小時屬於尖峰，其餘時間都不是，因此預設假設尖峰時段的估算會高估一般帳單。

內容取自 DeepSeek 的 Models & Pricing 頁面，查閱日期為 2026 年 9 月 21 日。Flash 列也獲得 OpenClaw 供應商頁面的獨立佐證，該頁面列出「每百萬個輸入 token $0.30、每百萬個輸出 token $1.20，以及每百萬個快取輸入 token $0.006」。V4 Pro 各列僅依據 Models & Pricing 頁面，且處於上述矛盾之下，因此請將其視為引述內容，而非已確定的資訊。

快取欄位是會改變代理程式帳單的項目，其比例也很不尋常。deepseek-flash 的快取命中每百萬個 token 收費 $0.006，而未命中為 $0.30 — 約為未命中費率的五十分之一，遠低於其他地方常見的十分之一比例，因此不要將其他供應商的假設套用過來。DeepSeek 的快取指南表示，此功能「預設對所有使用者啟用，不需要修改程式碼」，命中需要完整相符的前綴，而未使用的快取「通常會在幾小時至幾天內」清除。命中與未命中會出現在 prompt_cache_hit_tokens 和 prompt_cache_miss_tokens 使用量欄位中。DeepSeek 沒有發布快取寫入價格，其定價表也沒有快取寫入欄位；這表示沒有已發布的費用，而不是表示寫入免費。

在 DeepSeek 已發布費率下，deepseek-flash 的說明性工作階段。 假設一次 OpenClaw 執行會傳送 600,000 個輸入 token，其中 450,000 個命中前綴快取，150,000 個未命中，並收到 40,000 個輸出 token。尖峰時段的費用為 $0.045 加上 $0.0027 再加上 $0.048，即 $0.096；同一工作階段在離峰時段為 $0.048。完全沒有快取命中的同一次執行，在尖峰時段會是 $0.228。這些是根據所述假設進行的 token 計算，不是實際工作成本，也不是支出上限 — 你自己的快取命中比例才是最重要的變數，而 OpenClaw 應用程式內的數字無法定案，因為 OpenClaw 表示其本機成本是估算值，並以 DeepSeek 的定價頁面作為計費權威來源。

模型能力與用戶端工具支援是兩個不同的問題

這是價格表無法告訴你的部分，也是實際上應使用外掛程式，而不是手動建立供應商項目的原因。DeepSeek V4 的思考工作階段要求後續請求重播來自啟用思考回合的 assistant 訊息，並攜帶 reasoning_content。OpenClaw 的 DeepSeek 外掛程式會自動補上該欄位，因此多回合工具使用可以正常運作，即使「歷史記錄來自另一個 OpenAI 相容供應商（沒有原生 reasoning_content），或來自一般的 assistant 訊息」，在工作階段中途切換供應商後也不需要 /new。關閉思考時，包括 UI 中選取 None 的情況，OpenClaw 會傳送 thinking: { type: "disabled" }，並從送出的歷史記錄中移除重播的 reasoning_content。OpenClaw 也會將 /think xhigh 和 /think max 都對應至 DeepSeek 的最大 reasoning_effort。

指向 DeepSeek 相容端點的通用 openai-completions 自訂供應商不會取得上述任何自動補全功能，除非你自行宣告相容性區塊，否則也不會使用 DeepSeek 思考格式 — OpenClaw 的 ds4 頁面展示了該結構，包括 thinkingFormat: "deepseek" 和 supportsReasoningEffort。這項差距通常就是工具回合成功一次、接著在後續回合失敗的原因。

兩項 DeepSeek 端限制應一併納入決策。嚴格模式的工具呼叫位於不同的基底 URL https://api.deepseek.com/beta，且每個函式都需要 "strict": true 以及 "additionalProperties": false；外掛程式預設不會指向該位置。此外，DeepSeek 的工具呼叫指南指出：「Chat Completion API 不支援在對話中途插入工具呼叫，但支援在對話中途插入 system 訊息；若要插入工具呼叫，請改用 Anthropic API 或 Responses API」— 這是 OpenClaw 外掛程式所使用端點的限制，並非模型限制，且已有兩個文件記載的替代方案。

關於模型支援，兩個來源的說法一致。DeepSeek Models & Pricing 頁面的 FEATURES 欄位標示 deepseek-flash 和 deepseek-v4-pro 都支援 Tool Calls、JSON Output、Responses API 和 Anthropic API，並在 vision 上區分兩者 — deepseek-flash 支援，deepseek-v4-pro 不支援。OpenClaw 表示其四個參照都支援多回合工具使用。兩邊都沒有記載平行工具呼叫，因此這一點確實尚未有定論，而不是已被任一方回答。

分三個步驟驗證，接著檢查值得指出的失敗情況

請依序檢查各層，因為每一層的失敗方式都不同。首先是目錄：openclaw models list --provider deepseek；如果沒有執行中的 Gateway，也可以使用 openclaw models list --all --provider deepseek 檢視外掛程式的靜態目錄；如果想使用沒有爭議的模型，而不是初始設定預設值，再執行 openclaw models set deepseek/deepseek-flash。其次，先傳送一個簡短的非串流提示，再傳送一個串流提示；這是驗證或基底 URL 問題最容易清楚浮現的地方。第三 — 也只有第三步 — 執行一次工具呼叫，接著在同一工作階段進行第二個回合；這是唯一會實際測試上述 reasoning_content 重播的步驟。

404 那一行值得單獨說明，因為這是文件無法替您解釋的一項。DeepSeek 的錯誤代碼表列出 400、401、402、422、429、500 和 503，但不包含 404，因此這裡出現 404，是關於您路由設定的證據，而不是關於 DeepSeek 的證據。對於未知的模型 ID，DeepSeek 實際會回傳什麼，文件並未說明，此處也未進行測試。錯誤參考文件涵蓋 Kunavo 自有端點上的對應狀態碼。

直接、Gateway、本機：哪條路由優先

Kunavo 不提供任何 DeepSeek 模型。其文字模型屬於 Claude 和 OpenAI 系列，因此 Kunavo 沒有通往 DeepSeek 模型的路由，本頁面也沒有提供這種路由。可以沿用的是這套機制；如果您閱讀 DeepSeek 設定頁面的原因，是想在不同模型系列之間共用一個金鑰，而非特別想使用 DeepSeek，那麼這套機制就值得了解。

對於閘道這一列，設定同樣有兩種方式。您可以宣告 models.providers.<id>，並設定 baseUrl、apiKey、api: "openai-completions"，以及至少列出各個 id 的 models[] 陣列；或使用 --auth-choice custom-api-key、--custom-base-url 和 --custom-model-id，針對該端點完成初始設定。模型參照一律為 provider/model；而一種不會顯示錯誤的失敗情況，是在 agents.defaults.models 下為模型設定別名，卻沒有在 models.providers.<provider>.models[] 中註冊它——OpenClaw 的 自訂提供者參考文件指出，該別名「本身既不會限制覆寫，也不會註冊新的執行階段模型」。Kunavo 在這條路由使用的基底 URL 是 https://api.kunavo.com/v1，且恰好包含一個 /v1——這與 DeepSeek 不加後綴的慣例相反，也是有人將一個頁面的值複製到另一個頁面的欄位時，最可能導致 404 的原因。

為了了解這個替代方案的費用規模，以下採用相同的假定工作階段形式——600,000 個輸入 token 和 40,000 個輸出 token，假定未使用快取——並按照即時的 Kunavo 目錄費率計價。這些是不同端點上的不同模型，因此這裡只是工作階段形式的比較，不是與上方 DeepSeek 金額進行的相同任務成本比較；目錄所列最低費率與完成任務的最低成本是兩項不同的主張，只有您自己的執行結果才能確定後者。

這是基於所述假設的示意性 token 費用計算，不是實測任務成本，也不是帳單上限。Kunavo 的目錄金額是計費下限而非上限：當上游回報其費用時，帳單金額取目錄成本與上游成本乘以適用加成兩者中的較高者。快取費用和外部工具不包含在本範例中。最低加值金額為 $10 的預付額度——這是資金最低門檻，不是任務費用或訂閱費。請參閱 計費詳細資訊和快取。

如果您實際想要的是上述另一條路線，請先從整合總覽開始，取得基底 URL 和金鑰設定資訊；然後參閱快速入門進行第一次呼叫，準備為金鑰加值時再建立 Kunavo 帳戶。請將其視為已發布的設定參考，而非相容性測試結果：OpenClaw 尚未針對 Kunavo 的端點進行執行階段測試。仍要使用 OpenClaw 並選擇模型？OpenClaw 定價區分免費軟體與按量計費的帳單，適用於 OpenClaw 的最佳 API按任務比較路線，而OpenAI 相容 API涵蓋本頁面反覆提醒的基底 URL 慣例。

常見問題

上述每一項 OpenClaw 和 DeepSeek 陳述，均於 2026 年 9 月 21 日從這些專案自己的文件與登錄資料中查閱，並以 OpenClaw v2026.9.5 為依據；供應商頁面、定價頁面、變更記錄、9 月 10 日公告、list-models 參考文件、錯誤代碼表、速率限制頁面和自訂供應商規則，均已為本頁直接重新擷取。此處未進行任何安裝、初始設定或呼叫：沒有執行 OpenClaw，沒有向 api.deepseek.com 發出請求，也沒有針對 Kunavo 進行執行階段測試。Kunavo 的 token 費率來自即時目錄，所有美元金額均為示意性的 token 費用計算，而非實測成本。