Providers
DeepSeek
DeepSeek 提供功能強大的 AI 模型，並具備與 OpenAI 相容的 API。
| 屬性 | 值 |
|---|---|
| 提供者 | deepseek |
| 驗證 | DEEPSEEK_API_KEY |
| API | 與 OpenAI 相容 |
| 基礎 URL | https://api.deepseek.com |
安裝外掛
安裝官方外掛，然後重新啟動閘道：
openclaw plugins install @openclaw/deepseek-provideropenclaw gateway restart開始使用
取得 API 金鑰
在 platform.deepseek.com 建立 API 金鑰。
執行初始設定
openclaw onboard --auth-choice deepseek-api-key系統會提示輸入 API 金鑰，並將 deepseek/deepseek-v4-flash 設為預設模型。
確認模型可用
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內建目錄
| 模型參照 | 名稱 | 輸入 | 上下文 | 最大輸出 | 備註 |
|---|---|---|---|---|---|
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 | 文字 | 1,000,000 | 384,000 | 已棄用的 V4 Flash 非思考模式相容名稱 |
deepseek/deepseek-reasoner |
DeepSeek Reasoner | 文字 | 1,000,000 | 384,000 | 已棄用的 V4 Flash 思考模式相容名稱 |
OpenClaw 的本機成本估算依循 DeepSeek 公布的快取命中、快取未命中及輸出費率。 DeepSeek 可能會變更這些費率；計費應以其 模型與定價頁面為準。
思考與工具
DeepSeek V4 思考工作階段要求：在後續請求中，從已啟用思考的輪次重播助理訊息時，
必須包含 reasoning_content。OpenClaw 的 DeepSeek 外掛會自動補填此欄位，
因此即使歷史記錄來自其他與 OpenAI 相容的提供者（沒有原生
reasoning_content），或來自一般助理訊息，deepseek/deepseek-v4-flash
與 deepseek/deepseek-v4-pro 仍可正常進行多輪工具使用。在工作階段中途切換
提供者後，不需要執行 /new。
停用思考時（包括在 UI 中選取 None），OpenClaw 會傳送
thinking: { type: "disabled" }，並從傳出的歷史記錄中移除重播的
reasoning_content，使工作階段維持在 DeepSeek 的非思考路徑。
預設的快速路徑請使用 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 模型均能完成作業，並確認思考／工具後續輪次會保留 DeepSeek 所需的重播承載資料。
設定範例
{ env: { DEEPSEEK_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "deepseek/deepseek-v4-flash" }, }, },}