DeepSeek

DeepSeek 设置（身份验证 + 模型选择）

DeepSeek 提供功能强大的 AI 模型，并支持 OpenAI 兼容 API。

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

安装插件

安装官方插件，然后重启 Gateway 网关：

openclaw plugins install @openclaw/deepseek-provider
openclaw 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

如果 Gateway 网关作为守护进程（launchd/systemd）运行，请确保该进程可以使用 DEEPSEEK_API_KEY（例如，在 ~/.openclaw/.env 中设置或通过 env.shellEnv 提供）。

内置目录

模型引用	名称	输入	上下文	最大输出	说明
`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 思考模式兼容名称

DeepSeek 将于 2026 年 7 月 24 日 15:59 UTC 停用 deepseek-chat 和 deepseek-reasoner。它们目前分别路由到 DeepSeek V4 Flash 的非思考模式和思考模式。请在截止时间前将已配置的模型引用迁移至 deepseek/deepseek-v4-flash 或 deepseek/deepseek-v4-pro。

OpenClaw 的本地成本估算遵循 DeepSeek 公布的缓存命中、缓存未命中和输出费率。DeepSeek 可能会更改这些费率；其模型与定价页面是计费的权威依据。

V4 模型支持 DeepSeek 的 thinking 控制。OpenClaw 还会在后续轮次中重放 DeepSeek reasoning_content，使包含工具调用的思考会话能够继续。将 /think xhigh 或 /think max 与 DeepSeek V4 模型配合使用，可请求 DeepSeek 的最大 reasoning_effort；两者都会映射到 "max"。

思考与工具

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" },
    },
  },
}

DeepSeek

安装插件

入门指南

内置目录

思考与工具

实时测试

配置示例

相关内容