本页内容

本页内容

供应商

DeepSeek

DeepSeek 提供功能强大的 AI 模型以及与 OpenAI- 兼容的 API。

属性 值
提供者 deepseek
认证 DEEPSEEK_API_KEY
API OpenAI-兼容
基础 URL https://api.deepseek.com

安装插件

安装官方插件:

bash
openclaw plugins install @openclaw/deepseek-provider

安装自动应用于正在运行的网关;否则下次启动时生效。请参阅 应用更改并检查 。

入门

  • 获取您的 API 密钥

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

  • 运行入门引导培训

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

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

  • 验证模型是否可用

    bash
    openclaw models list --provider deepseek

    如需在没有运行 Gateway 的情况下查看插件的静态目录:

    bash
    openclaw models list --all --provider deepseek
  • Onboarding 会保留您的模型条目,并将生成的目录行留给发现。对于 models.mode: "replace",它还会写入内置目录,因为该模式会跳过发现。

    非交互式设置

    对于脚本化或无头安装,请直接传入所有标志:

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

    内置目录

    模型引用 名称 输入 上下文 最大输出 笔记
    deepseek/deepseek-flash DeepSeek V4.1 闪存 文本、图像 1,000,000 384,000 主闪光灯模型
    deepseek/deepseek-v4-flash DeepSeek V4 闪存 文本 1,000,000 384,000 快速、支持 V4 思考能力的界面
    deepseek/deepseek-v4-pro DeepSeek V4 Pro 文本 1,000,000 384,000 入门引导默认设置
    deepseek/deepseek-v4-flash-vision-exp DeepSeek V4 Flash 视觉(实验) 文本、图像 1,000,000 384,000 实验图像理解

    OpenClaw 的本地成本为估算值。 deepseek/deepseek-flash 使用 DeepSeek 的峰值费率:每百万个输入代币 $0.30、每百万个输出代币 $1.20 以及每百万个缓存输入代币 $0.006。公布的非高峰费率为该金额的一半。旧行保留其早期捆绑的元数据。 DeepSeek 仍接受 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp,将它们路由到 V4.1 闪存,并按当前闪存费率对其进行计费。现有显式选择在 OpenClaw 中仍然有效。 DeepSeek 可更改费率;其Models & Pricing页面是计费的权威页面。

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

    Thinking 与工具

    当 DeepSeek-format 端点以文本形式发出 DSML 工具标记时,OpenClaw 会将有效的 calls、tool_calls、tool_call 和 function_calls 块恢复到工具调用中,而不是在聊天中显示其负载。这包括带有分隔符空间的双全角标记。直接提供程序调用和免工具终结隐藏了这些块,无需恢复工具。格式错误或未完成的块也会被隐藏而不执行;现有工具权限仍然适用于恢复的呼叫。

    DeepSeek V4思考会话需要重播来自思考轮的辅助信息,包括reasoning_content关于后续请求。OpenClaw's DeepSeek插件会自动回填该字段,因此可以正常使用多轮工具deepseek/deepseek-flash, deepseek/deepseek-v4-flash, deepseek/deepseek-v4-flash-vision-exp, 和deepseek/deepseek-v4-pro即使历史来自另一个OpenAI-兼容的提供者(没有本地reasoning_content)或来自普通的助理消息。不/new会话中途切换提供商后需要。

    当 thinking 被禁用时(包括 UI 中选择 None),OpenClaw 会发送 thinking: { type: "disabled" },并从外发历史记录中移除重放的 reasoning_content, 使会话保持在非 thinking 的 DeepSeek 路径上。

    新入门引导选择deepseek/deepseek-v4-pro。选择闪存:

    bash
    openclaw models set deepseek/deepseek-flash

    在线测试

    若只运行现代模型 live 套件中 DeepSeek V4 直接模型检查,请执行:

    bash
    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 模型都能完成,并且 thinking/tool 后续轮次会保留 DeepSeek 所需的重放载荷。

    使用相同的 DEEPSEEK_API_KEY 检查实验视觉模型:

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

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

    配置示例

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

    相关内容

    本页有帮助吗?