Skip to Content

BotGem Setup

BotGem  is a cross-platform AI desktop client (macOS, Windows, iOS, Android) that supports custom API providers, making it easy to use for everyday AI conversations.

Prerequisites

Setup Steps

Step 1: Open Settings

Launch BotGem and click Settings in the left sidebar.

Open BotGem Settings

Step 2: Go to Service Provider

In the Settings page, click Service Provider.

Go to Service Provider

Step 3: Click + and Select a Protocol

Click the + button in the top right and choose a protocol type.

OfoxAI supports three protocols — OpenAI is recommended:

ProtocolSelectSupported Models
OpenAI Chat (recommended)OpenAIopenai/gpt-4.1, openai/gpt-4.1-mini, openai/gpt-5.4-mini, etc. (examples only)
ClaudeClaudeanthropic/claude-sonnet-4.6, anthropic/claude-opus-4.6, anthropic/claude-haiku-4.5
GeminiGeminigoogle/gemini-3.1-flash-lite-preview, google/gemini-3.1-pro-preview

BotGem does not support the OpenAI Responses protocol (/v1/responses). This protocol uses an input field instead of messages, and BotGem only supports the standard Chat Completions format.

Select OpenAI

Step 4: Fill in the Configuration

Fill in the configuration form based on the protocol selected in Step 3.

API Server by protocol:

ProtocolAPI Server
OpenAI Chat (recommended)https://api.ofox.ai
Claudehttps://api.ofox.ai/anthropic
Geminihttps://api.ofox.ai/gemini

Example using OpenAI Chat:

FieldValue
Nameofox (or any name)
API Serverhttps://api.ofox.ai
API KeyYour OfoxAI API Key
ModelsClick Refresh to auto-fetch, or type manually, e.g. gpt-4.1

Fill in configuration

When you enter https://api.ofox.ai, BotGem automatically appends /v1/chat/completions. Using OpenAI Chat, you can call any model — just use the provider/model-name format when typing manually, e.g. anthropic/claude-opus-4.5 or deepseek/deepseek-v3.2.

Step 5: Check Connection and Save

Click Check Connection. Once you see “Connected successfully!” at the top, click Save.

Connection successful

Start Using

After saving, go back to the main screen and click Start Chat. The current model name is shown at the top of the chat window. Type your message to start.

Start chatting

Troubleshooting

Q: Connection check fails

  1. Make sure the API Server address is correct (see table above)
  2. Make sure your API Key is copied in full from the OfoxAI Console  with no extra spaces
  3. Check your network connection

Q: The model I want isn’t in the list

Click Refresh to auto-fetch the model list. Names in the list have no prefix (e.g. gpt-4.1).

To use a model not in the list, type the full model name in the format provider/model-name, for example:

ModelInput name
DeepSeek V3deepseek/deepseek-v3.2
Claude Sonnetanthropic/claude-sonnet-4.6
Gemini Flashgoogle/gemini-3.1-flash-lite-preview

See all available models at Models .

Last updated on