QClaw切换DeepSeek模型教程

本文详细讲解了在QClaw（OpenClaw）中成功切换至DeepSeek系列大模型的完整实操流程，涵盖从配置SiliconFlow或DeepSeek官方API提供方、设置默认主模型、添加快捷别名、重启网关到最终验证生效的五大关键步骤，特别针对“切换失败”这一高频问题，精准定位常见原因（如API密钥缺失、模型ID错误、网关未重启等），并提供逐条可复制的命令与验证方法，助你快速、稳定地将QClaw接入高性能DeepSeek-V3.2或DeepSeek Chat模型，释放本地AI代理的真正潜力。

如果您已安装QClaw（OpenClaw）并希望将当前使用的模型切换为DeepSeek系列，但默认配置未生效或命令执行后模型未正确加载，则可能是由于模型提供方未配置、API密钥缺失、模型ID错误或网关未重启所致。以下是解决此问题的步骤：

一、通过命令行配置硅基流动（SiliconFlow）为DeepSeek服务提供商

该方法直接在宿主机终端中设置SiliconFlow作为模型后端，使QClaw能调用其托管的DeepSeek-V3或DeepSeek-R1等模型。需确保已获取硅基流动平台的有效API密钥。

1、访问硅基流动官网（https://www.siliconflow.cn/）完成注册并登录，进入「API密钥」管理页，复制生成的密钥。

2、在宿主机终端中执行以下命令，将“你的API Key”替换为实际密钥，并确认模型ID与硅基流动模型广场中一致（如Pro/deepseek-ai/DeepSeek-V3.2）：

openclaw config set models.providers.siliconflow '{ "baseUrl": "https://api.siliconflow.cn/v1", "apiKey": "你的API Key", "api": "openai-completions", "models": [ { "id": "Pro/deepseek-ai/DeepSeek-V3.2", "name": "DeepSeek-V3.2" } ] }'

3、执行后无报错即表示配置写入成功，可通过 openclaw config get models.providers.siliconflow 验证输出是否含对应模型ID。

二、设置DeepSeek为默认主模型

该步骤指定QClaw在常规对话中优先调用DeepSeek模型，避免回退至其他已配置模型（如GLM-5或Kimi）。

1、执行命令设置primary模型为硅基流动提供的DeepSeek-V3.2：

openclaw config set agents.defaults.model.primary "siliconflow/Pro/deepseek-ai/DeepSeek-V3.2"

2、验证设置是否生效：

openclaw config get agents.defaults.model.primary

3、输出应精确显示 "siliconflow/Pro/deepseek-ai/DeepSeek-V3.2"，不含多余空格或引号。

三、添加模型别名并启用运行时切换

该方法支持在不修改全局配置的前提下，于单次对话中快速切换模型，适用于对比测试或临时调用不同DeepSeek版本。

1、为DeepSeek-V3.2模型添加可识别的简短别名：

openclaw models aliases add deepseek "siliconflow/Pro/deepseek-ai/DeepSeek-V3.2"

2、重启QClaw网关以加载新别名和模型配置：

openclaw gateway restart

3、在任意聊天窗口中输入指令切换模型：

/model deepseek

四、使用自定义API端点直连DeepSeek官方服务

该方法绕过硅基流动中间层，直接对接DeepSeek官方API（需确认其是否开放公开接口）。适用于已有DeepSeek专属API密钥且追求最低延迟的用户。

1、确认DeepSeek官方API文档地址及可用模型列表（如 https://api.deepseek.com/v1/models）。

2、执行以下命令配置DeepSeek官方提供方（注意替换密钥与base URL）：

openclaw config set models.providers.deepseek '{ "baseUrl": "https://api.deepseek.com/v1", "apiKey": "sk-xxx-your-deepseek-api-key", "api": "openai-completions", "models": [ { "id": "deepseek-chat", "name": "DeepSeek Chat" } ] }'

3、将主模型设为该提供方下的模型ID：

openclaw config set agents.defaults.model.primary "deepseek/deepseek-chat"

4、再次执行 openclaw gateway restart 使配置生效。

五、验证模型切换结果

该步骤用于确认QClaw当前实际调用的模型身份，排除缓存或配置残留干扰。

1、进入容器内部执行模型列表查询：

docker exec openclaw openclaw models list

2、检查输出中是否存在状态为“configured”的 siliconflow/Pro/deepseek-ai/DeepSeek-V3.2 或 deepseek/deepseek-chat 条目。

3、在Web UI或CLI中发起一次新对话，发送指令 /info 或 /model，观察响应头部是否明确返回模型标识为 DeepSeek-V3.2 或 deepseek-chat。

文中关于QClaw的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《QClaw切换DeepSeek模型教程》文章吧，也可关注golang学习网公众号了解相关技术文章。