LobeChat / LobeHub

在 LobeChat / LobeHub 配置共享服务器凭据或个人 OpenAI 服务商。

安装与准备

自建实例需安装 Docker，并按 LobeHub 当前 Docker 部署文档完成数据库、对象存储和身份认证配置。保留对应版本的 Compose 文件和已有密钥；下方片段只是应用环境变量补充，不是完整部署。打开实例登录，并准备 routerra.ai 密钥及其可用的准确模型 ID。

配置连接

服务器统一供给时，在 Lobe 应用服务设置 OPENAI_API_KEY=YOUR_API_KEY、OPENAI_PROXY_URL=https://routerra.ai/v1 和 OPENAI_MODEL_LIST=-all,+YOUR_MODEL_ID，然后重建服务。-all 隐藏内置模型，+ 添加准确 ID，不会授予网关权限。服务器密钥供实例获准用户使用。若使用个人密钥，打开 Settings → Language Model → OpenAI，启用服务商，填写 API Key 和自定义 API Proxy Address https://routerra.ai/v1，再在模型管理添加并启用准确模型。

OPENAI_API_KEY=YOUR_API_KEY
OPENAI_PROXY_URL=https://routerra.ai/v1
OPENAI_MODEL_LIST=-all,+YOUR_MODEL_ID

选择模型与排查错误

新建对话选择 OpenAI 和 YOUR_MODEL_ID 发送文本。缺少模型通常是服务商或模型未启用，或修改环境变量后未重建应用。个人设置仍指向其他地址时，先修正已保存的代理和密钥。401 时区分实例登录认证与网关密钥。上游错误请查应用容器日志；界面启用视觉或工具并不会赋予模型这些能力。