# RikkaHub 接入 OfoxAI 配置指南

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

[RikkaHub](https://rikka-ai.com) 是一款开源的原生 Android AI 聊天客户端，采用 Material You 设计，支持自定义 OpenAI / Google / Anthropic 兼容接口，内置 MCP、联网搜索、记忆、多模态输入等能力。

## 前提条件

- 已注册 OfoxAI 账号并获取 API Key（[前往获取](https://app.ofox.ai)）
- 已在 Android 手机上安装 RikkaHub（[官网下载](https://rikka-ai.com/download) 或 [Google Play](https://play.google.com/store/apps/details?id=me.rerere.rikkahub)）

## 选择协议

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.5`、`anthropic/claude-opus-5.5` 等 | `https://api.ofox.ai/anthropic/v1` |
| **Google**（推荐用于 Gemini 系列） | `google/gemini-3.8-flash` 等 | `https://api.ofox.ai/gemini/v1beta` |

中国大陆网络可改用镜像域名 `api.ofox.io`，路径不变，API Key 通用。下方截图使用的就是镜像地址。

## 配置 OpenAI 协议

### 第 1 步：打开设置

打开 RikkaHub 左侧边栏，点击右下角的 **设置** 图标。

![侧边栏底部的设置图标](https://ofox.ai/screenshots/rikkahub/01-open-settings.jpeg)

### 第 2 步：进入提供商

在设置页的 **模型与服务** 分组下，点击 **提供商**。

![设置 → 模型与服务 → 提供商](https://ofox.ai/screenshots/rikkahub/02-settings-provider.jpeg)

### 第 3 步：添加提供商

点击右上角的 **+** 新建一个提供商。

![提供商列表右上角的 + 按钮](https://ofox.ai/screenshots/rikkahub/03-add-provider.jpeg)

### 第 4 步：填写配置

类型选 **OpenAI**，填写以下信息后点击 **保存**：

| 配置项 | 值 |
|--------|-----|
| **名称** | `ofox`（或任意名称） |
| **API Key** | 你的 OfoxAI API Key |
| **API Base Url** | `https://api.ofox.ai/v1` |
| **是否启用** | 开启 |
| **Response API** | 使用 OpenAI 模型时推荐开启，API 路径会自动变为 `/responses` |

![OpenAI 类型提供商配置页](https://ofox.ai/screenshots/rikkahub/04-openai-config.jpeg)

RikkaHub 会把 **API Base Url** 和 **API 路径** 直接拼接成请求地址。Base Url 末尾不要带斜杠，也不要带 `/chat/completions`。关闭 Response API 时，API 路径为默认的 `/chat/completions`，可调用 OfoxAI 上的所有模型；开启后走 OfoxAI 推荐的 [Responses API](https://ofox.ai/zh/docs/api/openai/responses)，原生 Prompt Caching 更优。

### 第 5 步：添加模型

切换到底部的 **模型** 标签页。RikkaHub 会自动拉取 OfoxAI 的模型目录，可以直接从 **可用模型** 列表中勾选；也可以点击 **添加新模型**，手动填写模型 ID，例如 `openai/gpt-6-luna`。

模型 ID 需要带厂商前缀，写 `openai/gpt-6-luna`，而不是裸的 `gpt-6-luna`。完整目录见[模型广场](https://ofox.ai/zh/models)。

### 第 6 步：测试连接

回到 **配置** 标签页，点击左下角的插头图标打开 **测试连接**，选择一个模型后点击 **测试**。**非流式**、**流式**、**工具调用** 三项都显示绿色对勾，即表示配置成功。

![测试连接：非流式、流式、工具调用均通过](https://ofox.ai/screenshots/rikkahub/05-openai-test.jpeg)

## 配置 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](https://ofox.ai/zh/docs/develop/advanced/prompt-caching) |

![Claude 类型提供商配置页](https://ofox.ai/screenshots/rikkahub/06-claude-config.jpeg)

Claude 类型的 Base Url **必须带 `/v1`**。RikkaHub 会在后面自动拼接 `/messages`，漏掉 `/v1` 会请求到 `/anthropic/messages`，返回 404。

### 第 2 步：添加模型并测试

在 **模型** 标签页添加 Claude 模型（例如 `anthropic/claude-sonnet-5.5`），回到 **配置** 标签页点击插头图标测试连接，三项都显示绿色对勾即可。

![Claude 协议测试连接通过](https://ofox.ai/screenshots/rikkahub/07-claude-test.jpeg)

## 配置 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 类型提供商配置页](https://ofox.ai/screenshots/rikkahub/08-gemini-config.jpeg)

Google 类型的 API Base Url 默认指向 Google 官方地址，**必须改成** `https://api.ofox.ai/gemini/v1beta`（带 `/v1beta`，末尾不加斜杠）。RikkaHub 会在后面自动拼接 `/models/<模型 ID>:generateContent`。**Vertex AI** 开关保持关闭。

### 第 2 步：添加模型并测试

在 **模型** 标签页添加 Gemini 模型（例如 `google/gemini-3.8-flash`，需带 `google/` 前缀），回到 **配置** 标签页点击插头图标测试连接，三项都显示绿色对勾即可。

![Gemini 协议测试连接通过](https://ofox.ai/screenshots/rikkahub/09-gemini-test.jpeg)

## 推荐模型

| 模型 ID | 推荐提供商类型 | 说明 |
|---------|--------------|------|
| `openai/gpt-6-luna` | OpenAI | GPT-6 家族中速度最快、成本最低的型号，适合日常对话 |
| `anthropic/claude-sonnet-5.5` | Claude | Claude 主力模型，1M 上下文，综合能力强 |
| `google/gemini-3.8-flash` | Google | 多模态、速度快，适合高频使用 |
| `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 控制台](https://app.ofox.ai) 完整复制，前后没有多余空格。

**Q: 提示模型不存在**

模型 ID 缺少厂商前缀。OfoxAI 的模型 ID 格式为 `厂商/模型名`，例如 `openai/gpt-6-luna`、`anthropic/claude-sonnet-5.5`。

**Q: 中国大陆网络连接失败**

把 API Base Url 换成镜像地址：OpenAI 类型填 `https://api.ofox.io/v1`，Claude 类型填 `https://api.ofox.io/anthropic/v1`，API Key 通用。