OpenClaw 作为一款强大的开源 AI 助手框架，支持接入多种大模型。DeepSeek 凭借其出色的推理能力和极高的性价比，是配置 OpenClaw 的绝佳选择。本文将为你提供两种配置方法：交互式向导（推荐新手）和手动修改配置文件（推荐进阶），操作简单易上手。

准备工作：获取 DeepSeek API Key

在配置前，你需要先拥有 DeepSeek 的官方授权，完成密钥获取与账户准备。

访问 DeepSeek 开放平台：https://platform.deepseek.com/ 完成账号注册流程。

登录平台后进入 API Keys 栏目，点击创建按钮，生成一个新的 API Key，格式为 sk-xxxxxxxx 类型。

DeepSeek API 调用为付费模式，建议先充值小额金额（如 10 元），用于配置测试与功能验证。

配置方法一：交互式向导（推荐新手）

这是最简单快捷的配置方式，通过命令行交互式引导完成全部设置，无需手动修改文件。

打开终端工具，直接执行以下配置启动命令，进入向导流程：

openclaw onboard

进入提供商选择环节，在列表中优先选择 DeepSeek 选项。 若列表中未显示 DeepSeek，选择 OpenAI 或 Custom Provider 即可，DeepSeek 完全兼容 OpenAI 接口格式。

按照向导提示，依次填写核心配置参数：

Base URL：输入 https://api.deepseek.com/v1

API Key：粘贴提前获取的 DeepSeek API Key

Model ID：输入 deepseek-chat（通用对话模型）或 deepseek-reasoner（R1 推理模型）

配置方法二：手动修改配置文件

若需要精细化配置、或向导配置失败，可通过手动编辑配置文件完成部署，稳定性更强。

首先找到 OpenClaw 配置文件所在路径，文件默认存放在用户主目录下的 .openclaw 文件夹中。

Windows 系统配置路径：

C:\Users\[用户名]\.openclaw\openclaw.json

macOS/Linux 系统配置路径：

~/.openclaw/openclaw.json

使用文本编辑器打开 openclaw.json 文件，清空原有内容或新增以下配置，将文中你的DeepSeek-Key替换为自己的真实密钥：

{
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "你的DeepSeek-Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat"
      }
    }
  }
}

验证与重启

所有配置修改完成后，必须重启服务才能让参数生效，不可跳过此步骤。

在终端中执行以下网关重启命令，加载新配置：

openclaw gateway restart

重启完成后，打开 OpenClaw 聊天界面，输入测试语句你好，若正常收到 DeepSeek 模型回复，即代表配置成功。

常见问题

连接失败问题：优先检查 API Key 是否填写正确，同时确认网络可正常访问 api.deepseek.com 域名。

模型快速切换：在聊天窗口直接输入指令 /model deepseek/deepseek-reasoner，即可一键切换至 R1 推理模型。