LobeChat

• 官方主页：lobehub.com
• 安装 / 自托管文档：Build Your Own LobeHub
• 模型服务商环境变量：Model Service Providers
• GitHub：github.com/lobehub/lobe-chat
• 协议类型：OpenAI 兼容（经内置 OpenAI 服务商接入 TokenBay）

安装

LobeChat 提供多种使用方式，按需任选其一，对接 TokenBay 的步骤一致。其余以官方文档为准。

方式 1：托管云端（免部署）

直接访问 lobehub.com 注册使用，运行时在 UI 内填入 Key 即可，无需任何安装。

方式 2：桌面客户端

从官方下载页获取 macOS / Windows / Linux 安装包，凭证在应用内 设置 中填写。

方式 3：Docker 自托管（社区版，单机轻量）

docker run -d \
  -p 3210:3210 \
  -e OPENAI_API_KEY=sk-xxxxxx \
  -e OPENAI_PROXY_URL=https://api.tokenbay.com/v1 \
  -e ACCESS_CODE=your-access-code \
  --name lobe-chat \
  lobehub/lobe-chat

需要多用户、登录态、文件存储等能力时，使用数据库版部署（镜像 lobehub/lobe-chat-database，需额外配置 Postgres）。

版本校验

• 自托管：docker exec lobe-chat node -e "console.log(require('/app/package.json').version)"，或在浏览器打开 http://<host>:3210 后于 设置 → 关于 查看版本。
• 桌面 / 托管版：在 设置 → 关于 查看版本号；遇到问题先升级到最新版。

对接 TokenBay

对接机制

LobeChat 内置 OpenAI 服务商，本身就走 OpenAI 兼容协议。对接 TokenBay 的核心是把该服务商的 API 代理地址 指向 TokenBay 网关、并填入 TokenBay 的 API Key。凭证以 Authorization: Bearer <key> 头随请求发送，由 LobeChat 自动处理。两条配置路径：

• 自托管：用环境变量 OPENAI_API_KEY + OPENAI_PROXY_URL 预置（详见下文）。
• 托管版 / 桌面版 / 运行时切换：在 UI 内 设置 → AI 服务商 → OpenAI 面板填写。

Base URL 拼接规则（务必看）：LobeChat 的 OpenAI 服务商默认地址是 https://api.openai.com/v1，请求时会在其后拼 /chat/completions。因此 OPENAI_PROXY_URL / API 代理地址建议填到 带 /v1 的形式：https://api.tokenbay.com/v1，不要带结尾斜杠、不要带 /chat/completions。

• TokenBay 网关根域名是 https://api.tokenbay.com，OpenAI 端点为 /v1/chat/completions；这里因为 LobeChat 只补 /chat/completions，所以需要你把 /v1 一并写进代理地址。
• 官方提示：若测试时返回空消息，多半是代理地址少了 /v1，补上即可（参见官方模型服务商环境变量说明）。

1. 获取 API Key

登录 TokenBay 控制台 → API 密钥 → 创建密钥。复制以 sk- 开头的完整字符串。明文仅显示一次，离开页面后无法再查看。

2. 配置环境变量（自托管）

在 docker run 的 -e 参数或 docker-compose.yml 的 environment 中设置：

docker-compose.yml 片段示例：

services:
  lobe-chat:
    image: lobehub/lobe-chat
    ports:
      - "3210:3210"
    environment:
      OPENAI_API_KEY: sk-xxxxxx
      OPENAI_PROXY_URL: https://api.tokenbay.com/v1
      ACCESS_CODE: your-access-code
      OPENAI_MODEL_LIST: "-all,+gpt-5.5,+claude-sonnet-4.6,+gemini-2.5-pro"

生效方式：修改环境变量后重建容器（docker compose up -d 或重新 docker run）才会生效；改宿主机 shell 变量对已运行容器无效。

3. 备选：UI 内配置（托管版 / 桌面版 / 运行时）

进入 设置（左下角头像）→ AI 服务商 → OpenAI，打开该服务商开关，然后填写：

优先级：UI 内填写的配置存于数据库 / 本地，优先级高于环境变量。自托管若同时设了环境变量又在 UI 改过，以 UI 内最后一次保存为准；排查时建议在 UI 重新填一遍最稳妥。

4. 推荐模型

模型 ID 直接透传上游，无前缀。完整可用列表见 模型清单 或 控制台 Models 页面。

模型名格式：TokenBay 的模型名称中版本号仅接受小数点形式（如 claude-sonnet-4.6、gpt-5.5），不要写成连字符形式（claude-sonnet-4-6、gpt-5-5）。

上表为示例；接入前请到控制台核对准确的 Model ID，并确认 API Key 所属分组已授权该模型（未启用的模型需在控制台分组设置中授权）。

5. 进阶配置

OPENAI_MODEL_LIST 用 + 添加、- 隐藏、model_id=显示名 改名，逗号分隔；-all 先清空内置列表，只保留你显式启用的模型。还可用 <maxToken:能力> 声明扩展能力——尖括号内第一项必须是 maxToken（最大上下文），其后可叠加能力标记（如 vision 视觉、fc 函数调用、reasoning 推理、search、file、imageOutput），冒号分隔；语法以官方模型列表语法为准。

完整 docker-compose.yml 示例（含模型清单与显示名、视觉能力标注）：

services:
  lobe-chat:
    image: lobehub/lobe-chat
    ports:
      - "3210:3210"
    environment:
      OPENAI_API_KEY: sk-xxxxxx
      OPENAI_PROXY_URL: https://api.tokenbay.com/v1
      ACCESS_CODE: your-access-code
      OPENAI_MODEL_LIST: "-all,+gpt-5.5,+claude-sonnet-4.6,+claude-opus-4.8,+gemini-2.5-pro=Gemini 2.5 Pro<1000000:vision:fc>"

LobeChat 的 OpenAI 服务商未提供独立的请求超时环境变量。长任务出现中断时，优先排查网络 / 代理连通性与上游模型并发限制。