DeepSeek

DeepSeek 提供强大的 AI 模型，并带有兼容 OpenAI 的 API。

安装插件¶

安装官方插件：

openclaw plugins install @openclaw/deepseek-provider

安装会自动应用到正在运行的 Gateway；否则将在下次启动时生效。请参阅 应用更改并检查。

快速开始¶

1. 获取你的 API 密钥

在 platform.deepseek.com 创建 API 密钥。

2. 运行引导配置

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

它会提示你输入 API 密钥，并将 deepseek/deepseek-v4-pro 设置为默认模型。

3. 验证模型是否可用

openclaw models list --provider deepseek

如需在不运行 Gateway 的情况下检查插件的静态目录：

openclaw models list --all --provider deepseek

引导配置会保留你的模型条目，并将生成的目录行留给自动发现。使用 models.mode: "replace" 时，它还会写入内置目录，因为该模式会跳过自动发现。

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

内置模型目录¶

OpenClaw 的本地成本为估算值。标准 Flash 使用 DeepSeek 的峰值费率：每百万输入 token $0.30， 每百万输出 token $1.20，每百万缓存输入 token $0.006。已公布的谷值费率是这些金额的一半。 旧版行保留其早期捆绑的元数据。DeepSeek 仍会接受 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp，将它们路由到 V4.1 Flash， 并按当前 Flash 费率计费。现有显式选择在 OpenClaw 中仍然有效。 DeepSeek 可能会调整费率；其 模型与定价 页面是计费的权威依据。

对于图像输入，请选择 deepseek/deepseek-flash。旧版的 deepseek/deepseek-v4-flash-vision-exp 选择也保留图像支持。 标准 Flash 通过相同的 API 和 API 密钥接受 PNG、JPEG、GIF 和 WebP 图像。 有关图像限制，请参阅 DeepSeek 视觉。

思考与工具¶

DeepSeek V4 思考会话要求在后续请求中，来自启用思考的轮次的已重放助手消息 包含 reasoning_content。OpenClaw 的 DeepSeek 插件会自动回填该字段，因此 即使在 deepseek/deepseek-flash、deepseek/deepseek-v4-flash、 deepseek/deepseek-v4-flash-vision-exp 和 deepseek/deepseek-v4-pro 上， 正常的多轮工具使用也能正常工作——即使历史记录来自另一个 OpenAI 兼容提供商（没有原生 reasoning_content）或来自普通助手消息。 在会话中途切换提供商后，也无需使用 /new。

当思考被禁用（包括 UI 中的 无 选项）时，OpenClaw 会发送 thinking: { type: "disabled" }，并从传出历史中移除重放的 reasoning_content， 使会话保持在 DeepSeek 的非思考路径上。

全新引导配置会选择 deepseek/deepseek-v4-pro。如需选择标准 Flash：

openclaw models set deepseek/deepseek-flash

在线测试¶

若只想从现代模型在线测试套件中运行 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 所需的重放负载。

若要使用同一个 DEEPSEEK_API_KEY 检查实验性视觉模型：

OPENCLAW_LIVE_DEEPSEEK_MODEL=deepseek-v4-flash-vision-exp \
pnpm test:live extensions/deepseek/deepseek.live.test.ts

这会针对所选模型运行文本、生成图像识别和思考重放检查。

配置示例¶

{
  env: { vars: { DEEPSEEK_API_KEY: "sk-..." } },
  agents: {
    defaults: {
      model: { primary: "deepseek/deepseek-v4-pro" },
    },
  },
}

相关¶

模型选择

选择提供商、模型引用和故障转移行为。

ds4 本地服务器

从本地兼容 OpenAI 的 ds4 服务器运行 DeepSeek V4 Flash。

配置参考

代理、模型和提供商的完整配置参考。