☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装qclaw但无法成功调用deepseek模型,则可能是由于模型提供方未配置、api密钥无效、本地ollama服务未就绪或配置路径错误所致。以下是解决此问题的步骤:
一、配置DeepSeek官方API为服务提供商
该方法通过直连DeepSeek开放平台,利用其云端大模型服务能力,无需本地GPU资源,适合网络稳定且需高性能推理的场景。需确保已获取DeepSeek官网颁发的有效API密钥。
1、访问DeepSeek开放平台(https://platform.deepseek.com),完成实名注册并登录。
2、进入「API密钥」管理页,点击「创建密钥」,复制生成的sk-开头密钥。
3、在终端中执行以下命令,将your_api_key_here替换为实际密钥:
openclaw config set models.providers.deepseek '{ "baseUrl": "https://api.deepseek.com/v1", "apiKey": "your_api_key_here", "api": "openai-completions", "models": [ { "id": "deepseek-chat", "name": "DeepSeek Chat (V3)" }, { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner (R1)" } ] }'
4、验证配置是否写入成功:执行openclaw config get models.providers.deepseek,输出应包含deepseek-chat模型ID。
二、配置硅基流动(SiliconFlow)为DeepSeek代理服务商
该方法借助硅基流动平台托管的DeepSeek-V3.2等增强版本,支持更高并发与更长上下文,适用于对响应质量与稳定性有更高要求的生产环境。需单独注册硅基流动账号并获取其API密钥。
1、访问硅基流动官网(https://www.siliconflow.cn/),注册并登录,进入「API密钥」页面创建密钥。
2、在终端中执行以下命令,将your_siliconflow_key替换为实际密钥,模型ID需与硅基流动模型广场一致:
openclaw config set models.providers.siliconflow '{ "baseUrl": "https://api.siliconflow.cn/v1", "apiKey": "your_siliconflow_key", "api": "openai-completions", "models": [ { "id": "Pro/deepseek-ai/DeepSeek-V3.2", "name": "DeepSeek-V3.2" } ] }'
3、确认配置生效:运行openclaw config get models.providers.siliconflow,检查输出中是否存在DeepSeek-V3.2条目。
三、接入本地Ollama部署的DeepSeek模型
该方法完全离线运行,数据不出本地,不消耗API积分,适用于隐私敏感、网络受限或希望长期零成本运行的用户。需提前安装Ollama并成功拉取DeepSeek-R1系列模型。
1、确认Ollama服务正在运行:任务栏出现羊驼图标,或在PowerShell中执行ollama list,可见deepseek-r1:7b等模型已加载。
2、获取本机局域网IP:在PowerShell中执行ipconfig,记下IPv4地址(如192.168.1.100);避免使用localhost,QClaw对其兼容性较差。
3、编辑QClaw配置文件C:Users\.qclawopenclaw.json,在models.providers节点下新增如下段落(替换IP为实际地址):
"ollama-local": { "baseUrl": "http://192.168.1.100:11434/v1", "apiKey": "ollama", "api": "openai-completions", "models": [ { "id": "deepseek-r1:7b", "name": "DeepSeek-R1 7B" } ] }
4、保存文件后,**必须彻底退出QClaw主程序及系统托盘进程**,再重新启动,否则配置不生效。
四、设置默认主模型并启用别名
无论采用上述哪种接入方式,均需显式指定QClaw默认调用的模型,否则仍将回退至内置fallback模型。同时添加别名可确保模型在Web UI和微信指令中正常显示与切换。
1、将DeepSeek模型设为全局默认主模型:执行openclaw config set agents.defaults.model.primary "deepseek/deepseek-chat"(官方API)或"siliconflow/Pro/deepseek-ai/DeepSeek-V3.2"(硅基流动)或"ollama-local/deepseek-r1:7b"(本地Ollama)。
2、为模型添加可识别别名:执行openclaw config set models.aliases.deepseek "DeepSeek Chat",该名称将在QClaw界面模型选择框中显示。
3、重启QClaw网关服务:执行openclaw restart,确保新配置载入运行时环境。
五、验证模型调用是否生效
配置完成后,需通过多层级验证确认模型真正可用,避免仅配置成功但调用链路中断。验证过程覆盖服务状态、接口连通性与实际响应能力。
1、检查网关服务状态:运行openclaw status,确认Gateway显示running且无报错日志。
2、测试API端点连通性:在浏览器中访问http://localhost:18789/info,查看返回JSON中active_model字段是否为已配置的DeepSeek模型ID。
3、发起真实请求验证:在微信中向“龙虾”好友发送指令/info,观察返回信息中是否包含DeepSeek模型标识;或发送/ask 你好,请用DeepSeek风格回答,确认响应内容符合预期特征。











