快速开始
DeepSeek
DeepSeek 提供功能强大的 AI 模型，并配有 OpenAI 兼容 API。
| 属性 | 值 |
|---|---|
| 提供商 | deepseek |
| 身份验证 | DEEPSEEK_API_KEY |
| API | OpenAI 兼容 |
| 基础 URL | https://api.deepseek.com |
安装插件
安装官方插件，然后重启 Gateway 网关：
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如需在 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内置目录
| 模型引用 | 名称 | 输入 | 上下文 | 最大输出 | 备注 |
|---|---|---|---|---|---|
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" }, }, },}