乐于分享
好东西不私藏

OpenClaw 接入国产模型实战:DeepSeek、通义、豆包接口到底怎么选?

OpenClaw 接入国产模型实战:DeepSeek、通义、豆包接口到底怎么选?

模型 API 选择、配置模板、测试命令、成本和稳定性判断

上一篇我们把 OpenClaw 小龙虾装起来了,也把微信接进去了。

但真正开始用的时候,新手马上会遇到第二个问题:我到底该接哪个模型?DeepSeek?通义?豆包?硅基流动?火山方舟?

这个问题比安装更关键。因为模型选错了,小龙虾不是不回复,就是回复慢、贵、不稳定,甚至配置半天跑不通。

新手不要一上来追最强模型,先追求三件事:接口兼容、响应稳定、成本可控。OpenClaw 只是一条通道,真正决定体验的是模型 API 的速度、价格、上下文、稳定性和你给它的任务类型。

一、先搞懂:OpenClaw 需要什么样的模型接口?

OpenClaw 最适合接的是 OpenAI-compatible 接口,也就是接口路径、messages 格式、API Key 鉴权方式尽量兼容 OpenAI 的服务。

你可以简单理解为:只要某个平台提供类似 /v1/chat/completions 的接口,并支持 model、messages、Authorization Bearer Key,一般就比较容易接。

但不同平台的 baseUrl、模型 ID、鉴权方式可能不同,发布前必须看官方控制台或文档,不要直接照搬别人配置。

二、普通人怎么选模型?

使用场景

优先考虑

原因

微信日常问答

便宜、快、稳定的模型

微信聊天不需要每次都上最强模型

公众号写作/改稿

中文表达好、上下文较长

需要理解文章结构和语气

代码/部署排错

推理强、代码能力强

需要看日志和命令错误

长资料总结

长上下文/文件处理能力强

避免资料截断

长期自动化助手

稳定性、价格、限流策略

长期在线最怕不稳定和突然涨成本

三、几类常见国产模型接入路线

1)DeepSeek 路线

适合:中文问答、代码、推理、公众号改稿、技术排错。

优点:性价比和推理口碑较强,适合做“小龙虾”的主力模型之一。

注意:具体 baseUrl、模型名、价格和限流以官方控制台为准。

2)通义路线

适合:阿里云生态、企业办公、电商、中文任务、后续和钉钉/阿里系工具联动的场景。

优点:生态完整,适合需要稳定云服务和企业能力的人。

注意:不同模型 ID 和兼容接口写法要看阿里云百炼或通义官方控制台。

3)豆包 / 火山方舟路线

适合:中文日常对话、生活化表达、内容创作、低门槛体验。

优点:中文口语化和多模态生态值得关注。

注意:API 接入通常走火山方舟等平台,baseUrl、模型 ID 与网页端豆包不是一回事。

4)硅基流动等聚合路线

适合:新手测试多个模型、快速比较速度和效果。

优点:一个平台可能接多种模型,方便试错。

注意:聚合平台稳定性、价格、限流和模型版本要自己测试。

四、通用配置模板

不管你接哪个国产模型,配置思路都一样:provider 写 API 地址和 Key,models 写模型 ID,agents.defaults.model.primary 指向这个模型。

