# 一条连接，让 Open WebUI 背靠整个模型目录

> https://router.one/zh/integrations/open-webui 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 最后更新：2026-08-12

Open WebUI 是部署最广的自托管聊天界面，任何 OpenAI 兼容端点都能作为它的后端。把 Router One 添加为连接后，模型目录会经 /models 端点自动发现——GPT、Claude、Gemini、DeepSeek 系列直接出现在实例所有用户的模型选择器里，每次对话在网关侧都有成本 trace。网关在大陆可直连，实例部署在国内服务器上也无需代理。

## 把 Open WebUI 配置到 Router One base URL

已在运行的实例里，打开 Admin Panel → Settings → Connections，添加一条 OpenAI API 连接，填入网关地址和 Key，模型会自动发现——想收窄用户可见的列表，用连接里的模型 ID 过滤即可。全新的 Docker 部署也可以用两个环境变量在首次启动时写入同一条连接：

`open-webui-connection`

```bash
# Open WebUI → Admin Panel → Settings → Connections → OpenAI API
URL:      https://api.router.one/v1
API Key:  sk-your-router-one-key

# Or seed the connection at first launch:
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.router.one/v1 \
  -e OPENAI_API_KEY=sk-your-router-one-key \
  ghcr.io/open-webui/open-webui:main
```

## Open WebUI 该填哪个模型 ID？

从 /models 页复制精确的模型 ID——ID 区分大小写，页面同时列出每个模型的上下文窗口、能力和当前单价。建议为每个工具单独建一个 API Key，并设置 maxSpend 消费上限，这样单个工具跑飞不会影响其他工作负载。

## 在 trace 里验证 Open WebUI 的调用

发出第一个请求后，到 Dashboard → Logs 查看它的完整 trace：模型、tokens、花费、延迟和状态码。Open WebUI 的每一次调用从此都有账本和轨迹，不再是黑盒。

## 常见问题

### 改了 OPENAI_API_BASE_URL 环境变量，Open WebUI 为什么没反应？

连接设置是持久化配置：Open WebUI 首次启动时就把它写进了数据库，之后再改环境变量会被忽略。请到 Admin Panel → Settings → Connections 里直接改这条连接，或者换一个全新的数据卷重新部署。

### Open WebUI 能通过网关用哪些模型？

目录里任何具备对话能力的模型——GPT、Claude、Gemini、Grok、DeepSeek、GLM、Kimi 等系列。/models 页是模型 ID 与单价的事实来源。

### 中国大陆能直连吗？

能。网关在大陆可直连、无需 VPN，配置与全球环境完全一致。

### 报 401/403/429 怎么排查？

先到 Dashboard → Logs 看请求有没有到达网关以及状态码，再对照错误码速查页逐项检查环境变量、Key 状态和限额。

## 相关页面

- 全部接入指南：https://router.one/zh/integrations
- Open WebUI 的 401/403/429 排查：https://router.one/zh/llm-api-error-codes
- Cline 接入：https://router.one/zh/integrations/cline
- Aider 接入：https://router.one/zh/integrations/aider
- 网关层负责什么：https://router.one/zh/llm-api-gateway
- OpenAI 兼容 API：https://router.one/zh/openai-compatible-api
- API 文档：https://router.one/zh/docs
- 本页规范地址：https://router.one/zh/integrations/open-webui
- 模型与每模型 token 价格：https://router.one/zh/models（markdown：https://router.one/zh/models.md）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md