> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt
> Use this file to discover all available pages before exploring further.
# DeepSeek
[DeepSeek](https://www.deepseek.com) 提供强大的 AI 模型，并带有兼容 OpenAI 的 API。
| 属性 | 值 |
| -------- | -------------------------- |
| Provider | `deepseek` |
| Auth | `DEEPSEEK_API_KEY` |
| API | OpenAI 兼容 |
| Base URL | `https://api.deepseek.com` |
## 安装插件
安装官方插件，然后重启 Gateway：
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/deepseek-provider
openclaw gateway restart
```
## 入门
在 [platform.deepseek.com](https://platform.deepseek.com/api_keys) 创建一个 API 密钥。
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice deepseek-api-key
```
提示输入你的 API 密钥，并将 `deepseek/deepseek-v4-pro` 设置为默认模型。
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider deepseek
```
如需在没有运行 Gateway 的情况下查看插件的静态目录：
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --all --provider deepseek
```
对于脚本化或无头安装，请直接传入所有标志：
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
--mode local \
--auth-choice deepseek-api-key \
--deepseek-api-key "$DEEPSEEK_API_KEY" \
--skip-health \
--accept-risk
```
如果 Gateway 作为守护进程运行（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 已于 2026 年 7 月 24 日 15：59 UTC 停用 `deepseek-chat` 和 `deepseek-reasoner`。这些模型 ID 已无法访问。请将已配置的模型引用迁移到
`deepseek/deepseek-v4-flash` 或 `deepseek/deepseek-v4-pro`。
OpenClaw 的本地成本估算遵循 DeepSeek 公布的 cache-hit、cache-miss 和输出费率。DeepSeek 可能会更改这些费率；
其 [Models & Pricing](https://api-docs.deepseek.com/quick_start/pricing/) 页面是计费的权威来源。
V4 模型支持 DeepSeek 的 `thinking` 控制。OpenClaw 也会在后续轮次中重放
DeepSeek 的 `reasoning_content`，因此带工具调用的 thinking 会话可以继续。
在 DeepSeek V4 模型上使用 `/think xhigh` 或 `/think max` 可请求 DeepSeek 的
最大 `reasoning_effort`；这两者都会映射为 `"max"`。
## Thinking 与工具
DeepSeek V4 thinking 会话要求将来自启用了 thinking 的轮次的已重放 assistant 消息
在后续请求中包含 `reasoning_content`。
OpenClaw 的 DeepSeek 插件会自动回填该字段，因此正常的多轮工具使用可以在
`deepseek/deepseek-v4-flash` 和 `deepseek/deepseek-v4-pro` 上正常工作，即使历史记录来自另一个
OpenAI 兼容提供商（没有原生 `reasoning_content`）或普通的 assistant 消息。
在会话中途切换提供商后，也不需要使用 `/new`。
当 thinking 被禁用时（包括 UI 中选择 **None**），OpenClaw 会发送
`thinking: { type: "disabled" }`，并从外发历史记录中移除重放的 `reasoning_content`，
使会话保持在非 thinking 的 DeepSeek 路径上。
全新 onboarding 会选择更强大的 `deepseek/deepseek-v4-pro` 模型。当成本或延迟比
最大能力更重要时，请使用 `deepseek/deepseek-v4-flash`。
## 在线测试
若只运行现代模型 live 套件中 DeepSeek V4 直接模型检查，请执行：
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 模型都能完成，并且 thinking/tool 后续轮次会保留 DeepSeek 所需的重放载荷。
## 配置示例
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
env: { vars: { DEEPSEEK_API_KEY: "sk-..." } },
agents: {
defaults: {
model: { primary: "deepseek/deepseek-v4-pro" },
},
},
}
```
## 相关内容
选择提供方、模型引用和故障转移行为。
agents、models 和 providers 的完整配置参考。