DeepSeek V4 接入龙虾（OpenClaw）保姆级配置教程

Coding的叶子

2270人浏览 · 2026-04-27 09:17:49

Coding的叶子 · 2026-04-27 09:17:49 发布

DeepSeek V4 已正式发布，作为目前性能最强劲的国产大语言模型之一，它在代码生成、逻辑推理和长文本理解等方面均表现出色。本教程将手把手带你完成 DeepSeek V4 接入龙虾（OpenClaw）的全流程配置，即便你是第一次接触 AI 工具配置，也能顺利完成。

1、获取 API Key

在配置任何大语言模型之前，有三个核心概念是绕不开的：baseUrl、apiKey 和 model id。简单来说，这三个参数就是你调用模型服务的"通行证"——baseUrl 告诉程序去哪里找模型服务，apiKey 证明你有权限使用该服务，model id 则指定你要调用的具体模型版本。在之前的教程中已经对这三个概念做过详细介绍，本文不再重复，直接进入操作步骤。

步骤一：登录 DeepSeek 开放平台

DeepSeek 开放平台的登录地址为 https://platform.deepseek.com/sign_in，官方 API 使用文档地址为 https://api-docs.deepseek.com/zh-cn/。打开登录页面后，输入你的手机号，获取并填写验证码，即可完成登录。

如果你是第一次使用 DeepSeek 开放平台，建议先浏览一遍官方文档，了解各模型的能力边界和计费规则，这样在后续选择模型版本时会更有针对性。

步骤二：创建 API Key

登录成功后，点击左侧导航栏中的 “API Keys” 选项，进入密钥管理页面。点击页面上的 “创建 API Key” 按钮，为你的密钥填写一个便于识别的名称（例如"openclaw-dev"），然后确认创建。

重要提示： API Key 只会在创建时完整显示一次，请务必立即复制并妥善保存到安全的地方（如密码管理器）。一旦关闭弹窗，将无法再次查看完整密钥，只能重新创建。

创建成功后，密钥列表中会出现你刚刚创建的条目，如下图所示。

关键参数速查

完成上述步骤后，你已经拥有了调用 DeepSeek V4 所需的全部凭证。以下是接入时需要用到的关键参数，请记录备用：

OpenAI 协议 base URL： https://api.deepseek.com/v1
Anthropic（Claude）协议 base URL： https://api.deepseek.com/anthropic
DeepSeek V4 Flash 的 model id： deepseek-v4-flash（速度更快，适合高频调用场景）
DeepSeek V4 Pro 的 model id： deepseek-v4-pro（能力更强，适合复杂任务）

Flash 版本和 Pro 版本各有侧重：Flash 响应速度更快、成本更低，适合日常对话和简单代码补全；Pro 版本推理能力更强，适合处理复杂的架构设计、长文档分析等任务。你可以根据实际需求灵活切换。

2、OpenClaw 配置文件

配置文件在哪里？

OpenClaw 的所有核心设置都保存在本地的一个 JSON 文件中，而不是存储在云端。这种设计的好处是配置完全由你掌控，不依赖网络，也不会因为服务商变更而丢失。根据你的操作系统，配置文件的默认路径如下：

Windows 系统： C:\Users\你的用户名\.openclaw\openclaw.json
（例如：C:\Users\Administrator\.openclaw\openclaw.json）
Ubuntu / macOS 系统： ~/.openclaw/openclaw.json

找到文件后，使用任意文本编辑器打开即可进行编辑。推荐使用 VS Code，它对 JSON 格式有语法高亮和错误提示，能有效避免因格式错误导致配置失效。

如果你在对应路径下找不到 openclaw.json 文件，说明 OpenClaw 尚未完成初始化。此时只需打开命令行窗口，执行以下命令，OpenClaw 会自动生成默认配置文件：

openclaw setup

3、修改龙虾配置

步骤一：备份原文件

在动手修改任何配置文件之前，强烈建议先做一份备份。将 openclaw.json 复制一份，重命名为 openclaw.json.bak 或 openclaw_backup.json，保存在同一目录下。这样一旦修改出错导致 OpenClaw 无法启动，只需将备份文件还原即可，无需从头排查问题。

养成备份的习惯，能为你省去大量不必要的麻烦，尤其是在配置较为复杂的情况下。

步骤二：替换配置文件（适用于全新安装）

如果你是第一次配置 OpenClaw，本地尚无任何自定义配置，可以直接使用下面提供的完整模板作为起点。将以下内容复制并粘贴到 openclaw.json 中，然后根据步骤三的说明替换其中的关键参数即可。

