❌

阅读视图

发现新文章，点击刷新页面。

Openclaw 快速接入 DeepSeek V4 Pro 指南

✇掘金 前端
VagueVibes

DeepSeek v4 重磅发布，博查 Model API 在首发当日便已支持v4 全系的调用，那么如何在 OpenClaw 平台中通过修改配置文件接入博查 Model API 以使用 DeepSeek V4 系列模型？

主要步骤包括定位 openclaw.json 文件、添加自定义 Provider 配置、设置默认调用模型以及重启网关验证。配置过程中需注意 contextWindow 参数调整及 api 协议凭证的正确填写，同时确保 API Key 安全。

0 前置准备

  1. 已安装 OpenClaw（版本 ≥ 1.8.0，低于该版本请先执行 brew upgrade openclaw 升级）；如果尚未安装，可以查看新手快速安装入门步骤。
  2. 已获取博查 API Key；（获取地址 open.bocha.cn）
  3. 熟悉基础的 JSON 语法。

1 新手快速安装入门

  1. 安装 OpenClaw
# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows（PowerShell）
iwr -useb https://openclaw.ai/install.ps1 | iex

001.PNG

  1. 运行配置引导
openclaw onboard --install-daemon

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

002.png

配置信息如下：

# 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

003.png

2 更新模型配置

配置文件定位

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

操作系统 配置文件默认路径 快速打开方式
Windows C:\Users<你的用户名>.openclaw\openclaw.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
          }
        ]
      }
    }
  }
}

重要参数：

contextWindow 1000000 上下文窗口：1M tokens（V4 全系）

maxTokens 384000 最大输出：384K tokens（官方上限）

保存并验证

完成以上修改后，保存文件。建议先重启 OpenClaw 网关让配置生效。

  1. 重启 OpenClaw 网关：
openclaw gateway restart
  1. 验证模型挂载状态：
openclaw models status

在 Web UI 聊天中，输入一条消息测试模型：

004.png

或者在命令行输入 openclaw chat，再与 agent 对话：

005.png

006.png

❌