LobeChat 是开源的 AI 聊天框架，有桌面版（下载即用）和自部署版（Docker / Vercel）。界面漂亮、插件和助手生态丰富。

先选：桌面版还是自部署？

	桌面版	自部署版
上手难度	下载安装，图形界面配	要会 Docker 或部署到 Vercel
配置方式	界面里填	环境变量
适合	大多数人	团队共用、要统一管理

下面的配置两种方式都写了。

桌面版：在界面里配

1. 打开 LobeChat，进入 设置 → AI 服务商。
2. 在服务商列表里找到 OpenAI。
3. 填写两项：

填什么	填成什么
API Key	sk-你的APIKey
接口代理地址	https://api.wxiai.com/v1

4. 打开这个服务商的启用开关。
5. 在模型列表里添加模型 ID，比如 grok-4.6。

界面路径可能随版本变化

LobeChat 更新比较快，菜单位置偶尔会调整。找 「AI 服务商」/「模型服务商」 这一项就对了。

自部署版：用环境变量

在 docker-compose.yml 或部署平台的环境变量里加：

environment:
  - OPENAI_API_KEY=sk-你的APIKey
  - OPENAI_PROXY_URL=https://api.wxiai.com/v1

Docker 命令行的写法：

docker run -d -p 3210:3210 \
  -e OPENAI_API_KEY=sk-你的APIKey \
  -e OPENAI_PROXY_URL=https://api.wxiai.com/v1 \
  -e ACCESS_CODE=你的访问密码 \
  lobehub/lobe-chat

OPENAI_PROXY_URL 要不要带 /v1？

官方文档明确说这取决于你的服务商，而且给了明确指引：

有些代理服务商在请求后缀里带 /v1，有些不带。如果你发现测试时 AI 返回空消息，试着加上 /v1 再试一次。

对我们来说：要带 /v1，也就是 https://api.wxiai.com/v1。

判断方法见 Base URL 怎么填。

⚠️ 最典型的症状：AI 回复空白

如果你配完发消息，AI 有反应但内容是空的——这几乎一定是 Base URL 的 /v1 问题，不是模型坏了。

先改成 https://api.wxiai.com/v1 再试。 这是 LobeChat 官方文档专门点出来的坑。

用 curl 验证地址本身没问题：

curl https://api.wxiai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-4.6","messages":[{"role":"user","content":"回复：接通了"}]}'

这条通了但 LobeChat 空白 → 就是 /v1 拼接的问题。

控制模型列表（自部署）

LobeChat 默认会显示一堆 OpenAI 模型名，很多是我们没有的。用 OPENAI_MODEL_LIST 控制：

# 先禁用全部，只启用我们有的模型
-e OPENAI_MODEL_LIST="-all,+grok-4.6"

语法规则：

写法	作用
+模型名	添加一个模型
-模型名	隐藏一个模型
-all	先禁用全部
模型名=显示名	改显示名，如 grok-4.6=Grok 4.6

多个用英文逗号分隔：

-e OPENAI_MODEL_LIST="-all,+grok-4.6,+grok-4.5"

桌面版在 设置 → AI 服务商 → 模型列表 里手动增删即可。

常见报错

现象	原因	怎么办
AI 回复空白	Base URL 的 /v1 不对	改成 https://api.wxiai.com/v1
401	Key 无效	重新复制；确认没带空格
模型列表里一堆用不了的模型	默认展示 OpenAI 全量模型	用 OPENAI_MODEL_LIST 限定
model_not_found	模型 ID 不对	用 GET /v1/models 返回的名字
助手/插件报错	部分插件需要特定模型能力	换一个模型试，或关掉该插件

相关页

• Base URL 怎么填 —— 各工具填法对照
• 对话补全 —— LobeChat 用的就是这个接口
• Cherry Studio / 其他客户端