DeepSeek

DeepSeek 透過與 OpenAI 相容的 API 提供強大的 AI 模型。

屬性	值
供應商	`deepseek`
驗證	`DEEPSEEK_API_KEY`
API	OpenAI 相容
基礎 URL	`https://api.deepseek.com`

開始使用

取得您的 API 金鑰
在 platform.deepseek.com 建立 API 金鑰。
執行入門引導
Terminal window
```
openclaw onboard --auth-choice deepseek-api-key
```
這將會提示您輸入 API 金鑰，並將 deepseek/deepseek-v4-flash 設為預設模型。
驗證模型是否可用
Terminal window
```
openclaw models list --provider deepseek
```
若要檢查隨附的靜態目錄而不需要執行中的 Gateway，請使用：
Terminal window
```
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

內建目錄

模型參照	名稱	輸入	上下文	最大輸出	備註
`deepseek/deepseek-v4-flash`	DeepSeek V4 Flash	文字	1,000,000	384,000	預設模型；V4 具備思考能力的介面
`deepseek/deepseek-v4-pro`	DeepSeek V4 Pro	文字	1,000,000	384,000	V4 具備思考能力的介面
`deepseek/deepseek-chat`	DeepSeek Chat	文字	131,072	8,192	DeepSeek V3.2 非思考介面
`deepseek/deepseek-reasoner`	DeepSeek Reasoner	文字	131,072	65,536	具備推理功能的 V3.2 介面

思考與工具

DeepSeek V4 思考會話比大多數 OpenAI 相容的提供者有更嚴格的重放合約：在使用啟用思考的輪次呼叫工具後，DeepSeek 預期來自該輪次的重放助理訊息在後續請求中包含 reasoning_content。OpenClaw 會在 DeepSeek 外掛程式內部處理此問題，因此 deepseek/deepseek-v4-flash 和 deepseek/deepseek-v4-pro 的正常多輪次工具使用也能正常運作。

如果您將現有的會話從其他 OpenAI 相容的提供者切換至 DeepSeek V4 模型，較舊的助理工具呼叫輪次可能沒有原生的 DeepSeek reasoning_content。OpenClaw 會在針對 DeepSeek V4 思考請求重放的助理訊息中填補該缺失欄位，讓提供者能夠接受歷史記錄，而不需要 /new。

當在 OpenClaw 中停用思考時（包括在 UI 中選擇 None）， OpenClaw 會發送 DeepSeek thinking: { type: "disabled" } 並從傳出的歷史記錄中移除重放的 reasoning_content。這可讓停用思考的會話保持在非思考的 DeepSeek 路徑上。

請使用 deepseek/deepseek-v4-flash 作為預設的快速路徑。當您想要使用更強大的 V4 模型且可接受較高成本或延遲時，請使用 deepseek/deepseek-v4-pro。

即時測試

直接的即時模型套件在現代模型集中包含了 DeepSeek V4。若要僅執行 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 模型都能完成，並且思考/工具後續輪次會保留 DeepSeek 所需的重放負載。

設定範例

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