> ## 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.

# Cherry Studio 配置指南

> 在 Cherry Studio 中使用 QClaw Router 作为 API 后端

## 准备工作

在开始之前，请确保：

1. **已安装 Cherry Studio**
   从 [Cherry Studio 官网](https://cherry-ai.com) 下载并安装适合您操作系统的版本

2. **已获取 QClaw Router API 密钥**
   登录 [QClaw Router 控制台](https://api.qclawrouter.com/dashboard) 获取您的 API 密钥（以 `sk-` 开头）

<Tip>
  如果还没有 QClaw Router 账户，请先在 [QClaw Router](https://api.qclawrouter.com) 注册并获取 API 密钥。
</Tip>

## 配置步骤

<Steps>
  <Step title="打开模型提供商设置">
    1. 启动 Cherry Studio
    2. 点击左下角的 **设置** 图标（齿轮图标）
    3. 在设置页面中选择 **模型服务** 或 **提供商**
  </Step>

  <Step title="添加 QClaw Router 提供商">
    1. 点击提供商列表右上角的 **+** 按钮，添加新提供商
    2. 在弹出的对话框中：
       * **名称**：填写 `QClaw Router`
       * **提供商类型**：选择 **New API**（兼容 OpenAI 格式）
    3. 点击 **确认** 完成创建
  </Step>

  <Step title="填写 API 配置">
    在 QClaw Router 提供商的配置页面中，填写以下信息：

    | 配置项        | 填写内容                                      |
    | ---------- | ----------------------------------------- |
    | **API 密钥** | 您的 QClaw Router API 密钥（`sk-xxxxxxxxxxxx`） |
    | **API 地址** | `https://api.qclawrouter.com/v1/`         |
  </Step>

  <Step title="添加模型">
    1. 在提供商配置页面，点击 **添加模型** 按钮
    2. 填写模型信息：
       * **模型 ID**：输入您想使用的模型 ID（见下方推荐模型列表）
       * **端点类型**：选择 **OpenAI**
    3. 点击保存

    **推荐模型：**

    | 模型名称              | 模型 ID               | 特点             |
    | ----------------- | ------------------- | -------------- |
    | Claude Opus 4.6   | `claude-opus-4-6`   | 最强大，适合复杂任务     |
    | Claude Sonnet 4.6 | `claude-sonnet-4-6` | 性能与速度平衡，推荐日常使用 |
    | Claude Haiku 4.5  | `claude-haiku-4-5`  | 快速响应，适合简单任务    |
    | GPT-5             | `gpt-5`             | 最新 OpenAI 旗舰模型 |
    | GPT-4o            | `gpt-4o`            | 高质量对话与多模态      |
    | Gemini 3 Pro      | `gemini-3-pro`      | Google 多模态旗舰   |
    | Gemini 2.5 Flash  | `gemini-2.5-flash`  | 快速且经济          |
  </Step>

  <Step title="启用并验证">
    1. 确保提供商右侧的开关处于**开启**状态
    2. 点击 **检查连接** 或 **测试** 按钮，验证配置是否正确
    3. 如果提示连接成功，说明配置完成
  </Step>
</Steps>

## 开始使用

配置完成后：

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

## 常见问题

<AccordionGroup>
  <Accordion title="Q1: 连接测试失败？">
    **解决方案：**

    1. 检查 **API 密钥** 是否正确，确认以 `sk-` 开头
    2. 确认 **API 地址** 填写为 `https://api.qclawrouter.com/v1/`（注意末尾的斜杠）
    3. 在 [QClaw Router 控制台](https://api.qclawrouter.com/dashboard) 确认密钥未过期且账户余额充足
    4. 检查网络连接，确保能访问 `https://api.qclawrouter.com`
  </Accordion>

  <Accordion title="Q2: 模型列表中找不到我的模型？">
    Cherry Studio 使用手动添加模型的方式，直接在添加模型时输入模型 ID 即可。可在 [QClaw Router 模型列表](/docs/cn/api-reference/chat/models) 查看所有可用模型 ID。
  </Accordion>

  <Accordion title="Q3: 常见错误码说明">
    | 错误信息                        | 原因            | 解决方法         |
    | --------------------------- | ------------- | ------------ |
    | `401 Unauthorized`          | API Key 无效或过期 | 重新获取 API Key |
    | `429 Too Many Requests`     | 请求频率超限        | 稍等片刻后重试      |
    | `500 Internal Server Error` | 服务器临时故障       | 等待几分钟后重试     |
    | `insufficient_quota`        | 账户余额不足        | 前往控制台充值      |
  </Accordion>
</AccordionGroup>

## 支持与帮助

* 📚 [QClaw Router 文档中心](https://docs.qclawrouter.com)
* 📚 [Cherry Studio 官方文档](https://docs.cherry-ai.com)
* 💬 [Discord 社区](https://discord.gg/qclawrouter)
* 🐦 [Twitter @qclawrouter](https://x.com/yourapi)