qclaw支持内置模型开箱即用与自定义api精准配置双模式：内置kimi-2.5、deepseek-v3.2等无需密钥；自定义需严格匹配baseurl、模型id及api key，填错字段将导致灰显、超时或401错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让QClaw直接用上Kimi、DeepSeek或GLM这些国产模型，又想随时切到自己买的通义千问、腾讯云Token Plan甚至SiliconFlow上的DeepSeek-V3.2，就得同时掌握内置模型的开箱即用逻辑和自定义API的精准配置规则——这两套机制互不干扰，但填错一个字段就会导致模型灰显、请求超时或返回401错误。
启用内置模型：三步开机即用
QClaw安装后默认已预置Kimi-2.5、Minimax-M2.5、GLM-5、DeepSeek-V3.2等国产模型，无需联网下载或填写密钥，适合快速验证基础能力或离线调试。
第一步：打开QClaw客户端，点击对话框下方的模型图标（齿轮状）→选择「内置模型」。
第二步：在弹出列表中点击任一模型名称（如「DeepSeek-V3.2」），状态栏立即显示「已切换至 DeepSeek-V3.2」。
第三步：发送测试消息，例如“写一段Python代码计算斐波那契数列前10项”，观察响应是否即时生成且无报错提示。
【注意】内置模型数据全程不出本地设备，不经过任何云端API网关，因此无法调用Skills插件（如腾讯新闻、较真查证）；若需技能联动，请务必切换至自定义API模型。
配置通义千问API：BaseURL与模型ID必须严丝合缝
通义千问接入失败最常见的原因是BaseURL末尾多了一个斜杠，或模型ID大小写混用。DashScope官方Endpoint不接受http协议、不兼容Bearer前缀、且对路径版本号极其敏感。
方法一：从阿里云百炼控制台获取密钥
访问https://bailian.console.aliyun.com/ →登录实名账号 →左侧「API-KEY 管理」→「创建 API-KEY」→复制以sk-开头的完整字符串（含所有字符，不含空格）。
方法二：填写BaseURL与模型ID
在QClaw设置页→「模型配置」→「自定义大模型」→「BaseURL」输入：https://dashscope.aliyuncs.com/api/v1（结尾严禁加斜杠）→「模型名称」填：qwen-max（区分大小写，不加引号，不带空格）→「认证方式」选「API Key」→粘贴刚复制的sk-xxx字符串→取消勾选「使用Bearer前缀」。
OpenClaw 自我进化框架一键部署。安装宪法(AGENTS.md)、可进化灵魂(SOUL.md)、心跳系统、PARA三层记忆架构、目标管理，并通过场景化对话引导用户定义 Agent 性格。自动配置 EvoClaw（审批制进化）和 Self-Improving Agent（自主学习）。触发场景："setup o...
这一步操作起来很简单，直接把密钥粘贴进去就行，但千万不能手误删掉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。
【关键前提】每个模型都需要单独配置一套接口地址+API Key+模型名称并点击「保存」，不能复用同一组参数切换不同模型。
直连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」将出现在自定义模型列表顶部，点击即可激活。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
