2026年Openclaw快速接入DeepSeek V4 Pro的完整教学指南实用指南

作者：袖梨 2026-08-26

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“2026年Openclaw快速接入DeepSeek V4 Pro的完整教……”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

0 前置准备

实际处理时，已安装 OpenClaw（版本 ≥ 1.8.0，低于该版本请先执行 brew upgrade openclaw 升级）；如果尚未安装，能够查看新手更快安装入门步骤。
已拿到博查 API Key；（拿到地址 open.bocha.cn）
熟悉基础的 JSON 语法。

1 新手更快安装入门

安装 OpenClaw

# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
# Windows（PowerShell）
iwr -useb https://openclaw.ai/install.ps1 | iex

运行设置引导

openclaw onboard --install-daemon

选择自定义模型供应商 Custom Provider：

设置信息如下所示：

# Model/auth provider
Custom Provider

# API Base URL
https://api.bocha.cn/v1

# How do you want to provide this API key?
Paste API key now

# API Key (leave blank if not required)
sk-******

# Endpoint compatibility
Anthropic-compatible

# Model ID
deepseek-v4-pro

# Verification successful.

# Endpoint ID
custom-api-bocha-cn

# Model alias (optional)
deepseek-v4-pro

2 更新模型设置

设置文件定位

从实现思路看，安装完 OpenClaw 后，其所有模型、渠道设置都集中在 openclaw.json 文件中，不同操作系统的默认路径如下所示：

操作系统	设置文件默认路径	更快打开方式
Windows	C:Users<你的用户名>.openclawopenclaw.json	按 Win+R，输入路径直接跳转
macOS	~/.openclaw/openclaw.json	终端执行 open ~/.openclaw/openclaw.json
Linux	~/.openclaw/openclaw.json	终端执行 vim ~/.openclaw/openclaw.json

提示：如果找不到文件，先执行 openclaw init 初始化设置（执行后会自动生成设置文件）。

找到对应的 openclaw.json 设置文件，变更设置如下所示：

{
  "agents": {
    "defaults": {
      "models": {
        "custom-api-bocha-cn/deepseek-v4-pro": {
          "alias": "deepseek-v4-pro"
        }
      },
      "model": {
        "primary": "custom-api-bocha-cn/deepseek-v4-pro"
      }
    }
  },
  "tools": {
    "profile": "coding"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "custom-api-bocha-cn": {
        "baseUrl": "https://api.bocha.cn/v1",
        "api": "anthropic-messages",
        "apiKey": "sk-******",
        "models": [
          {
            "id": "deepseek-v4-pro",
            "name": "deepseek-v4-pro (Custom Provider)",
            "api": "anthropic-messages",
            "baseUrl": "https://api.bocha.cn/v1",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 1000000,
            "maxTokens": 384000
          }
        ]
      }
    }
  }
}