# BotGem 接入 OfoxAI 配置指南

Source: https://ofox.ai/zh/docs/integrations/botgem

[BotGem](https://botgem.com) 是一款跨平台 AI 桌面客户端（支持 macOS、Windows、iOS、Android），支持自定义 API 服务商，适合日常 AI 对话使用。

## 前提条件

- 已注册 OfoxAI 账号并获取 API Key（[前往获取](https://app.ofox.ai)）
- 已安装 BotGem（[下载地址](https://botgem.com)）

## 配置步骤

### 第 1 步：打开设置

启动 BotGem，点击左侧边栏的 **设置**。

![打开 BotGem 设置](https://ofox.ai/screenshots/botgem/01-open-settings.png)

### 第 2 步：进入 Service Provider

在设置页面中，点击 **Service Provider**。

![进入 Service Provider](https://ofox.ai/screenshots/botgem/02-service-provider.png)

### 第 3 步：点击 + 选择协议

点击右上角的 **+** 按钮，根据需要选择协议类型。

OfoxAI 支持以下三种协议，推荐选择 **OpenAI**：

| 协议 | 选择 | 适用模型 |
|------|------|---------|
| **OpenAI Chat**（推荐） | OpenAI | `openai/gpt-6.1-sol`、`openai/gpt-6-luna`、`openai/gpt-5.5` 等（部分示例） |
| **Claude** | Claude | `anthropic/claude-sonnet-5.5`、`anthropic/claude-opus-5.5`、`anthropic/claude-haiku-5.5` |
| **Gemini** | Gemini | `google/gemini-3.8-flash`、`google/gemini-3.5-flash-lite` |

BotGem 暂不支持 OpenAI Responses 协议（`/v1/responses`）。该协议使用 `input` 字段而非 `messages`，BotGem 目前仅支持标准 Chat Completions 格式。

![选择 OpenAI](https://ofox.ai/screenshots/botgem/03-add-openai.png)

### 第 4 步：填写配置信息

在弹出的配置表单中填写以下信息。

根据第 3 步选择的协议，填写对应的 API Server：

| 协议 | API Server |
|------|-----------|
| **OpenAI Chat**（推荐） | `https://api.ofox.ai` |
| **Claude** | `https://api.ofox.ai/anthropic` |
| **Gemini** | `https://api.ofox.ai/gemini` |

以 OpenAI Chat 为例：

| 配置项 | 值 |
|--------|-----|
| **Name** | `ofox`（或任意名称） |
| **API Server** | `https://api.ofox.ai` |
| **API Key** | 你的 OfoxAI API Key |
| **Models** | 点击 Refresh 自动拉取，或手动输入，例如 `gpt-4.1` |

![填写配置信息](https://ofox.ai/screenshots/botgem/04-config-openai.png)

API Server 填 `https://api.ofox.ai` 后，BotGem 会自动补全为 `https://api.ofox.ai/v1/chat/completions`。通过 OpenAI Chat 协议可调用所有厂商模型，手动输入时使用 `厂商/模型名` 格式，例如 `anthropic/claude-opus-5.5`、`deepseek/deepseek-v4.1-flash`。

### 第 5 步：检查连接并保存

点击 **检查连接** 按钮，看到顶部出现「**连接成功！**」提示后，点击 **保存**。

![连接成功](https://ofox.ai/screenshots/botgem/05-verify-success.png)

## 开始使用

保存后回到主界面，点击左下角 **开始对话**，顶部会显示当前使用的模型名称，直接在输入框输入消息即可开始使用。

![开始对话](https://ofox.ai/screenshots/botgem/06-start-chat.png)

## 常见问题

**Q: 点击「检查连接」提示失败**

1. 确认 API Server 地址填写正确（见上方表格）
2. 确认 API Key 从 [OfoxAI 控制台](https://app.ofox.ai) 完整复制，无多余空格
3. 确认网络连接正常

**Q: 模型列表里没有我想用的模型**

点击 Models 右侧的 **Refresh** 按钮可自动拉取模型列表，列表中的名称**不带前缀**（如 `gpt-4.1`）。

如果想使用列表之外的模型，需要**手动输入完整模型名**，格式为 `厂商/模型名`。完整模型列表可在 [OfoxAI 模型广场](https://ofox.ai/zh/models) 查看。