快速开始
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 | 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 思考会话要求来自启用思考轮次的重放助手消息，在后续请求中包含
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" }, }, },}相关
Was this useful?
