Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

DeepSeek 通过兼容 OpenAI 的 API 提供强大的 AI 模型。
属性值
提供商deepseek
认证DEEPSEEK_API_KEY
API兼容 OpenAI
Base URLhttps://api.deepseek.com

​
入门指南

1

获取你的 API key

在 platform.deepseek.com 创建 API key。
2

运行新手引导

openclaw onboard --auth-choice deepseek-api-key
这会提示你输入 API key，并将 deepseek/deepseek-v4-flash 设置为默认模型。
3

验证模型可用

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-flashDeepSeek V4 Flashtext1,000,000384,000默认模型；支持 V4 思考的表面
deepseek/deepseek-v4-proDeepSeek V4 Protext1,000,000384,000支持 V4 思考的表面
deepseek/deepseek-chatDeepSeek Chattext131,0728,192DeepSeek V3.2 非思考表面
deepseek/deepseek-reasonerDeepSeek Reasonertext131,07265,536启用推理的 V3.2 表面
V4 模型支持 DeepSeek 的 thinking 控制。OpenClaw 还会在后续轮次中重放 DeepSeek reasoning_content，因此带工具 调用的思考会话可以继续。 将 DeepSeek V4 模型与 /think xhigh 或 /think max 配合使用，以请求 DeepSeek 的 最大 reasoning_effort。

​
思考和工具

相比大多数兼容 OpenAI 的提供商，DeepSeek V4 思考会话有更严格的重放契约：在启用思考的轮次使用工具后，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" },
    },
  },
}

​
相关内容

模型选择

选择提供商、模型引用和故障转移行为。

配置参考

智能体、模型和提供商的完整配置参考。