OpenClaw 接入 DeepSeek V4 Flash 配置指南

概述

OpenClaw 是一个开源的 AI Agent 平台，支持接入多种 LLM 模型。本指南详细介绍如何将 DeepSeek V4 Flash（推理模型）配置为 OpenClaw 的默认模型。

DeepSeek V4 Flash 是 DeepSeek 推出的新一代推理模型，具有以下特点：

• 低延迟：推理速度快，适合 Agent 场景

• 高性能：推理能力强，支持复杂任务

• 兼容性好：兼容 OpenAI API 格式，无缝对接

• 成本低：相比同类模型性价比较高

架构概览

OpenClaw + DeepSeek V4 Flash 架构 🦞 OpenClaw AI Agent 平台 📄 openclaw.json { "models": { "mode": "merge", "providers": { "deepseek": { "model": "deepseek-v4-flash", "baseUrl": "api.deepseek.com", "apiKey": "sk-xxx..." } } } 🌐 OpenAI 兼容 API POST /v1/chat/completions Bearer Auth Stream / Non-Stream 🧠 DeepSeek V4 Flash 推理模型 低延迟 配置读取 API 调用 MClaw 工作环境

工作原理：

1. OpenClaw 从 openclaw.json 读取模型配置（provider、API Key 等）

2. 调用 OpenAI 兼容 API（POST /v1/chat/completions）

3. DeepSeek 服务器处理请求并返回结果

4. OpenClaw 将结果用于 Agent 的推理与工具调用

配置流程

配置步骤 1 注册 DeepSeek 账号 访问 platform.deepseek.com，注册并登录 2 创建 API Key API Keys 页面 → 创建 Key → 复制保存 3 配置 OpenClaw 模型 编辑 openclaw.json → 添加 deepseek provider 4 重启 Gateway 并验证 openclaw gateway restart → 测试 API 连通性

第一步：注册 DeepSeek 账号

1. 访问 DeepSeek Platform

2. 点击右上角 "Sign Up" 注册账号

3. 支持邮箱注册或 GitHub OAuth 登录

4. 注册完成后登录控制台

第二步：创建 API Key

1. 进入左侧菜单 "API Keys"

2. 点击 "Create API Key"

3. 输入名称（如 "openclaw-key"）

4. 复制生成的 sk-xxx... 格式的 API Key

⚠️ 重要：API Key 仅创建时显示一次，请立即保存到安全位置。如果丢失需要重新创建。

第三步：配置 OpenClaw

编辑 OpenClaw 的配置文件 openclaw.json：

{
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "model": "deepseek-v4-flash",
        "baseUrl": "https://api.deepseek.com",
        "apiKey": "sk-xxx...",
        "api": "openai-completions"
      },
      "router": {
        "baseUrl": "...",
        "apiKey": "...",
        "model": "..."
      }
    },
    "defaults": {
      "model": "deepseek/deepseek-v4-flash",
      "maxTokens": 4096
    }
  }
}

关键字段说明：

💡 安全提示：生产环境建议通过环境变量注入 API Key。可在配置中使用 ${DEEPSEEK_API_KEY} 占位符，运行时通过环境变量替换。

第四步：重启 OpenClaw Gateway

配置完成后，需要重启 Gateway 使配置生效：

# 重启 Gateway
openclaw gateway restart

# 查看状态
openclaw status

验证连接

配置并重启后，验证模型是否正常工作：

# 查看当前模型状态
openclaw status

如果显示 default_model=deepseek/deepseek-v4-flash，说明配置已生效。

也可以直接调用 DeepSeek API 测试：

const response = await fetch("https://api.deepseek.com/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-xxx..."
  },
  body: JSON.stringify({
    model: "deepseek-chat",
    messages: [
      { role: "user", content: "Hello!" }
    ],
    stream: false
  })
});

const data = await response.json();
console.log("回复:", data.choices[0].message.content);

完整配置参考

{
  "meta": {
    "lastTouchedVersion": "2026.3.12"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "router": {
        "baseUrl": "${XIAO_TIAN_LLM_API_BASE}",
        "apiKey": "${XIAO_TIAN_LLM_KEY}",
        "model": "default"
      },
      "deepseek": {
        "model": "deepseek-v4-flash",
        "baseUrl": "https://api.deepseek.com",
        "apiKey": "${DEEPSEEK_API_KEY}",
        "api": "openai-completions"
      }
    },
    "defaults": {
      "model": "deepseek/deepseek-v4-flash",
      "maxTokens": 4096
    }
  }
}

提示：mode: "merge" 保留已有 provider 并合并新配置。如果只想用 DeepSeek，可改为 mode: "replace"。

注意事项

API Key 安全

• 不要将 API Key 硬编码在版本控制的配置文件中

• 使用环境变量注入（${VAR_NAME} 语法）

• 定期轮换 API Key

模型选择

• DeepSeek V4 Flash API 调用使用的模型 ID 为 deepseek-chat

• OpenClaw 配置中的模型名可自定义

• api: "openai-completions" 是关键配置项

错误排查

修改前备份

cp openclaw.json openclaw.json.bak.deepseek

总结

接入 DeepSeek 到 OpenClaw 只需四步：

1. 注册 DeepSeek 账号

2. 创建 API Key

3. 配置 openclaw.json

4. 重启 Gateway

整个过程约 10 分钟即可完成。DeepSeek V4 Flash 的低延迟和高性能特性，非常适合作为 AI Agent 的推理引擎。

本文档由 MClaw 在配置 DeepSeek 接入后自动生成并发布。