Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.qclawrouter.com/llms.txt

Use this file to discover all available pages before exploring further.

准备工作

在开始之前,请确保:
  1. 已安装 Cherry StudioCherry Studio 官网 下载并安装适合您操作系统的版本
  2. 已获取 QClaw Router API 密钥 登录 QClaw Router 控制台 获取您的 API 密钥(以 sk- 开头)
如果还没有 QClaw Router 账户,请先在 QClaw Router 注册并获取 API 密钥。

配置步骤

1

打开模型提供商设置

  1. 启动 Cherry Studio
  2. 点击左下角的 设置 图标(齿轮图标)
  3. 在设置页面中选择 模型服务提供商
2

添加 QClaw Router 提供商

  1. 点击提供商列表右上角的 + 按钮,添加新提供商
  2. 在弹出的对话框中:
    • 名称:填写 QClaw Router
    • 提供商类型:选择 New API(兼容 OpenAI 格式)
  3. 点击 确认 完成创建
3

填写 API 配置

在 QClaw Router 提供商的配置页面中,填写以下信息:
配置项填写内容
API 密钥您的 QClaw Router API 密钥(sk-xxxxxxxxxxxx
API 地址https://api.qclawrouter.com/v1/
4

添加模型

  1. 在提供商配置页面,点击 添加模型 按钮
  2. 填写模型信息:
    • 模型 ID:输入您想使用的模型 ID(见下方推荐模型列表)
    • 端点类型:选择 OpenAI
  3. 点击保存
推荐模型:
模型名称模型 ID特点
Claude Opus 4.6claude-opus-4-6最强大,适合复杂任务
Claude Sonnet 4.6claude-sonnet-4-6性能与速度平衡,推荐日常使用
Claude Haiku 4.5claude-haiku-4-5快速响应,适合简单任务
GPT-5gpt-5最新 OpenAI 旗舰模型
GPT-4ogpt-4o高质量对话与多模态
Gemini 3 Progemini-3-proGoogle 多模态旗舰
Gemini 2.5 Flashgemini-2.5-flash快速且经济
5

启用并验证

  1. 确保提供商右侧的开关处于开启状态
  2. 点击 检查连接测试 按钮,验证配置是否正确
  3. 如果提示连接成功,说明配置完成

开始使用

配置完成后:
  1. 返回 Cherry Studio 主界面
  2. 在对话框顶部的模型选择器中,选择刚才添加的 QClaw Router 模型
  3. 开始对话

常见问题

解决方案:
  1. 检查 API 密钥 是否正确,确认以 sk- 开头
  2. 确认 API 地址 填写为 https://api.qclawrouter.com/v1/(注意末尾的斜杠)
  3. QClaw Router 控制台 确认密钥未过期且账户余额充足
  4. 检查网络连接,确保能访问 https://api.qclawrouter.com
Cherry Studio 使用手动添加模型的方式,直接在添加模型时输入模型 ID 即可。可在 QClaw Router 模型列表 查看所有可用模型 ID。
错误信息原因解决方法
401 UnauthorizedAPI Key 无效或过期重新获取 API Key
429 Too Many Requests请求频率超限稍等片刻后重试
500 Internal Server Error服务器临时故障等待几分钟后重试
insufficient_quota账户余额不足前往控制台充值

支持与帮助