☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 qclaw 中调用非默认的第三方大模型(如 claude、qwen、llama 或本地 ollama 模型),则需通过自定义模型配置完成 api 接入。以下是实现该目标的多种适配路径:
一、通过图形界面配置 OpenAI 兼容接口
此方式适用于绝大多数国内中转站(如 api.clawsocket.com)及主流云厂商(如腾讯混元、阿里通义)提供的 OpenAI 格式 API,无需修改代码,适合新手快速启用。
1、打开 QClaw 客户端,点击左下角“设置”按钮。
2、进入“模型API”或“LLM 设置”页面,查找“新增模型”或“自定义模型”选项。
3、在服务商类型中选择OpenAI Compatible(部分版本显示为“通用API”或“自定义HTTP”)。
4、在 Base URL 输入框中粘贴完整地址,例如:https://api.clawsocket.com/v1(注意必须含 https:// 且末尾不带斜杠)。
5、在 API Key 输入框中填入从服务商控制台复制的密钥,确保无多余空格、无换行、保留 sk- 或 Bearer 前缀。
6、在 Model 字段输入严格匹配的模型 ID,例如:claude-sonnet-4-6 或 qwen2.5-7b-chat(区分大小写,不可加引号)。
7、若界面要求填写 Endpoint,则输入:/chat/completions;若仅提供单一 URL 输入框,则填写完整路径:https://api.clawsocket.com/v1/chat/completions。
8、点击“检测连接”,提示“连接检测成功,可继续”后保存并重启 QClaw。
二、手动配置腾讯混元等原生服务商
针对已深度集成的国产大模型(如腾讯混元),QClaw 提供预置选项,可跳过 Base URL 手动填写,降低出错概率,提升认证稳定性。
1、在“模型API”设置页中,于服务商下拉菜单内直接选择腾讯混元(或“通义千问”“文心一言”等对应条目)。
2、系统将自动填充 Base URL 与 Endpoint 路径,无需手动输入。
3、访问腾讯混元官网,登录腾讯云账号,进入“访问管理 > API 密钥管理”。
4、创建新密钥,复制 SecretId 与 SecretKey,按 QClaw 提示格式拼接为单字符串:SecretId:xxx;SecretKey:yyy。
5、将该字符串粘贴至 API Key 输入框,保存配置。
6、重启 QClaw 后,在对话中输入“测试混元连接”即可触发验证请求。
三、使用 JSON 模板引擎接入非标准 RESTful 模型
当目标模型不遵循 OpenAI 或 Anthropic 协议(如某些私有部署模型、MCP 服务、自研推理后端),需通过 QClaw 的模板引擎自定义 HTTP 请求结构,实现字段级精确控制。
1、在模型设置页选择“其他”或“RESTful 自定义”作为服务商类型。
使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image(图像)和Qwen Wan 2.6(视频)。
2、启用“高级模板模式”开关(部分版本需在设置中开启开发者选项)。
3、在请求方法字段中选择:POST(绝大多数场景适用)。
4、在 Headers 输入框中填写 JSON 对象,例如:{"Authorization": "Bearer {{api_key}}", "Content-Type": "application/json"}。
5、在 Request Body 模板中填入符合目标 API 文档的结构,例如:{"model": "{{model}}", "messages": {{messages}}, "temperature": 0.7}。
6、在 Response Path 字段指定响应体中内容字段的 JSONPath,例如:$.choices[0].message.content。
7、在 Base URL 中填入目标服务根地址,例如:https://my-ollama-server.local:11434/api/chat。
8、保存后执行连接检测,若返回 HTTP 200 且响应体含预期字段即表示模板配置生效。
四、对接本地 Ollama 服务实现零成本运行
利用本机 Ollama 运行开源模型(如 qwen2.5、llama3),可完全规避 API 调用费用与网络延迟,所有数据保留在本地设备,适合隐私敏感场景。
1、确认 Ollama 已安装并运行:在终端执行 ollama serve,浏览器访问 http://localhost:11434 应返回 JSON 响应。
2、拉取目标模型,例如:ollama pull qwen2.5:14b(确保模型名与后续配置一致)。
3、在 QClaw 模型设置中选择“其他”服务商,Base URL 填写:http://localhost:11434/api(注意协议为 http,非 https)。
4、API Key 字段留空或填入任意占位符(Ollama 默认无需认证)。
5、Model 字段输入 Ollama 中注册的模型名称,例如:qwen2.5:14b(含冒号与标签)。
6、Endpoint 填写:/chat(Ollama v0.5+ 使用 /chat,旧版为 /generate)。
7、选择协议类型为Ollama Native(若选项存在);否则使用 RESTful 模板,并按 Ollama API 文档构造 Body。
8、点击检测,成功后即可在微信中发送指令,由本地模型实时响应。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










