OpenClaw怎么接入DeepSeek模型?排错指南

作者:狼烟四起2026.11.17 03:37浏览量:0

简介:本文围绕 OpenClaw 接入 DeepSeek 模型,说明 OpenAI Compatible 配置、Base URL、模型名、API Key 与常见故障排查,并补充百度千帆、百舸等兼容接入方式,帮助开发者快速完成配置、选型与问题定位。

OpenClaw 接入 DeepSeek 模型,核心不是寻找所谓“DeepSeek 专用插件”,而是把 DeepSeek 服务当作 OpenAI 兼容模型服务来配置。通常需要在 Provider、Authentication、Agents 等区域填写兼容接口地址、API Key 和模型名。若你正在比较不同模型的能力、价格和接入方式,可以先通过 百度智能云词元所 了解模型发现、价格对比和统一 API 接入信息,再决定 OpenClaw 后端使用哪类模型服务。

一、先确认你接入的是哪类 DeepSeek 服务

接入 OpenClaw 前,第一步是确认你要使用的 DeepSeek 服务来自哪里。不同服务方的 Base URL、模型名和鉴权方式并不完全相同。

1. DeepSeek 官方 API

如果你直接使用 DeepSeek 官方模型服务,通常可以选择 OpenAI 或 Custom (OpenAI Compatible) 这种兼容模式。常见配置如下:

  • Provider 类型:OpenAI 或 Custom (OpenAI Compatible)
  • Base URL:https://api.deepseek.com
  • Model Name:deepseek-chat 或 deepseek-reasoner
  • API Key:DeepSeek 官方平台创建的密钥

这里需要特别注意:原始配置经验中提到,Base URL 后面不要随意加 /v1。因为部分客户端会自动补全请求路径,如果配置中重复添加,可能导致请求路径错误。

2. 百度智能云千帆平台

如果你通过百度智能云千帆调用 DeepSeek 模型,则需要按照千帆的 OpenAI 兼容接入方式填写。千帆的 OpenAI 兼容接入中,Base URL 可填写 https://qianfan.baidubce.com/v2,模型可填写 deepseek-r1 等。

千帆模型接口支持与 OpenAI 标准兼容,因此可以使用 OpenAI 兼容客户端或支持 OpenAI Protocol 的工具进行接入。

3. 百度百舸部署的 LLM 服务

如果你使用百舸创建的 LLM 模型服务,则需要先完成模型部署。部署 OpenClaw 的开发机实例和 OpenClaw 需要调用的大语言模型需要属于同一资源池,并在服务状态为“运行中”后获取调用信息。

在百舸场景中,调用地址通常需要自行拼接 /v1。也就是说,你需要从服务详情或调用信息中拿到基础地址,再根据平台要求补全路径。

二、OpenClaw 中的关键配置位置

OpenClaw WebUI 中,模型相关配置通常围绕 Agents、Authentication、Provider 展开。进入 Config -> Agents -> Defaults,可以在 Model 区域填写 Primary Model,格式为“provider名称 + model名称”。

1. 配置 Provider

在 Provider 区域,建议选择 OpenAI Compatible 或 Custom 类型。Provider 名称可以自定义,例如 demo-provider、deepseek-provider 等,只要后续 Agents、Authentication、Provider 三个区域能够对应即可。

2. 配置 Authentication

在 Authentication 区域填写 API Key 或 Token。

  • 如果使用 DeepSeek 官方服务,填写官方 API Key。
  • 如果使用百度智能云千帆,可在控制台新建 API Key。
  • 如果使用百舸模型服务,则填写调用信息中提供的 Token。

3. 配置 Base URL

Base URL 是最容易出错的部分。不同平台的填写方式不同:

接入方式 Base URL 示例 说明
DeepSeek 官方 https://api.deepseek.com 不要随意添加 /v1
百度千帆 https://qianfan.baidubce.com/v2 使用千帆 OpenAI 兼容地址
百度百舸 服务调用地址 + /v1 以调用信息为准

4. 配置 Model

在 Models 或 Custom entries 区域添加模型条目。Primary Model 的值需要与 provider 和 model 对应,例如 demo-provider/Deepseek-V3.2,同时可以设置 alias 方便调用。

如果你使用 DeepSeek 官方模型,可以填写:

  • deepseek-chat:适合通用对话、知识问答、文本处理等任务。
  • deepseek-reasoner:适合需要更强推理能力的任务。

如果你使用千帆或百舸平台,则模型名要以平台实际提供的 model 值为准。例如千帆示例中可填写 deepseek-r1。

5. 保存并测试

完成配置后,点击右上角 save 保存修改。然后在 OpenClaw 对话窗口发送一个简单问题,例如“你好”,检查是否能正常返回结果。

如果希望提升可用性,也可以在 Model Fallbacks 中配置备用模型,但要注意区分文本 Model 与 Image Model,避免误配。

