QClaw支持通过一步API快速接入多类第三方大模型，需先识别API协议类型（OpenAI/Anthropic/自定义RESTful），再分别配置密钥、端点及请求模板，最后通过测试连接验证连通性与响应解析能力。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望在QClaw中通过一步API快速接入多个第三方大模型，但尚未完成适配与密钥配置，则可能是由于模型服务地址、认证方式或参数格式未正确对齐。以下是实现该目标的具体操作步骤：
一、确认目标模型的API兼容类型
QClaw支持三类主流API协议：OpenAI兼容接口、Anthropic格式接口、以及自定义RESTful接口。需先识别待接入模型所属类别，以匹配QClaw内置的适配器模块。
1、访问目标模型服务商的开发者文档，查找其请求URL路径是否以/v1/chat/completions结尾。
2、检查请求头中是否要求Authorization: Bearer <key></key>且请求体为JSON格式的messages数组。
3、若满足上述两点，则属于OpenAI兼容类型；否则比对是否使用x-api-key头及content字段命名规则，判断是否为Anthropic类型。
二、配置OpenAI兼容模型的密钥与端点
对于OpenAI兼容模型，QClaw允许直接复用现有API密钥与基础URL，无需修改代码逻辑，仅需在管理界面填写对应字段。
1、登录QClaw控制台，进入【模型管理】→【新增模型】页面。
2、在“协议类型”下拉菜单中选择OpenAI兼容。
3、在“API密钥”输入框中粘贴服务商提供的密钥字符串。
4、在“基础URL”栏填写模型服务的实际入口地址，例如https://api.together.xyz/v1或https://openrouter.ai/api/v1。
三、配置Anthropic兼容模型的密钥与端点
Anthropic兼容模型使用独立的认证头和消息结构，QClaw为其预置了专用解析器，需指定特定字段映射关系。
1、在【新增模型】页面，“协议类型”选择Anthropic兼容。
2、将服务商提供的API密钥填入“API密钥”字段，并确保勾选“启用x-api-key认证”选项。
3、在“基础URL”中输入类似https://api.anthropic.com/v1/messages的完整路径（含/v1/messages）。
4、在“模型名称”栏手动输入服务商分配的模型标识符，如claude-3-haiku-20240307。
四、配置自定义RESTful模型的请求模板
当目标模型不遵循OpenAI或Anthropic标准时，QClaw提供JSON模板引擎，可手动定义HTTP方法、头字段、请求体结构及响应路径。
1、在【新增模型】页面，“协议类型”选择自定义RESTful。
2、在“请求方法”中选择POST或GET，并填写完整请求URL。
3、在“请求头JSON”区域输入键值对，例如{"Authorization": "Bearer ${apiKey}", "Content-Type": "application/json"}。
4、在“请求体模板”中编写Mustache语法模板，如{"prompt": "{{prompt}}", "temperature": {{temperature}}。
5、在“响应内容路径”中填写JSONPath表达式，例如$.choices[0].text，用于提取返回文本。
五、验证模型连通性与基础能力
配置完成后，QClaw提供轻量级测试机制，可在保存前实时验证模型是否可调用及响应格式是否可解析。
1、点击【测试连接】按钮，系统自动发送标准探测请求（含model、messages、max_tokens=1）。
2、观察返回状态码是否为200，且响应体中存在text或content字段。
3、若失败，查看控制台输出的原始请求与响应日志，重点核对HTTP状态码、认证头是否被过滤、JSON字段名大小写是否一致。
