跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

DeepSeek 提供強大的 AI 模型，並具備與 OpenAI 相容的 API。
屬性值
提供者deepseek
驗證DEEPSEEK_API_KEY
API與 OpenAI 相容
基底 URLhttps://api.deepseek.com

​
開始使用

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
若要在不需要執行中 Gateway 的情況下檢查內建的靜態目錄， 請使用：
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
如果 Gateway 以 daemon（launchd/systemd）形式執行，請確保 DEEPSEEK_API_KEY 可供該程序使用（例如放在 ~/.openclaw/.env，或透過 env.shellEnv）。

​
內建目錄

模型參照名稱輸入上下文最大輸出備註
deepseek/deepseek-v4-flashDeepSeek V4 Flashtext1,000,000384,000預設模型；支援 V4 思考能力的介面
deepseek/deepseek-v4-proDeepSeek V4 Protext1,000,000384,000支援 V4 思考能力的介面
deepseek/deepseek-chatDeepSeek Chattext131,0728,192DeepSeek V3.2 非思考介面
deepseek/deepseek-reasonerDeepSeek Reasonertext131,07265,536啟用推理的 V3.2 介面
V4 模型支援 DeepSeek 的 thinking 控制。OpenClaw 也會在後續回合重播 DeepSeek reasoning_content，因此包含工具呼叫的思考工作階段可以繼續。 搭配 DeepSeek V4 模型使用 /think xhigh 或 /think max，即可要求 DeepSeek 的 最大 reasoning_effort。

​
思考與工具

相較於大多數與 OpenAI 相容的提供者，DeepSeek V4 思考工作階段有更嚴格的重播契約：啟用思考的回合使用工具後，DeepSeek 會期望該回合中重播的 assistant 訊息在後續請求中包含 reasoning_content。OpenClaw 會在 DeepSeek Plugin 內處理這一點，因此一般的多回合工具使用可搭配 deepseek/deepseek-v4-flash 和 deepseek/deepseek-v4-pro 正常運作。 如果你將既有工作階段從另一個與 OpenAI 相容的提供者切換到 DeepSeek V4 模型，較舊的 assistant 工具呼叫回合可能沒有原生的 DeepSeek reasoning_content。OpenClaw 會在 DeepSeek V4 思考請求中，為重播的 assistant 訊息補上該缺少的欄位，讓提供者可接受歷史記錄，而不需要 /new。 在 OpenClaw 中停用思考時（包含 UI 的 無 選項）， 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" },
    },
  },
}

​
相關

模型選擇

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

設定參考

agent、模型與提供者的完整設定參考。