第二篇:模型配置篇《OpenClaw 模型接入大全:DeepSeek、通义千问、豆包怎么配?》

📌 前言

在第一篇中，我们已经成功在 Windows 10/11 上部署了 OpenClaw “大龙虾”。但你可能会发现，部署完成后输入 openclaw chat，它却报错说无法连接模型。

这是完全正常的——OpenClaw 本身并不提供大模型能力，它更像是一个“AI 智能体运行平台”。当用户发出指令时，流程是这样的：

用户提问 → OpenClaw → API 接口 → 大模型（DeepSeek/通义千问/豆包）→ 返回结果

因此，想让 OpenClaw 真正“活”起来，必须先配置一个大模型的 API。

本文将手把手教你接入目前最主流的三款国内大模型：DeepSeek、通义千问（Qwen） 和 豆包（Doubao）。

🧠 一、核心原理：OpenClaw 的模型接入逻辑

在开始配置之前，先理解一个核心概念：OpenClaw 兼容 OpenAI API 协议。

这意味着，只要某个大模型平台提供了 兼容 OpenAI 格式的 API 接口，无论它是 DeepSeek、通义千问还是豆包，都可以通过几乎相同的方式接入 OpenClaw。

接入一个模型，本质上只需要三个信息：

无论通过 Web 界面还是配置文件，本质都是把这三个参数正确地交给 OpenClaw。

🔑 二、通用准备：获取 API Key

无论接入哪个模型，第一步都是去对应平台注册并获取 API Key。以下是三个平台的快速指引：

⚠️ 重要提醒：API Key 通常只显示一次（如 DeepSeek 的 Key 以 sk- 开头），请立即备份保存，关闭页面后就无法再次查看。

🚀 三、方法一：接入 DeepSeek

DeepSeek 是目前国内开发者使用最多的模型之一，在代码生成和推理任务上表现优秀。OpenClaw 官方对 DeepSeek 提供了原生支持。

3.1 获取 API Key

1. 访问 DeepSeek 开放平台

2. 登录账号，进入 API Keys 页面

3. 点击 “创建 API Key”，输入名称（如 openclaw）

4. 复制生成的 Key（以 sk- 开头）并保存

3.2 通过 onboard 向导配置（推荐）

这是官方推荐的最简单方式：

openclaw onboard --auth-choice deepseek-api-key

系统会提示你输入 API Key，并自动将 deepseek/deepseek-v4-flash 设置为默认模型。

3.3 通过配置文件手动配置

如果想手动配置，编辑 ~/.openclaw/openclaw.json：

{  "model": {    "provider": "openai",    "apiKey": "sk-你的DeepSeek密钥",    "baseUrl": "https://api.deepseek.com",    "model": "deepseek/deepseek-v4-flash"  }}

注意：DeepSeek 的 Base URL 是 https://api.deepseek.com（不是 api.deepseek.com/v1）。

3.4 可用模型列表

OpenClaw 内置了以下 DeepSeek 模型：

查看所有可用模型：

openclaw models list --provider deepseek

3.5 非交互式安装（脚本化）

如果需要自动化部署：

openclaw onboard --non-interactive \  --mode local \  --auth-choice deepseek-api-key \  --deepseek-api-key "$DEEPSEEK_API_KEY" \  --skip-health \  --accept-risk

🏔️ 四、方法二：接入通义千问（阿里云百炼）

阿里云百炼是国内稳定可靠的大模型服务平台，其 API 支持 OpenAI 兼容接口，可无缝接入 OpenClaw。OpenClaw 可调用通义千问系列模型，如 qwen-plus、qwen3-max 等。

4.1 开通服务并获取 API Key

1. 开通百炼服务：登录阿里云账号，开通百炼大模型服务

2. 创建 API Key：进入百炼控制台 → API-KEY 管理 → 点击 “创建 API Key”

3. 复制保存：系统生成以 sk- 开头的密钥

💡 新用户福利：百炼为新用户提供北京地域专属的免费额度，用于体验模型调用。