如果你已有现成的配置文件，请跳过此步骤，直接进入步骤三。

{
  "models": {
    "mode": "merge",
    "providers": {
      "custom-001": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "sk-xxxxxx",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-v4-pro",
            "name": "deepseek-v4-pro (Custom Provider)",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "custom-001/deepseek-v4-pro"
      },
      "models": {
        "custom-001/deepseek-v4-pro": {}
      },
      "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace",
      "contextPruning": {
        "mode": "cache-ttl",
        "ttl": "1h"
      },
      "compaction": {
        "mode": "safeguard"
      },
      "heartbeat": {
        "every": "30m"
      }
    }
  },
  "tools": {
    "profile": "coding",
    "web": {
      "search": {
        "enabled": true,
        "provider": "gemini",
        "gemini": {
          "apiKey": "sk-xxxxxxxxxx"
        }
      }
    }
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "boot-md": {
          "enabled": true
        },
        "bootstrap-extra-files": {
          "enabled": true
        },
        "command-logger": {
          "enabled": true
        },
        "session-memory": {
          "enabled": true
        }
      }
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "controlUi": {
      "allowedOrigins": [
        "http://localhost:18789"
      ]
    },
    "auth": {
      "mode": "token",
      "token": ""
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "contacts.add",
        "calendar.add",
        "reminders.add",
        "sms.send"
      ]
    }
  },
  "skills": {
    "install": {
      "nodeManager": "npm"
    },
    "entries": {
      "goplaces": {
        "apiKey": "sk-xxxxxxxxxxxxxx"
      },
      "nano-banana-pro": {
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxx"
      },
      "notion": {
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxx"
      },
      "openai-image-gen": {
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxx"
      },
      "openai-whisper-api": {
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxx"
      },
      "sag": {
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

步骤三：替换核心参数

无论你是使用上面的模板，还是在已有配置文件的基础上修改，都需要将以下 4 个核心参数替换为你自己的实际值。这是整个配置过程中最关键的一步，请仔细核对每一项。

① 大模型地址（baseUrl）

将 "baseUrl" 的值替换为 DeepSeek 的 API 地址。由于 OpenClaw 默认使用兼容 OpenAI 协议的接口，因此这里填写：

"baseUrl": "https://api.deepseek.com/v1"

② 大模型密钥（apiKey）

将 "apiKey" 的值替换为你在第一部分创建的 API Key。注意不要在密钥前后添加多余的空格，否则会导致认证失败：

"apiKey": "sk-你的真实密钥"

关于密钥的安全性：虽然将密钥直接写入配置文件是最直观的方式，但如果你的配置文件有可能被他人访问（例如存放在共享目录或上传到代码仓库），建议改用系统环境变量的方式管理密钥。不过对于本地个人使用的场景，直接写入配置文件完全可以接受。

③ 模型名称（model id）

将配置中所有出现 deepseek-v4-pro 的地方，替换为你想使用的模型版本：

追求速度和低成本：替换为 deepseek-v4-flash
追求最强能力：保持 deepseek-v4-pro 不变

④ 工作空间路径（workspace）

将 "workspace" 的值替换为你本机的实际路径：

Windows："C:\\Users\\你的用户名\\.openclaw\\workspace"
Ubuntu / macOS："/home/你的用户名/.openclaw/workspace" 或 "~/.openclaw/workspace"

完成上述 4 项修改后，保存文件，配置即告完成。修改后的配置示例如下图所示：

4、OpenClaw 测试效果

配置完成后，重启 OpenClaw，然后在对话框中随意输入一个问题，验证模型是否能够正常响应。

正常运行效果

当 API 配置正确且账户有余额时，DeepSeek V4 会在龙虾中流畅响应，效果如下图所示。你可以尝试提出一些代码问题或复杂的推理题，感受 DeepSeek V4 的实际能力。

至此，DeepSeek V4 接入 OpenClaw 的全部配置步骤已经完成。整个过程的核心只有两件事：在 DeepSeek 平台获取 API Key，以及在 OpenClaw 配置文件中填入正确的三个参数。如果后续遇到问题，优先检查这三个参数是否填写正确，绝大多数连接失败的问题都源于此。
详细教程来源于“龙虾实验室”社区（longxialab.cn）。龙虾实验室包含大量入门教程和龙虾应用资源，以及AI最新资讯等，是个很不错的龙虾资源聚合平台。
我们也可以在字节的扣子平台调用DeepseekV4或者部署龙虾。