OpenClaw 接入 DeepSeek V4官方 Provider 插件安装、配置与 Thinking 推理回放实战指南【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本文围绕 OpenClaw 官方 DeepSeek Provider 插件展开系统讲解如何安装openclaw/deepseek-provider、通过 CLI 完成 API Key 认证与模型选型、理解 V4 系列内置模型目录以及 OpenClaw 如何自动处理 DeepSeekreasoning_content回放以支撑多轮工具调用。读完本文你将能在一台任意操作系统的主机上快速把 OpenClaw 的默认模型切换为 DeepSeek V4并正确配置非交互式安装、守护进程环境变量与文本/视觉模型的选型。DeepSeek Provider 概览DeepSeek 提供与 OpenAI 兼容的 API其模型可以直接作为 OpenClaw 的大模型后端使用。OpenClaw 通过官方插件openclaw/deepseek-provider提供完整支持插件注册的 Provider ID 为deepseek并提供usageProviders用量统计契约。属性值Providerdeepseek认证变量DEEPSEEK_API_KEYAPI 兼容OpenAI-compatibleBase URLhttps://api.deepseek.com包名openclaw/deepseek-provider安装路由npm 或 ClawHubclawhub:openclaw/deepseek-provider从插件清单 extensions/deepseek/openclaw.plugin.json 可以看到该插件声明了providerEndpointsendpointClass 为deepseek-nativehosts 为api.deepseek.com、providerRequest家族family 为deepseek并默认启用enabledByDefault: true。插件入口 extensions/deepseek/index.ts 通过defineSingleProviderPluginEntry完成注册其模型目录采用discoveryMode: strict并开启liveModelDiscovery意味着 Gateway 运行时会尝试做实时模型发现。安装插件安装官方插件后需要重启 Gateway 才能生效openclaw plugins install openclaw/deepseek-provider openclaw gateway restart插件包发布到 npm 与 ClawHub 双通道见 extensions/deepseek/package.json 中的publishToNpm/publishToClawHub安装路由同样支持clawhub:openclaw/deepseek-provider。该包要求宿主 OpenClaw 版本2026.6.8插件 API 兼容版本2026.9.3。快速上手从 API Key 到默认模型1. 获取 API Key前往 DeepSeek 开放平台创建 API Keyplatform.deepseek.com的 API Keys 页面。2. 运行认证向导openclaw onboard --auth-choice deepseek-api-key向导会提示输入你的 API Key并将deepseek/deepseek-v4-pro设置为默认模型。3. 验证模型可用openclaw models list --provider deepseek如果不启动 Gateway也可以直接查看插件的静态模型目录openclaw models list --all --provider deepseek认证向导会保留你已有的模型条目而把生成的目录行交给发现机制去补全。当配置models.mode: replace时向导还会写入内置目录因为该模式下会跳过发现流程。非交互式安装对于脚本化或无头环境如 CI、Docker可以一次性传入全部参数openclaw onboard --non-interactive \ --mode local \ --auth-choice deepseek-api-key \ --deepseek-api-key $DEEPSEEK_API_KEY \ --skip-health \ --accept-risk这里的--deepseek-api-key正是插件清单中声明的 CLI 选项见 extensions/deepseek/openclaw.plugin.json 的providerAuthChoicesoptionKey 为deepseekApiKeychoiceId 为deepseek-api-key。守护进程注意事项如果 Gateway 以守护进程方式运行launchd / systemd请确保DEEPSEEK_API_KEY对该进程可见例如写入~/.openclaw/.env或通过env.shellEnv注入。内置模型目录插件在 extensions/deepseek/openclaw.plugin.json 的modelCatalog.providers.deepseek中声明了三个 V4 模型并由 extensions/deepseek/models.ts 通过buildManifestModelProviderConfig转成运行时的ModelDefinitionConfig统一标记为api: openai-completions模型引用名称输入上下文窗口最大输出说明deepseek/deepseek-v4-flashDeepSeek V4 Flashtext1,000,000384,000快速的 V4 思考能力模型deepseek/deepseek-v4-proDeepSeek V4 Protext1,000,000384,000默认模型V4 最强能力deepseek/deepseek-v4-flash-vision-expDeepSeek V4 Flash Vision实验性text, image1,000,000384,000实验性图像理解三个模型的reasoning均为truecompat都声明了supportsUsageInStreaming、supportsReasoningEffort与maxTokensField: max_tokens且codeMode: preferred。上下文窗口统一为 100 万 token、最大输出 384,000 token。重要提醒DeepSeek 已于 2026 年 7 月 24 日 15:59 UTC 退役deepseek-chat与deepseek-reasoner这两个模型 ID。请把已配置的旧模型引用迁移到deepseek/deepseek-v4-flash或deepseek/deepseek-v4-pro。成本与计费说明OpenClaw 展示的本地成本为估算值。三个模型在清单中分别带有单价input / output / cacheRead / cacheWrite例如 V4 Flash 为0.14 / 0.28 / 0.0028 / 0V4 Pro 为0.435 / 0.87 / 0.003625 / 0。视觉模型的捆绑估算使用 DeepSeek 峰值费率其公布的错峰费率约为一半。DeepSeek 可能调整费率计费请以其官方 Models Pricing 页面为准。图像输入需要处理图片时选择deepseek/deepseek-v4-flash-vision-exp。普通 Flash 与 Pro 模型仅支持文本输入。DeepSeek 的实验性视觉模型通过同一 API 与 API Key 接受 PNG、JPEG、GIF 和 WebP 图像。在配置文件中可按如下方式指定视觉模型{ env: { vars: { DEEPSEEK_API_KEY: sk-... } }, agents: { defaults: { model: { primary: deepseek/deepseek-v4-flash-vision-exp }, }, }, }Thinking 控制与推理内容回放V4 模型支持 DeepSeek 的thinking控制。在 OpenClaw 中使用/think xhigh或/think max可请求 DeepSeek 最大的reasoning_effort两者都会映射为max。插件为 V4 模型注册了思考等级画像off、minimal、low、medium、high、xhigh、max默认等级为high见 extensions/deepseek/thinking.ts。入口处通过resolveThinkingProfile与isModernModelRef判断模型是否为 V4 系列extensions/deepseek/index.ts流式请求则通过 extensions/deepseek/stream.ts 中的createDeepSeekV4ThinkingWrapper包装底层streamFn。关键机制——推理回放reasoning replayDeepSeek V4 的思考会话要求在后续请求中来自思考回合的 assistant 消息必须包含reasoning_content字段。OpenClaw 的 DeepSeek 插件会自动回填该字段因此以下场景都能正常进行多轮工具调用历史消息来自其他 OpenAI 兼容提供商原生没有reasoning_content历史消息是普通 assistant 消息无思考内容会话中途切换提供商也无需执行/new。回放行为由buildProviderReplayFamilyHooksfamily 为openai-compatibledropReasoningFromHistory: false提供测试用例 extensions/deepseek/deepseek.live.test.ts 中专门覆盖了两类场景前一轮是带工具调用的 assistant 消息、前一轮是普通文本 assistant 消息两者回放时都会补上reasoning_content: 。当思考被禁用包括 UI 中的None选项时OpenClaw 会发送thinking: { type: disabled }并从外发历史中剥离回放的reasoning_content让会话始终保持在非思考的 DeepSeek 路径上。模型选型建议新安装的认证向导默认选择更强的deepseek/deepseek-v4-pro。当更看重成本或延迟、而非极限能力时可改用deepseek/deepseek-v4-flash。V4 Pro 与 V4 Flash 均支持思考与工具调用区别主要在于能力上限与单价。源码视角插件如何组织DeepSeek 插件源码位于 extensions/deepseek模块职责清晰index.ts插件入口注册 provider、目录构建、思考画像、流包装、用量统计与上下文溢出错误识别deepseek ... input too long / context exceed正则匹配models.ts从清单生成模型目录导出DEEPSEEK_BASE_URL与isDeepSeekV4ModelId/isDeepSeekV4ModelRef判断函数provider-catalog.ts构建ModelProviderConfigbaseUrl api modelsprovider-discovery.ts静态目录发现入口供openclaw models list --all使用stream.tsV4 思考流包装shouldPatchModel判定是否对模型做 thinking 参数修补thinking.tsV4 思考等级画像onboard.ts认证向导应用配置写入主模型引用与DeepSeek别名models.mode: replace时写入完整内置目录。配置示例在 OpenClaw 配置文件中最小可用的 DeepSeek 配置如下{ env: { vars: { DEEPSEEK_API_KEY: sk-... } }, agents: { defaults: { model: { primary: deepseek/deepseek-v4-pro }, }, }, }若同时配置 failover 或次要模型可参考 docs/concepts/model-providers.md 中的模型引用与故障转移说明完整配置项agents、models、providers 等见 docs/gateway/configuration-reference.md。现场验证Live 测试双 V4 模型检查从现代模型 live 测试套件中单独运行 DeepSeek V4 直连检查OPENCLAW_LIVE_PROVIDERSdeepseek \ OPENCLAW_LIVE_MODELSdeepseek/deepseek-v4-flash,deepseek/deepseek-v4-pro \ pnpm test:live src/agents/models.profiles.live.test.ts该测试验证两个 V4 模型都能完成请求且 thinking/工具后续轮次能保留 DeepSeek 所要求的回放负载。实验性视觉模型检查使用同一个DEEPSEEK_API_KEY检查视觉模型OPENCLAW_LIVE_DEEPSEEK_MODELdeepseek-v4-flash-vision-exp \ pnpm test:live extensions/deepseek/deepseek.live.test.ts该测试覆盖文本生成、生成图像识别构造纯色 PNG 并断言识别结果以及思考回放三类检查。测试通过createDeepSeekV4ThinkingWrapper(streamSimple, thinkingLevel)直接驱动流式调用并借助onPayload捕获外发请求断言 assistant 消息中的reasoning_content与tool_calls结构与 DeepSeek 要求一致相关实现见 extensions/deepseek/deepseek.live.test.ts。常见问题与排查deepseek-chat/deepseek-reasoner报错模型已退役将模型引用改为deepseek/deepseek-v4-flash或deepseek/deepseek-v4-pro。Gateway 无 Key确认守护进程launchd/systemd环境中有DEEPSEEK_API_KEY可写入~/.openclaw/.env或经env.shellEnv注入。上下文超长插件内置了对input too long/context exceed类错误的识别见 extensions/deepseek/index.ts 的matchesContextOverflowError可据此做降级或重试处理。多轮工具调用中断确认会话处于思考开启状态且插件回放钩子生效不要手动丢弃 assistant 消息的reasoning_content。小结DeepSeek V4 与 OpenClaw 的集成要点可归纳为三句话安装openclaw/deepseek-provider并重启 Gateway通过openclaw onboard --auth-choice deepseek-api-key完成认证并把默认模型设为deepseek/deepseek-v4-pro思考会话由插件自动回放reasoning_content多轮工具调用无需额外干预。配合--non-interactive参数与非交互式环境变量注入即可在脚本化部署中无缝接入。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
OpenClaw 接入 DeepSeek V4官方 Provider 插件安装、配置与 Thinking 推理回放实战指南【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本文围绕 OpenClaw 官方 DeepSeek Provider 插件展开系统讲解如何安装openclaw/deepseek-provider、通过 CLI 完成 API Key 认证与模型选型、理解 V4 系列内置模型目录以及 OpenClaw 如何自动处理 DeepSeekreasoning_content回放以支撑多轮工具调用。读完本文你将能在一台任意操作系统的主机上快速把 OpenClaw 的默认模型切换为 DeepSeek V4并正确配置非交互式安装、守护进程环境变量与文本/视觉模型的选型。DeepSeek Provider 概览DeepSeek 提供与 OpenAI 兼容的 API其模型可以直接作为 OpenClaw 的大模型后端使用。OpenClaw 通过官方插件openclaw/deepseek-provider提供完整支持插件注册的 Provider ID 为deepseek并提供usageProviders用量统计契约。属性值Providerdeepseek认证变量DEEPSEEK_API_KEYAPI 兼容OpenAI-compatibleBase URLhttps://api.deepseek.com包名openclaw/deepseek-provider安装路由npm 或 ClawHubclawhub:openclaw/deepseek-provider从插件清单 extensions/deepseek/openclaw.plugin.json 可以看到该插件声明了providerEndpointsendpointClass 为deepseek-nativehosts 为api.deepseek.com、providerRequest家族family 为deepseek并默认启用enabledByDefault: true。插件入口 extensions/deepseek/index.ts 通过defineSingleProviderPluginEntry完成注册其模型目录采用discoveryMode: strict并开启liveModelDiscovery意味着 Gateway 运行时会尝试做实时模型发现。安装插件安装官方插件后需要重启 Gateway 才能生效openclaw plugins install openclaw/deepseek-provider openclaw gateway restart插件包发布到 npm 与 ClawHub 双通道见 extensions/deepseek/package.json 中的publishToNpm/publishToClawHub安装路由同样支持clawhub:openclaw/deepseek-provider。该包要求宿主 OpenClaw 版本2026.6.8插件 API 兼容版本2026.9.3。快速上手从 API Key 到默认模型1. 获取 API Key前往 DeepSeek 开放平台创建 API Keyplatform.deepseek.com的 API Keys 页面。2. 运行认证向导openclaw onboard --auth-choice deepseek-api-key向导会提示输入你的 API Key并将deepseek/deepseek-v4-pro设置为默认模型。3. 验证模型可用openclaw models list --provider deepseek如果不启动 Gateway也可以直接查看插件的静态模型目录openclaw models list --all --provider deepseek认证向导会保留你已有的模型条目而把生成的目录行交给发现机制去补全。当配置models.mode: replace时向导还会写入内置目录因为该模式下会跳过发现流程。非交互式安装对于脚本化或无头环境如 CI、Docker可以一次性传入全部参数openclaw onboard --non-interactive \ --mode local \ --auth-choice deepseek-api-key \ --deepseek-api-key $DEEPSEEK_API_KEY \ --skip-health \ --accept-risk这里的--deepseek-api-key正是插件清单中声明的 CLI 选项见 extensions/deepseek/openclaw.plugin.json 的providerAuthChoicesoptionKey 为deepseekApiKeychoiceId 为deepseek-api-key。守护进程注意事项如果 Gateway 以守护进程方式运行launchd / systemd请确保DEEPSEEK_API_KEY对该进程可见例如写入~/.openclaw/.env或通过env.shellEnv注入。内置模型目录插件在 extensions/deepseek/openclaw.plugin.json 的modelCatalog.providers.deepseek中声明了三个 V4 模型并由 extensions/deepseek/models.ts 通过buildManifestModelProviderConfig转成运行时的ModelDefinitionConfig统一标记为api: openai-completions模型引用名称输入上下文窗口最大输出说明deepseek/deepseek-v4-flashDeepSeek V4 Flashtext1,000,000384,000快速的 V4 思考能力模型deepseek/deepseek-v4-proDeepSeek V4 Protext1,000,000384,000默认模型V4 最强能力deepseek/deepseek-v4-flash-vision-expDeepSeek V4 Flash Vision实验性text, image1,000,000384,000实验性图像理解三个模型的reasoning均为truecompat都声明了supportsUsageInStreaming、supportsReasoningEffort与maxTokensField: max_tokens且codeMode: preferred。上下文窗口统一为 100 万 token、最大输出 384,000 token。重要提醒DeepSeek 已于 2026 年 7 月 24 日 15:59 UTC 退役deepseek-chat与deepseek-reasoner这两个模型 ID。请把已配置的旧模型引用迁移到deepseek/deepseek-v4-flash或deepseek/deepseek-v4-pro。成本与计费说明OpenClaw 展示的本地成本为估算值。三个模型在清单中分别带有单价input / output / cacheRead / cacheWrite例如 V4 Flash 为0.14 / 0.28 / 0.0028 / 0V4 Pro 为0.435 / 0.87 / 0.003625 / 0。视觉模型的捆绑估算使用 DeepSeek 峰值费率其公布的错峰费率约为一半。DeepSeek 可能调整费率计费请以其官方 Models Pricing 页面为准。图像输入需要处理图片时选择deepseek/deepseek-v4-flash-vision-exp。普通 Flash 与 Pro 模型仅支持文本输入。DeepSeek 的实验性视觉模型通过同一 API 与 API Key 接受 PNG、JPEG、GIF 和 WebP 图像。在配置文件中可按如下方式指定视觉模型{ env: { vars: { DEEPSEEK_API_KEY: sk-... } }, agents: { defaults: { model: { primary: deepseek/deepseek-v4-flash-vision-exp }, }, }, }Thinking 控制与推理内容回放V4 模型支持 DeepSeek 的thinking控制。在 OpenClaw 中使用/think xhigh或/think max可请求 DeepSeek 最大的reasoning_effort两者都会映射为max。插件为 V4 模型注册了思考等级画像off、minimal、low、medium、high、xhigh、max默认等级为high见 extensions/deepseek/thinking.ts。入口处通过resolveThinkingProfile与isModernModelRef判断模型是否为 V4 系列extensions/deepseek/index.ts流式请求则通过 extensions/deepseek/stream.ts 中的createDeepSeekV4ThinkingWrapper包装底层streamFn。关键机制——推理回放reasoning replayDeepSeek V4 的思考会话要求在后续请求中来自思考回合的 assistant 消息必须包含reasoning_content字段。OpenClaw 的 DeepSeek 插件会自动回填该字段因此以下场景都能正常进行多轮工具调用历史消息来自其他 OpenAI 兼容提供商原生没有reasoning_content历史消息是普通 assistant 消息无思考内容会话中途切换提供商也无需执行/new。回放行为由buildProviderReplayFamilyHooksfamily 为openai-compatibledropReasoningFromHistory: false提供测试用例 extensions/deepseek/deepseek.live.test.ts 中专门覆盖了两类场景前一轮是带工具调用的 assistant 消息、前一轮是普通文本 assistant 消息两者回放时都会补上reasoning_content: 。当思考被禁用包括 UI 中的None选项时OpenClaw 会发送thinking: { type: disabled }并从外发历史中剥离回放的reasoning_content让会话始终保持在非思考的 DeepSeek 路径上。模型选型建议新安装的认证向导默认选择更强的deepseek/deepseek-v4-pro。当更看重成本或延迟、而非极限能力时可改用deepseek/deepseek-v4-flash。V4 Pro 与 V4 Flash 均支持思考与工具调用区别主要在于能力上限与单价。源码视角插件如何组织DeepSeek 插件源码位于 extensions/deepseek模块职责清晰index.ts插件入口注册 provider、目录构建、思考画像、流包装、用量统计与上下文溢出错误识别deepseek ... input too long / context exceed正则匹配models.ts从清单生成模型目录导出DEEPSEEK_BASE_URL与isDeepSeekV4ModelId/isDeepSeekV4ModelRef判断函数provider-catalog.ts构建ModelProviderConfigbaseUrl api modelsprovider-discovery.ts静态目录发现入口供openclaw models list --all使用stream.tsV4 思考流包装shouldPatchModel判定是否对模型做 thinking 参数修补thinking.tsV4 思考等级画像onboard.ts认证向导应用配置写入主模型引用与DeepSeek别名models.mode: replace时写入完整内置目录。配置示例在 OpenClaw 配置文件中最小可用的 DeepSeek 配置如下{ env: { vars: { DEEPSEEK_API_KEY: sk-... } }, agents: { defaults: { model: { primary: deepseek/deepseek-v4-pro }, }, }, }若同时配置 failover 或次要模型可参考 docs/concepts/model-providers.md 中的模型引用与故障转移说明完整配置项agents、models、providers 等见 docs/gateway/configuration-reference.md。现场验证Live 测试双 V4 模型检查从现代模型 live 测试套件中单独运行 DeepSeek V4 直连检查OPENCLAW_LIVE_PROVIDERSdeepseek \ OPENCLAW_LIVE_MODELSdeepseek/deepseek-v4-flash,deepseek/deepseek-v4-pro \ pnpm test:live src/agents/models.profiles.live.test.ts该测试验证两个 V4 模型都能完成请求且 thinking/工具后续轮次能保留 DeepSeek 所要求的回放负载。实验性视觉模型检查使用同一个DEEPSEEK_API_KEY检查视觉模型OPENCLAW_LIVE_DEEPSEEK_MODELdeepseek-v4-flash-vision-exp \ pnpm test:live extensions/deepseek/deepseek.live.test.ts该测试覆盖文本生成、生成图像识别构造纯色 PNG 并断言识别结果以及思考回放三类检查。测试通过createDeepSeekV4ThinkingWrapper(streamSimple, thinkingLevel)直接驱动流式调用并借助onPayload捕获外发请求断言 assistant 消息中的reasoning_content与tool_calls结构与 DeepSeek 要求一致相关实现见 extensions/deepseek/deepseek.live.test.ts。常见问题与排查deepseek-chat/deepseek-reasoner报错模型已退役将模型引用改为deepseek/deepseek-v4-flash或deepseek/deepseek-v4-pro。Gateway 无 Key确认守护进程launchd/systemd环境中有DEEPSEEK_API_KEY可写入~/.openclaw/.env或经env.shellEnv注入。上下文超长插件内置了对input too long/context exceed类错误的识别见 extensions/deepseek/index.ts 的matchesContextOverflowError可据此做降级或重试处理。多轮工具调用中断确认会话处于思考开启状态且插件回放钩子生效不要手动丢弃 assistant 消息的reasoning_content。小结DeepSeek V4 与 OpenClaw 的集成要点可归纳为三句话安装openclaw/deepseek-provider并重启 Gateway通过openclaw onboard --auth-choice deepseek-api-key完成认证并把默认模型设为deepseek/deepseek-v4-pro思考会话由插件自动回放reasoning_content多轮工具调用无需额外干预。配合--non-interactive参数与非交互式环境变量注入即可在脚本化部署中无缝接入。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
` 与 `/df` 接口深度解析)
` 热路径)
