DeepSeek

DeepSeek 提供具有 OpenAI 兼容 API 的强大 AI 模型。

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

入门指南

获取您的 API 密钥
在 platform.deepseek.com 创建 API 密钥。
运行新手引导
Terminal window
```
openclaw onboard --auth-choice deepseek-api-key
```
这将提示你输入 API 密钥，并将 deepseek/deepseek-v4-flash 设置为默认模型。
验证模型是否可用
Terminal window
```
openclaw models list --provider deepseek
```
要检查捆绑的静态目录而不需要运行 Gateway(网关)，请使用：
Terminal window
```
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	text	1,000,000	384,000	默认模型；V4 具备思考能力的表面
`deepseek/deepseek-v4-pro`	DeepSeek V4 Pro	text	1,000,000	384,000	V4 具备思考能力的表面
`deepseek/deepseek-chat`	DeepSeek Chat	text	131,072	8,192	DeepSeek V3.2 非思考表面
`deepseek/deepseek-reasoner`	DeepSeek Reasoner	text	131,072	65,536	启用推理的 V3.2 表面

思考与工具

DeepSeek V4 思考会话的重放契约比大多数 OpenAI 兼容提供商更严格：在启用思考的回合使用工具后，DeepSeek 期望该回合重放的助手消息在后续请求中包含 reasoning_content。OpenClaw 在 DeepSeek 插件内部处理了这一点，因此 deepseek/deepseek-v4-flash 和 deepseek/deepseek-v4-pro 的普通多轮工具使用可以正常工作。

如果您将现有会话从另一个 OpenAI 兼容提供商切换到 DeepSeek V4 模型，较早的助手工具调用回合可能没有原生的 DeepSeek reasoning_content。OpenClaw 会为 DeepSeek V4 思考请求在重放的助手消息中填充该缺失字段，以便提供商能够接受历史记录而无需 /new。

当在 OpenClaw 中禁用思考时（包括 UI 中的 None 选择）， OpenClaw 会发送 DeepSeek thinking: { type: "disabled" } 并从传出历史记录中剥离重放的 reasoning_content。这将使禁用思考的会话保持在非思考 DeepSeek 路径上。

将 deepseek/deepseek-v4-flash 用于默认的快速路径。当您需要更强的 V4 模型并且可以接受更高的成本或延迟时，使用 deepseek/deepseek-v4-pro。

实时测试

直接实时模型套件在现代模型集中包括 DeepSeek V4。要仅运行 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" },
    },
  },
}