Skip to main content
DeepSeek 提供强大的 AI 模型,并带有兼容 OpenAI 的 API。

安装插件

安装官方插件,然后重启 Gateway:

入门

1

获取你的 API 密钥

platform.deepseek.com 创建一个 API 密钥。
2

运行 onboarding

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

验证模型是否可用

如需在没有运行 Gateway 的情况下查看插件的静态目录:
对于脚本化或无头安装,请直接传入所有标志:
如果 Gateway 作为守护进程运行(launchd/systemd),请确保 DEEPSEEK_API_KEY 对该进程可用(例如放在 ~/.openclaw/.env 中,或通过 env.shellEnv 提供)。

内置目录

DeepSeek 已于 2026 年 7 月 24 日 15:59 UTC 停用 deepseek-chatdeepseek-reasoner。这些模型 ID 已无法访问。请将已配置的模型引用迁移到 deepseek/deepseek-v4-flashdeepseek/deepseek-v4-pro
OpenClaw 的本地成本估算遵循 DeepSeek 公布的 cache-hit、cache-miss 和输出费率。DeepSeek 可能会更改这些费率; 其 Models & Pricing 页面是计费的权威来源。
V4 模型支持 DeepSeek 的 thinking 控制。OpenClaw 也会在后续轮次中重放 DeepSeek 的 reasoning_content,因此带工具调用的 thinking 会话可以继续。 在 DeepSeek V4 模型上使用 /think xhigh/think max 可请求 DeepSeek 的 最大 reasoning_effort;这两者都会映射为 "max"

Thinking 与工具

DeepSeek V4 thinking 会话要求将来自启用了 thinking 的轮次的已重放 assistant 消息 在后续请求中包含 reasoning_content。 OpenClaw 的 DeepSeek 插件会自动回填该字段,因此正常的多轮工具使用可以在 deepseek/deepseek-v4-flashdeepseek/deepseek-v4-pro 上正常工作,即使历史记录来自另一个 OpenAI 兼容提供商(没有原生 reasoning_content)或普通的 assistant 消息。 在会话中途切换提供商后,也不需要使用 /new 当 thinking 被禁用时(包括 UI 中选择 None),OpenClaw 会发送 thinking: { type: "disabled" },并从外发历史记录中移除重放的 reasoning_content, 使会话保持在非 thinking 的 DeepSeek 路径上。 全新 onboarding 会选择更强大的 deepseek/deepseek-v4-pro 模型。当成本或延迟比 最大能力更重要时,请使用 deepseek/deepseek-v4-flash

在线测试

若只运行现代模型 live 套件中 DeepSeek V4 直接模型检查,请执行:
用于验证两个 V4 模型都能完成,并且 thinking/tool 后续轮次会保留 DeepSeek 所需的重放载荷。

配置示例

相关内容

模型选择

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

配置参考

agents、models 和 providers 的完整配置参考。