需依次完成五步配置：一、获取并记录API密钥及权限信息；二、填写与文档一致的https BaseURL；三、输入严格匹配的模型ID；四、选择认证方式并正确填入密钥；五、启用SSL校验并设置合理超时值。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已购买QClaw支持的API服务并希望将其接入QClaw客户端以调用自定义模型，则需正确配置模型参数与网络通信地址。以下是完成该操作的具体步骤：
一、获取API密钥与授权信息
接入前必须确认您已从API提供商处获得合法有效的密钥（如API Key、Authorization Token等），该密钥将用于身份验证，确保QClaw能通过HTTP请求被后端服务识别和放行。
1、登录API服务商官网或管理控制台。
2、进入“API密钥管理”或“安全凭证”页面。
3、复制当前处于启用状态的API Key字符串，注意不要遗漏前缀（如sk-、Bearer等）及空格。
4、记录该密钥对应的服务区域（Region）、访问权限范围（如仅限chat/completions）及有效期。
二、填写BaseURL地址
BaseURL是QClaw向模型服务发起HTTP请求时所使用的根路径，必须与API服务商文档中明确标注的终端地址完全一致，否则将导致连接失败或404错误。
1、查阅API服务商提供的官方文档，定位“Endpoint”或“Base URL”字段。
2、确认该地址是否包含协议头（必须为https://，不可使用http://）。
3、检查域名后是否携带路径前缀（例如https://api.example.com/v1/中的/v1/部分）。
4、在QClaw设置界面的BaseURL输入框中，粘贴完整且无空格的URL字符串。
三、配置自定义模型名称
模型名称用于在QClaw内部标识所调用的具体AI服务类型，该名称需与API服务商支持的模型ID严格匹配，否则将触发400 Bad Request响应。
1、在API服务商文档的“支持模型列表”中查找目标模型的官方ID（如qwen2.5-7b-chat、llama3-8b-instruct）。
2、进入QClaw的模型设置页，找到“模型名称”或“Model ID”输入项。
3、输入与文档完全一致的模型ID字符串，区分大小写，不添加引号或空格。
4、若服务商要求模型ID带版本号（如gpt-4o-2024-05-13），则必须包含完整日期后缀。
四、选择认证方式并填入密钥
QClaw支持多种认证机制，需根据API服务商要求选择对应方式，并将密钥填入指定位置，否则请求将被拒绝。
1、在认证方式下拉菜单中，选择Bearer Token（多数LLM API采用）或API Key Header（部分服务要求X-API-Key头）。
2、若选Bearer Token，在Token输入框中粘贴不含“Bearer ”前缀的纯密钥字符串。
3、若选API Key Header，在Key值输入框中粘贴密钥，在Header名输入框中填入X-API-Key或服务商指定的头部字段名。
4、点击“测试连接”按钮，观察返回状态码是否为200或401（后者表示密钥有效但权限不足）。
五、启用HTTPS强制校验与超时设置
为保障通信安全与稳定性，QClaw默认启用SSL证书验证及请求超时机制，需确认相关参数与API服务实际配置兼容。
1、勾选“启用SSL证书验证”选项，避免因自签名证书导致连接中断。
2、在“连接超时”输入框中填入数值，推荐值为30秒；若API部署在高延迟网络环境，可设为60秒。
3、在“读取超时”输入框中填入数值，推荐值为120秒，确保长文本生成不被意外终止。
4、保存全部设置后，重启QClaw客户端使配置生效。
