OpenClaw 接入 DeepSeek 配置指南

2026-05-05阅读 0热度 0

ai 人工智能 DeepSeek OpenClaw clawbot

OpenClaw 接入 DeepSeek 配置指南

今天咱们来聊聊，怎么把强大的 DeepSeek 推理模型（R1）无缝接入 OpenClaw 的工作流。本质上，就是利用 DeepSeek 提供的 OpenAI 兼容接口，让 OpenClaw 的 Agent 默认调用这个 “思考型” 模型来处理复杂任务。配置过程其实很清晰，一步步走下来，效率提升非常明显。

1. 前提条件

开始动手前，你得先确保手头有这么几样东西：

首先，一个已经安装好、并且能正常运行的 OpenClaw 环境，这是基础。

其次，一个有效的 DeepSeek API Key。这相当于打开大模型能力的钥匙。

最后，确保你有权限编辑 OpenClaw 的 agent 配置文件，通常是个 JSON 文件。

至于 DeepSeek API Key 去哪儿找？直接访问其官方平台就能申请：

https://platform.deepseek.com/

2. OpenClaw 模型配置

核心操作就是，在 OpenClaw 的 agent 配置文件里，新增一个 DeepSeek 的模型提供商（provider）。

配置文件通常放在这个路径：

~/.openclaw/openclaw.json

具体配置示例可以参考下面这段。注意，重点是理解每个模块的作用，特别是 `providers` 和 `agents` 这两个部分：

{
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/chat/completions",
        "apiKey": "sk-你的密钥",
        "api": "openai-completions",
        "models": [{
          "id": "deepseek-reasoner",
          "name": "deepseek reasoner",
          "reasoning": true,
          "input": ["text"],
          "cost": {
            "input": 0,
            "output": 0,
            "cacheRead": 0,
            "cacheWrite": 0
          },
          "contextWindow": 32000,
          "maxTokens": 64000
        }]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-reasoner"
      },
      "models": {
        "deepseek/deepseek-reasoner": {
          "alias": "deepseek r1"
        }
      }
    }
  }
}

3. 关键字段说明

配置文件里字段不少，但抓住关键几个就够用了。下面这个表格能帮你快速理解核心配置项的作用：

字段	说明
`providers.deepseek`	新增 DeepSeek 模型提供商
`baseUrl`	DeepSeek API 地址
`apiKey`	你的 DeepSeek API Key
`api`	指定使用 OpenAI 兼容接口
`id`	模型 ID，这里是 deepseek-reasoner
`reasoning`	必须设为 true 以启用推理能力
`contextWindow`	最大上下文长度，决定能“记住”多少内容
`maxTokens`	最大生成 token 数量，影响回答长度
`primary`	指定 Agent 默认使用的模型

4. 模型名称

配置成功后，在 OpenClaw 内部调用模型时，需要使用这个完整的 ID：

deepseek/deepseek-reasoner

为了方便记忆和使用，上面配置里还给它设置了一个更简短的别名（alias）：

deepseek r1

5. 启动 OpenClaw

保存好配置文件之后，其实不需要复杂的重启操作。通常，只需要刷新一下 OpenClaw 的 Web 管理页面，新的配置就会生效。

如果想观察运行状态和日志，可以打开终端运行这个命令：

openclaw logs --follow

6. 常见问题

API 类型

为什么配置里写的是 "openai-completions"？这是因为 DeepSeek 的 API 设计完全兼容 OpenAI 的格式。这样一来，所有为 OpenAI 设计的工具和框架（比如 OpenClaw）就能几乎无缝地接入 DeepSeek，大大降低了集成门槛。

"api": "openai-completions"

推理模型配置

这里有个关键点，deepseek-reasoner 是专门的推理模型。要让它在 Agent 中发挥“思考”作用，下面这个开关必须打开：

"reasoning": true

如果这个值设置成了 false 或者漏掉了，那么 Agent 可能只会进行常规的文本补全，而无法调用其深度推理能力，效果就大打折扣了。

7. 完成

完成以上所有配置步骤后，你的 OpenClaw Agent 就已经成功武装上了 DeepSeek Reasoner (R1) 这个强大的推理引擎，后续的复杂任务会默认由它来处理。

想了解更多关于 OpenClaw 的详细信息或最新动态，可以访问其官方网站：uclawbot.com

OpenClaw 接入 DeepSeek 配置指南