RikkaHub 配置
RikkaHub 是一款開源的原生 Android AI 聊天客戶端，採用 Material You 設計，支援自訂 OpenAI / Google / Anthropic 相容介面，內建 MCP、聯網搜尋、記憶、多模態輸入等功能。
前提條件
- 已註冊 OfoxAI 帳號並取得 API Key（前往取得 ）
- 已在 Android 手機上安裝 RikkaHub（官網下載 或 Google Play ）
選擇協議
RikkaHub 的提供商有 OpenAI、Google、Claude 三種類型，均可接入 OfoxAI，對應關係如下：
| 提供商類型 | 適用模型 | API Base Url |
|---|---|---|
| OpenAI（通用） | 所有模型，如 openai/gpt-6-luna、deepseek/deepseek-v4.1-flash | https://api.ofox.ai/v1 |
| Claude（推薦用於 Claude 系列） | anthropic/claude-sonnet-5、anthropic/claude-opus-4.8 等 | https://api.ofox.ai/anthropic/v1 |
| Google（推薦用於 Gemini 系列） | google/gemini-3.5-flash 等 | https://api.ofox.ai/gemini/v1beta |
中國大陸網路可改用鏡像網域 api.ofox.io，路徑不變，API Key 通用。下方截圖使用的就是鏡像位址。
配置 OpenAI 協議
第 1 步：開啟設定
開啟 RikkaHub 左側邊欄，點擊右下角的 設定 圖示。
第 2 步：進入提供商
在設定頁的 模型與服務 分組下，點擊 提供商。
第 3 步：新增提供商
點擊右上角的 + 建立一個提供商。
第 4 步：填寫配置
類型選 OpenAI，填寫以下資訊後點擊 保存：
| 配置項 | 值 |
|---|---|
| 名稱 | ofox（或任意名稱） |
| API Key | 你的 OfoxAI API Key |
| API Base Url | https://api.ofox.ai/v1 |
| 是否啟用 | 開啟 |
| Response API | 使用 OpenAI 模型時推薦開啟，API 路徑會自動變為 /responses |
RikkaHub 會把 API Base Url 和 API 路徑 直接拼接成請求位址。Base Url 結尾不要帶斜線，也不要帶 /chat/completions。關閉 Response API 時，API 路徑為預設的 /chat/completions，可調用 OfoxAI 上的所有模型；開啟後走 OfoxAI 推薦的 Responses API，原生 Prompt Caching 更優。
第 5 步：新增模型
切換到底部的 模型 分頁。RikkaHub 會自動拉取 OfoxAI 的模型目錄，可以直接從 可用模型 列表中勾選；也可以點擊 添加新模型，手動填寫模型 ID，例如 openai/gpt-6-luna。
模型 ID 需要帶供應商前綴，寫 openai/gpt-6-luna，而不是裸的 gpt-6-luna。完整目錄見模型廣場 。
第 6 步：測試連線
回到 配置 分頁，點擊左下角的插頭圖示開啟 測試連接，選擇一個模型後點擊 測試。非串流、串流、工具呼叫 三項都顯示綠色勾號，即表示配置成功。
配置 Claude 協議（推薦用於 Claude 模型）
調用 Claude 系列模型時，推薦用 Anthropic 原生協議，可獲得完整特性和原生快取優勢。
第 1 步：建立 Claude 類型提供商
按上面第 1–3 步再建立一個提供商（例如命名為 ofox-claude），這樣 OpenAI 和 Claude 兩種協議可以同時使用。類型選 Claude，填寫以下資訊後點擊 保存：
| 配置項 | 值 |
|---|---|
| 名稱 | ofox-claude（或任意名稱） |
| API Key | 你的 OfoxAI API Key |
| API Base Url | https://api.ofox.ai/anthropic/v1 |
| 是否啟用 | 開啟 |
| 提示快取 (cache_control) | 可選，開啟後長對話可節省輸入成本，詳見 Prompt Caching |
Claude 類型的 Base Url 必須帶 /v1。RikkaHub 會在後面自動拼接 /messages，漏掉 /v1 會請求到 /anthropic/messages，回傳 404。
第 2 步：新增模型並測試
在 模型 分頁新增 Claude 模型（例如 anthropic/claude-sonnet-5），回到 配置 分頁點擊插頭圖示測試連線，三項都顯示綠色勾號即可。
配置 Gemini 協議（推薦用於 Gemini 模型）
呼叫 Gemini 系列模型時，推薦使用 Gemini 原生協議。
第 1 步：建立 Google 類型提供商
按上面第 1–3 步再建立一個提供商（例如命名為 ofox-gemini）。類型選 Google，填寫以下資訊後點擊 保存：
| 配置項 | 值 |
|---|---|
| 名稱 | ofox-gemini（或任意名稱） |
| API Key | 你的 OfoxAI API Key |
| API Base Url | https://api.ofox.ai/gemini/v1beta |
| Vertex AI | 關閉 |
Google 類型的 API Base Url 預設指向 Google 官方位址，必須改成 https://api.ofox.ai/gemini/v1beta（帶 /v1beta，結尾不加斜線）。RikkaHub 會在後面自動拼接 /models/<模型 ID>:generateContent。Vertex AI 開關保持關閉。
第 2 步：新增模型並測試
在 模型 分頁新增 Gemini 模型（例如 google/gemini-3.5-flash，需帶 google/ 前綴），回到 配置 分頁點擊插頭圖示測試連線，三項都顯示綠色勾號即可。
推薦模型
| 模型 ID | 推薦提供商類型 | 說明 |
|---|---|---|
openai/gpt-6-luna | OpenAI | GPT-6 家族中速度最快、成本最低的型號，適合日常對話 |
anthropic/claude-sonnet-5 | Claude | Claude Sonnet 旗艦，1M 上下文，綜合能力強 |
google/gemini-3.5-flash | 多模態、速度快，適合高頻使用 | |
deepseek/deepseek-v4.1-flash | OpenAI | 性價比高，中文表現好 |
開始使用
回到聊天頁，在模型選擇器中找到剛新增的 OfoxAI 提供商，選擇模型即可開始對話。RikkaHub 的 MCP、聯網搜尋、多模態輸入等功能都可以搭配 OfoxAI 模型使用。
常見問題
Q: 測試連線時沒有可選的模型
測試連線只能從目前提供商已新增的模型裡選。先到 模型 分頁新增至少一個模型，再回到 配置 頁測試。
Q: Claude 類型提供商測試回傳 404
檢查 API Base Url 是否寫成了 https://api.ofox.ai/anthropic，漏掉了結尾的 /v1。正確寫法是 https://api.ofox.ai/anthropic/v1。
Q: 提示 API Key 無效
確認 API Key 從 OfoxAI 控制台 完整複製，前後沒有多餘空格。
Q: 提示模型不存在
模型 ID 缺少供應商前綴。OfoxAI 的模型 ID 格式為 供應商/模型名，例如 openai/gpt-6-luna、anthropic/claude-sonnet-5。
Q: 中國大陸網路連線失敗
把 API Base Url 換成鏡像位址：OpenAI 類型填 https://api.ofox.io/v1，Claude 類型填 https://api.ofox.io/anthropic/v1，API Key 通用。