Skip to Content

BotGem 配置

BotGem  是一款跨平台 AI 桌面客户端(支持 macOS、Windows、iOS、Android),支持自定义 API 服务商,适合日常 AI 对话使用。

前提条件

配置步骤

第 1 步:打开设置

启动 BotGem,点击左侧边栏的 设置

打开 BotGem 设置

第 2 步:进入 Service Provider

在设置页面中,点击 Service Provider

进入 Service Provider

第 3 步:点击 + 选择协议

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

OfoxAI 支持以下三种协议,推荐选择 OpenAI

协议选择适用模型
OpenAI Chat(推荐)OpenAIopenai/gpt-4.1openai/gpt-4.1-miniopenai/gpt-5.4-mini 等(部分示例)
ClaudeClaudeanthropic/claude-sonnet-4.6anthropic/claude-opus-4.6anthropic/claude-haiku-4.5
GeminiGeminigoogle/gemini-3.1-flash-lite-previewgoogle/gemini-3.1-pro-preview

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

选择 OpenAI

第 4 步:填写配置信息

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

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

协议API Server
OpenAI Chat(推荐)https://api.ofox.ai
Claudehttps://api.ofox.ai/anthropic
Geminihttps://api.ofox.ai/gemini

以 OpenAI Chat 为例:

配置项
Nameofox(或任意名称)
API Serverhttps://api.ofox.ai
API Key你的 OfoxAI API Key
Models点击 Refresh 自动拉取,或手动输入,例如 gpt-4.1

填写配置信息

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

第 5 步:检查连接并保存

点击 检查连接 按钮,看到顶部出现「连接成功!」提示后,点击 保存

连接成功

开始使用

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

开始对话

常见问题

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

  1. 确认 API Server 地址填写正确(见上方表格)
  2. 确认 API Key 从 OfoxAI 控制台  完整复制,无多余空格
  3. 确认网络连接正常

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

点击 Models 右侧的 Refresh 按钮可自动拉取模型列表,列表中的名称不带前缀(如 gpt-4.1)。

如果想使用列表之外的模型,需要手动输入完整模型名,格式为 厂商/模型名,例如:

模型输入名称
DeepSeek V3deepseek/deepseek-v3.2
Claude Sonnetanthropic/claude-sonnet-4.6
Gemini Flashgoogle/gemini-3.1-flash-lite-preview

完整模型列表可在 模型目录  查看。

Last updated on