# DeepSeek

> DeepSeek 设置（身份验证 + 模型选择）

- 网址：https://funcoding.ai/agents/openclaw/providers/deepseek/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/providers/deepseek

---
[DeepSeek](https://www.deepseek.com) 提供功能强大的 AI 模型，并支持 OpenAI 兼容 API。

| 属性 | 值                      |
| -------- | -------------------------- |
| 提供商 | `deepseek`                 |
| 身份验证     | `DEEPSEEK_API_KEY`         |
| API      | OpenAI 兼容          |
| 基础 URL | `https://api.deepseek.com` |

## 安装插件

安装官方插件，然后重启 Gateway 网关：

```bash
openclaw plugins install @openclaw/deepseek-provider
openclaw gateway restart
```

## 入门指南

**获取 API key**

在 [platform.deepseek.com](https://platform.deepseek.com/api_keys) 创建 API key。

**运行新手引导**

```bash
openclaw onboard --auth-choice deepseek-api-key
```

系统会提示输入 API key，并将 `deepseek/deepseek-v4-flash` 设置为默认模型。

**验证模型是否可用**

```bash
openclaw models list --provider deepseek
```

若要在 Gateway 网关未运行时检查插件的静态目录：

```bash
openclaw models list --all --provider deepseek
```

<details>
<summary>非交互式设置</summary>

对于脚本化或无界面安装，请直接传入所有标志：

```bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk
```

</details>

<div class="callout callout-warning">

如果 Gateway 网关作为守护进程（launchd/systemd）运行，请确保该进程可以使用
`DEEPSEEK_API_KEY`（例如，在 `~/.openclaw/.env` 中设置或通过
`env.shellEnv` 提供）。

</div>

## 内置目录

| 模型引用                    | 名称              | 输入 | 上下文   | 最大输出 | 说明                                               |
| ---------------------------- | ----------------- | ----- | --------- | ---------- | --------------------------------------------------- |
| `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 思考模式兼容名称     |

<div class="callout callout-warning">

DeepSeek 将于 2026 年 7 月 24 日 15:59 UTC 停用 `deepseek-chat` 和
`deepseek-reasoner`。它们目前分别路由到 DeepSeek V4 Flash 的非思考模式和
思考模式。请在截止时间前将已配置的模型引用迁移至
`deepseek/deepseek-v4-flash` 或 `deepseek/deepseek-v4-pro`。

</div>

OpenClaw 的本地成本估算遵循 DeepSeek 公布的缓存命中、缓存未命中和输出费率。DeepSeek
可能会更改这些费率；其
[模型与定价](https://api-docs.deepseek.com/quick_start/pricing/)页面是计费的权威依据。

<div class="callout callout-tip">

V4 模型支持 DeepSeek 的 `thinking` 控制。OpenClaw 还会在后续轮次中重放
DeepSeek `reasoning_content`，使包含工具调用的思考会话能够继续。
将 `/think xhigh` 或 `/think max` 与 DeepSeek V4 模型配合使用，可请求 DeepSeek 的
最大 `reasoning_effort`；两者都会映射到 `"max"`。

</div>

## 思考与工具

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" },
    },
  },
}
```

## 相关内容

- [模型选择](https://funcoding.ai/agents/openclaw/concepts/model-providers/)：选择提供商、模型引用和故障转移行为。
- [配置参考](https://funcoding.ai/agents/openclaw/gateway/configuration-reference/)：智能体、模型和提供商的完整配置参考。