Open WebUI 是自托管的 AI 聊天界面，适合团队共用——一个人配好，全公司都能用。支持多用户、知识库、模型管理。

这是「自部署」软件，不是下载即用

和 Cherry Studio、Chatbox 不同，Open WebUI 需要你自己用 Docker 跑起来。如果不熟悉 Docker，建议先用 Cherry Studio 或 Chatbox。

⚠️ 配置入口在「管理员设置」里，不在普通设置里

这是新手最容易卡住的地方：Open WebUI 有两层设置。

层	位置	管什么
用户设置	右上角头像 → Settings	自己的偏好
管理员设置	右上角头像 → Admin Settings	API 连接、模型、用户

模型连接配在「Admin Settings」里。 找不到的话，说明你当前账号不是管理员。

配置步骤

1. 打开 Open WebUI，点右上角头像 → Admin Settings。
2. 左侧选 Connections（连接）。
3. 在 Manage OpenAI API Connections 区域点 ➕ 添加连接。
4. 填两项：

填什么	填成什么
URL	https://api.wxiai.com/v1
API Key	sk-你的APIKey

5. 点 Save（保存）。
6. 确认这个连接右侧的开关是打开的。

URL 要带 /v1，且不要有末尾斜杠

	填写内容
正确	https://api.wxiai.com/v1
错误	https://api.wxiai.com/v1/（末尾多斜杠，可能拼出 v1//models 报 404）
错误	https://api.wxiai.com（少了 /v1）

Open WebUI 会在你填的地址后面拼 /models、/chat/completions。所以填到 /v1 为止，不要填完整端点。

判断方法见 Base URL 怎么填。

模型不显示怎么办

Open WebUI 保存连接时会自动去调 /models 拉模型列表——我们支持这个端点，正常情况下模型会自动出现。

如果没出现，有两个原因：

原因一：自动检测失败了

到连接的设置里找 Model IDs (Filter) 这一项，手动输入模型 ID 再点 + 加进去：

grok-4.6

加完保存，模型就会出现在模型选择器里。

注意：即使连接验证报错，聊天功能通常仍然是好的——验证失败只说明模型列表没拉到，不代表接口不通。别被这个红字吓到。

原因二：模型 ID 写错了

模型名以 GET /v1/models 的返回为准，不要凭记忆写：

curl https://api.wxiai.com/v1/models \
  -H "Authorization: Bearer sk-你的APIKey"

Docker 部署的两个注意点

1. 如果 Open WebUI 跑在 Docker 里

要连本机上的服务，localhost 指向的是容器自己，不是你的电脑。要用：

http://host.docker.internal:端口

（连我们这种公网地址不受影响，直接填 https://api.wxiai.com/v1 即可。）

2. 模型列表拉取超时

网络慢的时候可能拉不到模型列表，默认超时 10 秒。可以用环境变量放宽：

-e AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST=30

常见报错

现象	原因	怎么办
找不到 API 连接设置	你不是管理员账号	用管理员账号登录，或在 Admin Settings → Users 里提权
连接验证失败	模型列表没拉到	手动加模型 ID 到 Model IDs (Filter)；聊天通常仍可用
404 / v1//models	URL 末尾多了斜杠	去掉末尾斜杠
401	Key 无效	重新复制，注意别带空格
添加模型时提示 Model ID is already added	重复添加	不用管，已经在列表里了
聊天报模型不存在	模型 ID 不对	用 GET /v1/models 查真实名字

多用户场景建议

Open WebUI 的多用户能力是它的主要优势，可以这样用：

• API Key 只配在管理员侧，普通用户完全接触不到你的 Key——每个人的用量都走同一把 Key 计费。
• 用「模型」功能做可见范围控制：只把你确认可用的 Grok 模型暴露给用户，避免他们选到不存在的模型。
• 需要按人算成本的话，Open WebUI 本身不区分，得看我们这边的调用日志。

相关页

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