4.2 配置文件接入

编辑 ~/.openclaw/openclaw.json：

{  "agents": {    "defaults": {      "model": {        "primary": "bailian/qwen-plus"      }    }  },  "models": {    "mode": "merge",    "providers": {      "bailian": {        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",        "apiKey": "sk-你的百炼API密钥",        "api": "openai-completions",        "models": [          {            "id": "qwen-plus",            "name": "通义千问 Plus",            "contextWindow": 1024000,            "maxTokens": 32000          }        ]      }    }  }}

4.3 推荐模型

🫘 五、方法三：接入豆包（火山引擎）

豆包是字节跳动推出的大模型服务，通过火山引擎平台提供。OpenClaw 通过 volcengine 提供商接入。

5.1 获取 API Key

1. 登录 火山引擎控制台

2. 进入 “开通管理”，开通你需要使用的豆包模型

3. 进入 “API 密钥管理”，创建新的 API Key

5.2 通过 onboard 向导配置

openclaw onboard --auth-choice volcengine-api-key

这会提示你输入 API Key，并自动完成通用模型和编码模型两个提供商的注册。

5.3 配置文件接入

编辑 ~/.openclaw/openclaw.json：

{  "agents": {    "defaults": {      "model": {        "primary": "volcengine-plan/ark-code-latest"      }    }  },  "models": {    "providers": {      "volcengine": {        "baseUrl": "ark.cn-beijing.volces.com/api/v3",        "apiKey": "你的火山引擎API密钥"      },      "volcengine-plan": {        "baseUrl": "ark.cn-beijing.volces.com/api/coding/v3",        "apiKey": "你的火山引擎API密钥"      }    }  }}

5.4 可用模型

💡 注意：火山引擎的通用模型和编码模型使用同一个 API Key，只需配置一次。

🎯 六、三种模型对比与选择建议

选择建议：

• 如果你以编程和代码生成为主 → 优先选择 DeepSeek

• 如果你需要稳定可靠的企业级服务 → 选择 通义千问（百炼）

• 如果你想同时兼顾编码和通用任务 → 选择 豆包（火山引擎）

🐞 七、常见问题排查

7.1 API Key 填写错误

这是最常见的问题。建议：

• 删除首尾可能存在的空格

• 重新复制 Key（注意不要复制到多余字符）

• 如果仍失败，重新生成一个新的 Key

7.2 Base URL 错误

很多用户直接复制了官网首页地址，实际上应该填写 API Endpoint。例如：

• ❌ 错误：https://www.deepseek.com

• ✅ 正确：https://api.deepseek.com

7.3 模型名称错误

不同平台的模型名称格式不同。例如 DeepSeek：

• ❌ 错误：DeepSeek-R1

• ✅ 正确：deepseek-reasoner

建议使用 openclaw models list --provider <提供商> 查看正确的模型名称。

7.4 API 余额不足

部分平台采用按量计费。余额耗尽时，请求会失败并返回 401 或 429 错误。请及时充值或检查免费额度是否已用完。

7.5 网络环境问题

如果部署在服务器上，建议检查：

• 防火墙是否放行

• 代理配置是否正确

• DNS 解析是否正常

📝 八、总结

无论接入 DeepSeek、通义千问还是豆包，核心逻辑都是一样的：

获取 API Key → 填写 Base URL → 选择模型名称 → 保存并启用

为了方便你快速查阅，这里汇总了三个平台的全部关键信息：

配置完成后，可以用 openclaw chat 测试一下，如果能正常收到回复，说明模型已经成功接入了！🎉

下一篇预告：《给“大龙虾”装上十八般武艺：OpenClaw Skills 安装与实战》—— 我们将学习如何为 OpenClaw 安装各种技能插件，让它真正成为你的全能助手。

作者：DoubleMpd

嵌入式软件工程师 / 技术方案设计师，正在用 AI 改造自己的开发工作流。 专注输出“能跑通、能复用、能落地”的技术内容。