可自部署 · BYOK AI 工作台

把 PPAPI 中转站,发布成一个能直接用的产品。

RelayBox 面向普通用户:API Base 固定为 https://api.ppapi.pro/,只需要输入自己的 API Key,先读取 /v1/models,再选择聊天模型、生图模型,最后按 macOS / Windows 一键配置入口接到本机客户端。

https://api.ppapi.pro/ 已锁定/v1/models 可视化聊天 / 生图模型分开选本机配置只用占位符
relaybox.app/workbench
User task
读取 /v1/models 并选择模型
AI
0models
0stored keys
2modes
模型选择正式化聊天模型和生图模型拆开维护,刷新模型后自动按类型填入下拉框。
/v1/models 直接展示展示模型数量、模型卡片和原始 JSON,方便用户确认中转站到底开放了哪些模型。
Mac / Windows 配置入口一键复制本机配置模板,只包含占位符,不读取页面中的真实密钥。
同源代理更稳前端请求本地 /api/*,服务器统一转发到固定 PPAPI 地址,减少浏览器 CORS 问题。
新手三步走

从拿到 SK 到开始使用,不用懂接口。

面向普通用户的最短路径:先去 PPAPI 主站拿到自己的 SK,再在本页测试连接,最后选择聊天、生图或 OpenClaw 本机配置。

1

去 PPAPI 主站购买 / 获取 SK

打开主站完成购买或领取,复制你自己的 PPAPI SK。本页不会保存或导出这个 SK。

2

粘贴 SK 测试连接

回到工作台,把 SK 粘贴到密码框,点击“测试连接并读取模型”,确认当前账号可用。

3

选择模型开始聊天 / 生图 / 配置 OpenClaw

不会选模型也没关系,下面有场景推荐;也可以把同一套 PPAPI 配置接到 OpenClaw。

配置 OpenClaw

连接后直接使用

左侧确认固定 API Base、填写 API Key、选择模型;右侧就是聊天和生图结果。密钥不写入 localStorage,不写入本地记录。

等待连接

聊天

像正常 AI 产品一样对话

PPAPI 地址已固定,等待填写 API Key
会携带最近对话上下文错误会显示上游 code/message

/v1/models 展示

测试连接或刷新模型后,这里会展示模型数量、自动分类结果和原始响应,方便确认中转站支持哪些模型。

等待读取
还没有读取模型。先在工作台点击“测试连接并读取模型”。
查看 /v1/models 原始 JSON
{}
选择系统,一键下载安装

OpenClaw / Hermes 本机接入向导。

按 Mac、Windows、Linux 选择官方入口或本地安装包槽位;复制占位模板不会读取你的 SK。只有点击“一键生成本机配置”时,浏览器才会在本地临时读取输入框里的 PPAPI SK,生成可复制或下载的配置文件。

浏览器本地临时生成:不会上传或保存 SK;下载文件只在你的设备上生成。
macOS

一键复制配置脚本

适合 Terminal / zsh。脚本只创建本机模板文件,真实 SK 由你在本机或下方显式生成。

macOS 模板预览
mkdir -p ~/.relaybox
cat > ~/.relaybox/openai-compatible.env <<'EOF'
API_BASE=<YOUR_API_BASE>
API_KEY=<YOUR_SK_OR_API_KEY>
CHAT_MODEL=<YOUR_CHAT_MODEL>
IMAGE_MODEL=<YOUR_IMAGE_MODEL>
CLIENT_SECRET=<YOUR_CLIENT_SECRET>
EOF
Windows PowerShell

一键复制配置脚本

适合 Windows PowerShell。脚本写入用户目录下的模板文件,不会从网页读取或保存密钥。

Windows 模板预览
New-Item -ItemType Directory -Force "$env:USERPROFILE\.relaybox" | Out-Null
@"
API_BASE=<YOUR_API_BASE>
API_KEY=<YOUR_SK_OR_API_KEY>
CHAT_MODEL=<YOUR_CHAT_MODEL>
IMAGE_MODEL=<YOUR_IMAGE_MODEL>
CLIENT_SECRET=<YOUR_CLIENT_SECRET>
"@ | Set-Content "$env:USERPROFILE\.relaybox\openai-compatible.env"
Linux / WSL

一键复制配置脚本

适合 Linux 服务器、WSL 和桌面发行版。安装客户端请优先走官方文档或 Releases。

Linux 模板预览
mkdir -p ~/.config/relaybox
cat > ~/.config/relaybox/ppapi.env <<'EOF'
API_BASE=<YOUR_API_BASE>
API_KEY=<YOUR_SK_OR_API_KEY>
CHAT_MODEL=<YOUR_CHAT_MODEL>
IMAGE_MODEL=<YOUR_IMAGE_MODEL>
CLIENT_SECRET=<YOUR_CLIENT_SECRET>
EOF
OpenClaw package slot

本地安装包

当前仓库未检测到本地安装包。需要离线分发时,把 .dmg / .zip / .exe / .pkg 放入 outputs/downloads/openclaw/;未放置时请走官方下载安装。

Hermes package slot

本地安装包

当前仓库未检测到本地安装包。需要离线分发时,把 .tar.gz / .zip / .exe / .appimage 放入 outputs/downloads/hermes/;未放置时请走官方下载安装。

Personal AI Assistant

OpenClaw

适合把通用 AI 中转站接入个人助手和消息平台工作流。安装后选择 OpenAI Compatible / 自定义 Provider,API Base 固定使用 PPAPI。

  1. 从官方文档、Releases 或本地安装包入口安装 OpenClaw。
  2. 点击“复制占位模板”可拿到不含真实密钥的示例。
  3. 点击“一键生成本机配置”相关按钮时,浏览器会本地读取当前 PPAPI SK,生成 OpenClaw env 文件内容。
OpenClaw 配置模板
PROVIDER=openai-compatible
API_BASE=<YOUR_API_BASE>
API_KEY=<YOUR_SK_OR_API_KEY>
CHAT_MODEL=<YOUR_CHAT_MODEL>
IMAGE_MODEL=<YOUR_IMAGE_MODEL>
CLIENT_SECRET=<YOUR_CLIENT_SECRET>
密钥边界:复制占位模板不读取输入框;生成配置只发生在你点击按钮的浏览器本地。
Terminal Agent Framework

Hermes

适合终端、IDE、多平台消息机器人和可扩展 Agent 工作流。Hermes 安装方式待官方确认,本页只给官方入口和安全配置模板。

  1. Hermes 安装方式待官方确认:请从 Docs / GitHub 选择与你系统匹配的官方安装方式。
  2. 运行官方 setup / model 向导时,选择自定义 / OpenAI-compatible Provider。
  3. API Base 使用 https://api.ppapi.pro/,模型名使用页面当前选择,SK 只在本机配置。
Hermes 安装与配置模板
# Hermes 安装方式待官方确认,请访问官方 Docs/GitHub
hermes setup
hermes model
hermes doctor

MODEL_PROVIDER=custom
API_BASE=<YOUR_API_BASE>
API_KEY=<YOUR_SK_OR_API_KEY>
MODEL=<YOUR_CHAT_MODEL>
CLIENT_SECRET=<YOUR_CLIENT_SECRET>
发布建议:这里默认复制占位符模板;“我的配置”按钮只在浏览器本地临时生成,不会上传或保存 SK。

本地记录