跳轉到主要內容
DeepSeek 提供強大的 AI 模型，並具備 OpenAI 相容 API。
屬性值
提供者deepseek
驗證DEEPSEEK_API_KEY
APIOpenAI 相容
基礎 URLhttps://api.deepseek.com

​
安裝外掛

安裝官方外掛，然後重新啟動閘道： 
openclaw plugins install @openclaw/deepseek-provider
openclaw gateway restart

​
開始使用

1

取得你的 API 金鑰

在 platform.deepseek.com 建立 API 金鑰。
2

執行 onboarding

openclaw onboard --auth-choice deepseek-api-key
會提示輸入你的 API 金鑰，並將 deepseek/deepseek-v4-flash 設為預設模型。
3

確認模型可用

openclaw models list --provider deepseek
若要在沒有執行中閘道的情況下檢查外掛的靜態目錄：
openclaw models list --all --provider deepseek
對於腳本化或無頭安裝，請直接傳入所有旗標：
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk
如果閘道以 daemon（launchd/systemd）方式執行，請確保 DEEPSEEK_API_KEY 可供該程序使用（例如放在 ~/.openclaw/.env 中，或透過 env.shellEnv）。

​
內建目錄

模型參照名稱輸入上下文最大輸出備註
deepseek/deepseek-v4-flashDeepSeek V4 Flash文字1,000,000384,000預設模型；支援 V4 thinking 的介面
deepseek/deepseek-v4-proDeepSeek V4 Pro文字1,000,000384,000支援 V4 thinking 的介面
deepseek/deepseek-chatDeepSeek Chat文字131,0728,192DeepSeek V3.2 非 thinking 介面
deepseek/deepseek-reasonerDeepSeek Reasoner文字131,07265,536啟用推理的 V3.2 介面
V4 模型支援 DeepSeek 的 thinking 控制。OpenClaw 也會在後續輪次重播 DeepSeek reasoning_content，讓包含工具呼叫的 thinking 工作階段可以繼續。 搭配 DeepSeek V4 模型使用 /think xhigh 或 /think max，即可要求 DeepSeek 的 最大 reasoning_effort；兩者都會對應到 "max"。

​
Thinking 與工具

DeepSeek V4 thinking 工作階段要求從啟用 thinking 的輪次重播的助理訊息， 在後續請求中包含 reasoning_content。OpenClaw 的 DeepSeek 外掛會自動回填該欄位，因此一般的 多輪工具使用可在 deepseek/deepseek-v4-flash 和 deepseek/deepseek-v4-pro 上運作，即使歷史記錄來自另一個 OpenAI 相容提供者（沒有原生 reasoning_content），或來自一般的 助理訊息也一樣。切換提供者後在同一工作階段中不需要 /new。 停用 thinking 時（包含 UI 的 無 選項），OpenClaw 會傳送 thinking: { type: "disabled" }，並從傳出歷史記錄中移除重播的 reasoning_content， 讓工作階段維持在 DeepSeek 的非 thinking 路徑。 預設快速路徑請使用 deepseek/deepseek-v4-flash。當你可以接受較高 成本或延遲時，使用 deepseek/deepseek-v4-pro 取得更強的模型。

​
即時測試

若只要從現代模型即時套件執行 DeepSeek V4 直接模型檢查： 
OPENCLAW_LIVE_PROVIDERS=deepseek \
OPENCLAW_LIVE_MODELS="deepseek/deepseek-v4-flash,deepseek/deepseek-v4-pro" \
pnpm test:live src/agents/models.profiles.live.test.ts
會驗證兩個 V4 模型都能完成，並確認 thinking/工具後續輪次 會保留 DeepSeek 要求的重播酬載。

​
設定範例

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

​
相關

模型選擇

選擇提供者、模型參照和容錯移轉行為。

設定參考

代理、模型和提供者的完整設定參考。