{“models”: {“mode”: “merge”,“providers”: {“domestic”: {“baseUrl”: “https://你的模型服务地址/v1”,“apiKey”: “你的API_KEY”,“api”: “openai-completions”,“models”: [{“id”: “你的模型ID”,“name”: “你的模型显示名”,“reasoning”: false,“input”: [“text”],“contextWindow”: 32768,“maxTokens”: 4096}]}}},“agents”: {“defaults”: {“model”: {“primary”: “domestic/你的模型ID”},“models”: {“domestic/你的模型ID”: {“alias”: “国产模型助手”}}}},“gateway”: {“mode”: “local”}}

五、DeepSeek 示例配置

下面是示例写法。具体 baseUrl、模型 ID 以你自己的控制台为准。

{“models”: {“mode”: “merge”,“providers”: {“deepseek”: {“baseUrl”: “https://api.deepseek.com/v1”,“apiKey”: “你的DEEPSEEK_API_KEY”,“api”: “openai-completions”,“models”: [{“id”: “deepseek-chat”,“name”: “DeepSeek Chat”,“reasoning”: false,“input”: [“text”],“contextWindow”: 32768,“maxTokens”: 4096}]}}},“agents”: {“defaults”: {“model”: {“primary”: “deepseek/deepseek-chat”},“models”: {“deepseek/deepseek-chat”: {“alias”: “DeepSeek助手”}}}},“gateway”: {“mode”: “local”}}

六、通义 / 阿里云百炼示例配置

下面是兼容接口思路示例,实际 baseUrl 和模型名请以阿里云百炼控制台为准。

{“models”: {“mode”: “merge”,“providers”: {“qwen”: {“baseUrl”: “https://你的通义兼容API地址/v1”,“apiKey”: “你的DASHSCOPE或百炼API_KEY”,“api”: “openai-completions”,“models”: [{“id”: “qwen-plus”,“name”: “Qwen Plus”,“reasoning”: false,“input”: [“text”],“contextWindow”: 32768,“maxTokens”: 4096}]}}},“agents”: {“defaults”: {“model”: {“primary”: “qwen/qwen-plus”},“models”: {“qwen/qwen-plus”: {“alias”: “通义助手”}}}},“gateway”: {“mode”: “local”}}

七、火山方舟 / 豆包相关模型示例配置

如果你通过火山方舟接豆包相关模型,要注意:网页端豆包和 API 模型不是一回事。API 要看火山方舟控制台里的 endpoint、模型 ID 和调用说明。

{“models”: {“mode”: “merge”,“providers”: {“volcengine”: {“baseUrl”: “https://你的火山方舟兼容API地址/v1”,“apiKey”: “你的火山方舟API_KEY”,“api”: “openai-completions”,“models”: [{“id”: “你的方舟模型ID”,“name”: “豆包相关模型”,“reasoning”: false,“input”: [“text”],“contextWindow”: 32768,“maxTokens”: 4096}]}}},“agents”: {“defaults”: {“model”: {“primary”: “volcengine/你的方舟模型ID”},“models”: {“volcengine/你的方舟模型ID”: {“alias”: “豆包助手”}}}},“gateway”: {“mode”: “local”}}

八、接入前先用 curl 测试

不要一上来就塞进 OpenClaw。先用 curl 测 API,能通再配置。

curl -X POST “https://你的API地址/v1/chat/completions” \-H “Content-Type: application/json” \-H “Authorization: Bearer 你的API_KEY” \-d ‘{“model”: “你的模型ID”,“messages”: [{“role”: “user”,“content”: “请用一句话回复:测试成功”}]}’

如果 curl 测试失败,常见原因如下:

现象

可能原因

怎么处理

401 / Unauthorized

API Key 错误或格式错误

重新复制 Key,确认 Bearer 写法

404 / Not Found

baseUrl 或路径错

检查是否需要 /v1/chat/completions

model not found

模型 ID 写错

去控制台复制准确模型名

timeout

网络或服务慢

换网络、换平台、换模型测试

rate limit

触发限流

降低频率或升级套餐

九、OpenClaw 内部测试

配置保存后,先诊断:

openclaw doctoropenclaw status

再尝试给 agent 发测试消息:

openclaw agent –message “你好,请用一句话介绍你自己”

如果这里不通,先别折腾微信,先把模型链路修好。

十、多个模型怎么切换?

进阶一点的玩法,是把多个 provider 都写进配置,然后通过 primary 切换主模型。

“agents”: {“defaults”: {“model”: {“primary”: “deepseek/deepseek-chat”}}}

想切换成通义,就改成:

“primary”: “qwen/qwen-plus”

新手先不要一次配置太多模型。先跑通一个,再加第二个。

十一、给小龙虾写一个默认人设

如果你希望微信里的小龙虾更像个人助理,可以给它加一个简单系统提示词。不同版本的配置字段可能变化,具体以官方文档为准;保守做法是先在对话里固定告诉它身份。

你是我的微信 AI 助手。回复要简短、准确、像真人。遇到不确定的问题要明确说不确定。涉及金钱、健康、法律、账号安全的问题,不要擅自做决定,只给建议和提醒。

建议不要让它自动执行危险动作。微信助手的第一目标是可靠,不是炫技。

十二、模型选择判断表

你最在意什么

推荐优先级

解释

便宜

国产高性价比模型 / 聚合平台

适合高频聊天和测试

中文写作

DeepSeek / 豆包相关 / 通义

看你更喜欢逻辑、口语还是商业表达

代码排错

DeepSeek 等推理/代码强模型

日志、命令和配置错误更需要推理

企业稳定

通义 / 云厂商正式 API

更看重服务稳定、账单和权限

多模型试错

聚合平台

方便对比不同模型效果

十三、成本怎么控制?

• 不要让微信助手无限长上下文。

• 普通聊天优先用便宜模型。

• 写长文、排错、复杂任务再切强模型。

• maxTokens 不要一上来给太大。

• 不要把机器人拉进大群乱回复。

• 监控 API 控制台用量,防止异常调用。

新手推荐初始配置:

“contextWindow”: 8192,“maxTokens”: 2048

跑稳后再逐步增大。

十四、最常见的配置错误

错误

表现

解决

模型 ID 不一致

OpenClaw 找不到模型

id、primary、models 键名统一

baseUrl 多写路径

404 或请求失败

确认平台到底要写到 /v1 还是根地址

Key 复制不完整

401

重新生成或复制完整 Key

选择了非兼容接口

请求格式不识别

换 OpenAI-compatible endpoint

输出 token 太大

慢或失败

降低 maxTokens

微信群滥用

成本暴涨/封控风险

先私聊测试

十五、我的建议配置路线

如果你只是想先跑通:

• 先接一个便宜稳定的国产模型。

• contextWindow 先设 8192。

• maxTokens 先设 2048。

• 微信只接测试号,只做私聊。

• 确认稳定后,再考虑长上下文、更多工具和自动化。

OpenClaw 接模型,最难的不是 JSON,而是选对模型和控制成本。

新手别追求一步到位。先用一个稳定模型跑通,再逐步加能力。你的目标不是把配置写得多豪华,而是让小龙虾能稳定回复、成本可控、出了问题能排查。