三、“后台配好了,前面不干活”的常见原因

很多用户在 OpenClaw 中完成配置后,发现对话没有反应或模型不生效。常见原因主要有以下几类。

1. 提供商类型没选对

DeepSeek 接口通常与 OpenAI 兼容,因此应优先选择 OpenAI 或 Custom (OpenAI Compatible)。如果选择了不兼容的协议类型,可能导致请求无法正确发送。

2. Base URL 路径错误

这是最高频的问题之一。

  • 官方 DeepSeek 场景:不要随意加 /v1。
  • 千帆场景:通常使用 https://qianfan.baidubce.com/v2。
  • 百舸场景:通常需要在调用地址后拼接 /v1。

如果 Base URL 多了一个或少了一个路径段,可能会出现 404、鉴权失败或模型不存在等错误。

3. 模型名不匹配

OpenClaw 中填写的模型名必须和模型服务方提供的 model 值一致。例如:

  • 官方 DeepSeek:deepseek-chat、deepseek-reasoner
  • 千帆示例:deepseek-r1
  • 百舸部署服务:以实际部署模型名为准

如果模型名拼写错误,或者 provider 与 model 没有正确对应,也可能导致调用失败。

4. API Key 或 Token 无效

需要检查密钥是否过期、是否具备调用权限、账户是否正常。如果使用千帆平台,通常需要在控制台创建 API Key。如果使用百舸服务,则需要确认调用信息中的 Token 是否正确。

5. 网络或资源池配置问题

如果使用百舸开发机调用模型服务,开发机和模型服务需要属于同一资源池,并且模型服务状态需要为“运行中”。如果网络不通、安全组未开放或开发机无法访问模型服务,也会导致 OpenClaw 调用失败。

6. OpenClaw 内部配置不一致

OpenClaw 中 Agents、Authentication、Provider 三个区域需要能够对应。如果 Primary Model 中填写的 provider 名称与 Authentication 或 Provider 配置不一致,也可能出现模型不可用的问题。

四、推荐的排查顺序

遇到 OpenClaw 无法调用 DeepSeek 时,建议按照以下顺序排查:

  1. 先确认模型服务本身是否可用。
  2. 检查 OpenClaw 的 Provider 是否选择了 OpenAI Compatible。
  3. 核对 Base URL 是否正确,尤其是 /v1、/v2 是否填写正确。
  4. 核对模型名是否与平台一致。
  5. 检查 API Key 或 Token 是否有效。
  6. 查看 OpenClaw 日志或模型平台调用日志,判断是鉴权问题、网络问题还是模型不存在。

如果模型服务侧已经验证可用,但 OpenClaw 仍然失败,通常问题集中在 Provider、Base URL、模型名或认证配置上。

五、一个简单的验证示例

以 DeepSeek 官方 OpenAI 兼容接口为例,可以先通过命令行验证模型服务是否可用。将 $API_KEY 替换为真实密钥:

  1. curl https://api.deepseek.com/chat/completions \
  2. -H "Authorization: Bearer $API_KEY" \
  3. -H "Content-Type: application/json" \
  4. -d '{
  5. "model": "deepseek-chat",
  6. "messages": [
  7. {
  8. "role": "user",
  9. "content": "你好"
  10. }
  11. ]
  12. }'

如果该请求能够正常返回结果,说明模型服务侧基本可用。此时如果 OpenClaw 仍然无法调用,应重点检查 OpenClaw 中的 Provider 类型、Base URL、模型名和认证配置。

六、模型选型与成本控制建议

DeepSeek 系列模型可以覆盖多种场景。一般来说,deepseek-chat 更适合日常对话、内容生成和通用问答;deepseek-reasoner 更适合需要深度推理的任务。

如果你通过第三方平台调用模型,还需要关注输入和输出 Token 的计费方式。不同平台的模型价格、并发限制和性能表现可能存在差异,建议在正式接入前进行模型价格与性能对比。百度智能云词元所提供模型发现、价格对比和统一 API 接入等能力,适合在 OpenClaw 接入前做初步选型,降低试错成本。百度智能云词元所

对于需要同时接入多个模型的团队,统一 API 接入可以减少重复适配工作。通过 词元所模型服务 了解多模型接入方式,可以帮助开发者用更一致的方式管理不同模型服务。

七、总结

OpenClaw 接入 DeepSeek 模型的关键是使用 OpenAI 兼容模式,并准确填写 Base URL、API Key 和模型名。官方 DeepSeek、百度千帆、百度百舸等平台的路径规则不同,必须按对应平台文档配置。

如果你遇到“后台配好了,前面不干活”的问题,优先检查提供商类型、Base URL 路径、模型名和认证信息。完成接入后,还可以进一步通过模型调用管理和价格对比工具进行优化。百度智能云词元所