Luxy 网关 · 接入使用手册

1 ChatGPT Next Web（自托管网页版）

开源网页客户端。自托管时既可以改 .env，也可以直接在设置页填。推荐自托管用户用脚本生成 .env（见第 ⑤ 节）。

1. 打开你自托管的 Next Web，进入右上角 ⚙️ 设置。
2. 「模型服务商」选择 OpenAI。
3. 在 接口地址 / Base URL 填入 https://你的域名/v1。
4. 在 API Key 填入你的子 Key：sk-你的子key（从网关「用户端 → 密钥」创建）。
5. 「自定义模型」建议填 -all，让网关返回的全部模型都可见。
6. 保存后新建对话，挑一个模型（如 gpt-4o）即可开始对话。

自托管 .env 写法（等同效果）

BASE_URL=https://你的域名/v1
OPENAI_API_KEY=sk-你的子key
CUSTOM_MODELS=-all
# 可选：给网页加访问密码
ACCESS_CODE=你的页面密码

2 LobeChat

开源多模型客户端（网页 / 桌面 / Docker 自托管）。支持 OpenAI 兼容的「自定义模型服务商」。

1. 打开 LobeChat，进入 ⚙️ 设置 → 模型服务商。
2. 点击 添加模型服务商，选择 OpenAI（或「自定义 OpenAI 兼容」）。
3. 在 API Proxy URL 填入 https://你的域名/v1。
4. 在 API Key 填入 sk-你的子key。
5. 保存后，在对话界面选择模型即可。需要指定网关特有模型时，在「自定义模型」里填模型名（逗号分隔）。

Docker 自托管 server config.json

{
  "OPENAI_API_KEY": "sk-你的子key",
  "OPENAI_PROXY_URL": "https://你的域名/v1"
}

3 OpenCat / 移动端 App

OpenCat、PalAI 等 iOS / Android 客户端支持「自定义 OpenAI 兼容服务商」。App 配置锁在沙盒内，脚本无法自动写入，需手动填写——但填写项和其他平台完全一致。

1. 打开 App，进入 设置 → 服务商 / Provider。
2. 选择 添加自定义 / Custom OpenAI Compatible。
3. Base URL 填 https://你的域名/v1（注意移动端有时不要 https:// 前缀时按 App 提示填写）。
4. API Key 填 sk-你的子key。
5. 如 App 要求填「模型名」，可填 gpt-4o 等；保存后开始对话。

4 Qclaw / WorkBuddy 内置

WorkBuddy / Qclaw 这类内置 AI 助手，在「设置 → 模型」里添加 OpenAI 兼容自定义端点。

1. 打开客户端，进入 设置 → 模型 / 模型提供商。
2. 选择 添加自定义 → OpenAI 兼容。
3. 接口地址 / Base URL 填 https://你的域名/v1。
4. API Key 填 sk-你的子key。
5. 启用该提供商，新建对话时选择网关模型即可。

# 任意 OpenAI 兼容客户端通用两项
Base URL : https://你的域名/v1
API Key  : sk-你的子key

5 一键配置脚本（自托管客户端）

如果你自己部署了 ChatGPT Next Web 或 LobeChat，下载 setup_aila_config.py 一键生成配置文件，省去手动抄写。

1. 下载脚本 scripts/setup_aila_config.py 到你的部署机器。
2. 运行（交互填地址和 Key，或用参数）：

# 交互式
python setup_aila_config.py

# 或一次性指定（推荐用参数，避免 Key 进 shell 历史可用文件传入）
python setup_aila_config.py --base-url https://你的域名/v1 --key sk-你的子key