---
read_when:
- 你想要搭配 OpenClaw 使用 DeepSeek
- 你需要 API 金鑰環境變數或命令列介面驗證選項
summary: DeepSeek 設定（驗證 + 模型選擇）
title: DeepSeek
x-i18n:
generated_at: "2026-07-11T21:42:23Z"
model: gpt-5.6
postprocess_version: locale-links-v1
provider: openai
source_hash: 77e074756d593205d7d05f499da93b9bd3c63acdce7092b42fb5562023577925
source_path: providers/deepseek.md
workflow: 16
---
[DeepSeek](https://www.deepseek.com) 提供功能強大的 AI 模型，並具備與 OpenAI 相容的 API。
| 屬性 | 值 |
| ---- | -------------------------- |
| 提供者 | `deepseek` |
| 驗證 | `DEEPSEEK_API_KEY` |
| API | 與 OpenAI 相容 |
| 基礎 URL | `https://api.deepseek.com` |
## 安裝外掛
安裝官方外掛，然後重新啟動閘道：
```bash
openclaw plugins install @openclaw/deepseek-provider
openclaw gateway restart
```
## 開始使用
在 [platform.deepseek.com](https://platform.deepseek.com/api_keys) 建立 API 金鑰。
```bash
openclaw onboard --auth-choice deepseek-api-key
```
系統會提示輸入 API 金鑰，並將 `deepseek/deepseek-v4-flash` 設為預設模型。
```bash
openclaw models list --provider deepseek
```
若要在閘道未執行時檢查外掛的靜態目錄：
```bash
openclaw models list --all --provider deepseek
```
若是指令碼或無介面安裝，請直接傳入所有旗標：
```bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice deepseek-api-key \
--deepseek-api-key "$DEEPSEEK_API_KEY" \
--skip-health \
--accept-risk
```
如果閘道以常駐程式（launchd/systemd）方式執行，請確保該程序可以使用
`DEEPSEEK_API_KEY`（例如將其設定於 `~/.openclaw/.env`，或透過
`env.shellEnv` 提供）。
## 內建目錄
| 模型參照 | 名稱 | 輸入 | 上下文 | 最大輸出 | 備註 |
| ---------------------------- | ----------------- | ---- | --------- | -------- | ---------------------------------------------- |
| `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 思考模式相容名稱 |
DeepSeek 將於 2026 年 7 月 24 日 15:59 UTC 停用 `deepseek-chat` 和
`deepseek-reasoner`。目前這兩者會分別路由至 DeepSeek V4 Flash 的非思考模式
與思考模式。請在截止時間前，將已設定的模型參照改為
`deepseek/deepseek-v4-flash` 或 `deepseek/deepseek-v4-pro`。
OpenClaw 的本機成本估算依循 DeepSeek 公布的快取命中、快取未命中及輸出費率。
DeepSeek 可能會變更這些費率；計費應以其
[模型與定價](https://api-docs.deepseek.com/quick_start/pricing/)頁面為準。
V4 模型支援 DeepSeek 的 `thinking` 控制項。OpenClaw 也會在後續輪次中重播
DeepSeek 的 `reasoning_content`，讓包含工具呼叫的思考工作階段得以繼續。
搭配 DeepSeek V4 模型使用 `/think xhigh` 或 `/think max`，即可要求 DeepSeek
採用最高的 `reasoning_effort`；兩者都會對應至 `"max"`。
## 思考與工具
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 的直接模型檢查：
```bash
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 所需的重播承載資料。
## 設定範例
```json5
{
env: { DEEPSEEK_API_KEY: "sk-..." },
agents: {
defaults: {
model: { primary: "deepseek/deepseek-v4-flash" },
},
},
}
```
## 相關內容
選擇提供者、模型參照與容錯移轉行為。
代理程式、模型與提供者的完整設定參考。