BotGem 設定
BotGem 是一款跨平台 AI 桌面用戶端(支援 macOS、Windows、iOS、Android),支援自訂 API 服務商,適合日常 AI 對話使用。
前提條件
設定步驟
第 1 步:開啟設定
啟動 BotGem,點擊左側邊欄的 設定。

第 2 步:進入 Service Provider
在設定頁面中,點擊 Service Provider。

第 3 步:點擊 + 選擇協議
點擊右上角的 + 按鈕,根據需要選擇協議類型。
OfoxAI 支援以下三種協議,推薦選擇 OpenAI:
| 協議 | 選擇 | 適用模型 |
|---|---|---|
| OpenAI Chat(推薦) | OpenAI | openai/gpt-4.1、openai/gpt-4.1-mini、openai/gpt-5.4-mini 等(部分示例) |
| Claude | Claude | anthropic/claude-sonnet-4.6、anthropic/claude-opus-4.6、anthropic/claude-haiku-4.5 |
| Gemini | Gemini | google/gemini-3.1-flash-lite-preview、google/gemini-3.1-pro-preview |
BotGem 暫不支援 OpenAI Responses 協議(/v1/responses)。該協議使用 input 欄位而非 messages,BotGem 目前僅支援標準 Chat Completions 格式。

第 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 |

API Server 填 https://api.ofox.ai 後,BotGem 會自動補全為 https://api.ofox.ai/v1/chat/completions。透過 OpenAI Chat 協議可調用所有廠商模型,手動輸入時使用 廠商/模型名 格式,例如 anthropic/claude-opus-4.5、deepseek/deepseek-v3.2。
第 5 步:檢查連線並儲存
點擊 檢查連線 按鈕,看到頂部出現「連線成功!」提示後,點擊 儲存。

開始使用
儲存後回到主介面,點擊左下角 開始對話,頂部會顯示目前使用的模型名稱,直接在輸入框輸入訊息即可開始使用。

常見問題
Q: 點擊「檢查連線」提示失敗
- 確認 API Server 地址填寫正確(見上方表格)
- 確認 API Key 從 OfoxAI 控制台 完整複製,無多餘空格
- 確認網路連線正常
Q: 模型清單裡沒有我想用的模型
點擊 Models 右側的 Refresh 按鈕可自動拉取模型清單,清單中的名稱不含前綴(如 gpt-4.1)。
如果想使用清單之外的模型,需要手動輸入完整模型名稱,格式為 廠商/模型名,例如:
| 模型 | 輸入名稱 |
|---|---|
| DeepSeek V3 | deepseek/deepseek-v3.2 |
| Claude Sonnet | anthropic/claude-sonnet-4.6 |
| Gemini Flash | google/gemini-3.1-flash-lite-preview |
完整模型清單可在 模型目錄 查看。