QClaw内置模型与自定义API Key配置详解【详解】

先明确一点：QClaw这套模型配置机制，本质上是在“开箱即用”和“自定义接入”之间留了一条灵活通道。你想直接用Kimi、DeepSeek或GLM这些国产模型，没问题，内置模式就能搞定；但如果你手里有通义千问的Token、腾讯云Plan套餐，或者想走SiliconFlow调用DeepSeek-V3.2，那就得把自定义API的配置规则吃透。两套机制互不干扰，但任何一个字段填错——比如BaseURL末尾多一个斜杠、模型ID大小写不对、API Key少了字符——都会导致模型灰显、请求超时，或者直接返回401。

启用内置模型：三步搞定，开机即用

QClaw安装后默认已经预置了Kimi-2.5、Minimax-M2.5、GLM-5、DeepSeek-V3.2这些国产模型，不需要额外下载密钥，适合快速验证基础能力，或者离线调试场景。

第一步：打开QClaw客户端，点击对话框下方的模型图标（那个齿轮状按钮），然后选择「内置模型」。

第二步：在弹出的列表里点你想要的模型，比如「DeepSeek-V3.2」，状态栏会立刻显示“已切换至 DeepSeek-V3.2”。

第三步：发条测试消息，比如“写一段Python代码计算斐波那契数列前10项”，看看响应是不是即时生成，没有报错。

配置通义千问API：BaseURL与模型ID必须严丝合缝

通义千问接入失败最常见的原因，其实就是两个地方：BaseURL末尾多了一个斜杠，或者模型ID大小写混用了。DashScope最新的Endpoint不接受http协议、不兼容Bearer前缀，而且对路径版本号非常敏感。

访问https://bailian.console.aliyun.com/，登录实名账号，左侧找到「API-KEY 管理」，点击「创建 API-KEY」，复制以sk-开头的完整字符串——注意要包含所有字符，不能丢空格。

在QClaw设置页→「模型配置」→「自定义大模型」，「BaseURL」输入：https://dashscope.aliyuncs.com/api/v1（结尾严禁加斜杠），「模型名称」填：qwen-max（区分大小写，不加引号，不带空格），「认证方式」选「API Key」，粘贴刚才复制的sk-xxx字符串，最后取消勾选「使用Bearer前缀」。

操作本身很简单，直接粘贴密钥就行。但有一个细节容易翻车：千万不能手误删掉sk-前缀或者末尾的换行符——哪怕只少一个字符，QClaw就会回到401 Unauthorized。

接入腾讯云Token Plan：接口地址与Model ID必须一一对应

腾讯云Token Plan套餐分通用型和Hy型，每种套餐支持的Model ID不一样，而且必须跟你购买时确认的ID完全一致，否则会触发400 Bad Request。

① 启动QClaw，点击底部模型图标，选择「自定义大模型」，再点击「自定义配置」。

② 在「模型API」标签页填写：
接口地址：https://api.lkeap.cloud.tencent.com/plan/v3（直接复制，不可修改）
API协议类型：选「OpenAI 兼容协议」
API Key：粘贴腾讯云控制台获取的密钥（确保未过期且有chat/completions权限）
模型名称：根据你购买的套餐类型填写对应的ID——Hy Token Plan用户必须填hy3-preview，通用套餐用户则填kimi-2.5或glm-5。

直连SiliconFlow调用DeepSeek-V3.2：命令行强制注入Provider

如果QClaw图形界面配置无效、模型列表不刷新，或者切换后还是调用内置模型，说明GUI层没有成功加载SiliconFlow Provider。这时候需要绕过界面，用命令行强制写入配置。

在宿主机打开终端（Windows需要WSL2，macOS/Linux直接Terminal），运行以下命令：
openclawconfig 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" } ] }'

执行openclaw config get models.providers.siliconflow，输出内容中必须包含"id": "Pro/deepseek-ai/DeepSeek-V3.2"字段。如果没有，重试第一步，并检查API Key是否复制完整。

配置完成后重启QClaw，进入模型选择页，「DeepSeek-V3.2」会出现在自定义模型列表顶部，点击即可激活。