提供商
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 key
在 platform.deepseek.com 创建 API key。
运行新手引导
openclaw onboard --auth-choice deepseek-api-key系统会提示输入 API key，并将 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" }, }, },}