XylemNode

接入指南

Open WebUI

自托管的 ChatGPT 式 Web 界面，可多人使用、集中管理多个模型连接。它按 OpenAI 协议对接后端，把 XylemNode 当作一个 OpenAI 连接加进去即可。

获取 API Key
官网 / 下载
  1. 01

    部署并打开

    官方首推 Docker。拉取并运行镜像后，浏览器打开 http://localhost:3000，首次进入按提示创建管理员账号。也支持 pip、Kubernetes 等方式。

    # 拉取镜像
docker pull ghcr.io/open-webui/open-webui:main

# 运行（UI 映射到本机 3000 端口）
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main
  2. 02

    新增 OpenAI 连接

    进入 ⚙️ Admin Settings → Connections → OpenAI，点 ➕ Add Connection。Open WebUI 把所有走 OpenAI 协议的服务都归为 OpenAI 类型，XylemNode 也用这个。

  3. 03

    填地址与密钥

    填 XylemNode 的地址（带 /v1）和密钥后保存。它会调 /v1/models 自动带出可选模型。

    URL
    https://api.xylemnode.com/v1
    API Key
    sk-你的密钥
  4. 04

    选模型开始聊天

    保存后回到聊天界面，在顶部模型菜单里选 XylemNode 的模型（如 gpt-5.6-sol）即可开聊。

两点说明

① 加连接时 Open WebUI 会用 Bearer 调 /models 校验；若个别服务的 /models 差异导致报 400/401/403，并不代表不能用——把模型名手动加进该连接的 Model IDs (Filter) 白名单再保存即可。 ② 也可在部署时用环境变量 OPENAI_API_BASE_URLS、OPENAI_API_KEYS 预置；但环境变量通常只在首次启动写库，之后要改建议直接在 UI 的 Connections 里操作，以免被旧值锁住。

常见问题

Open WebUI 里连接建好了，模型菜单却看不到模型？

先分清是「没拉到」还是「没权限」。管理员自己也看不到，属于前者：保存连接时它会用 Bearer 调 /models，拉不回列表就没有可选项——官方快速上手的建议是把模型名手动加进该连接的 Model IDs (Filter) 白名单。管理员能看到、普通成员看不到，属于后者：Open WebUI 的模型受访问控制约束，去 管理员设置 → 用户 → 群组 里把默认权限中的模型访问打开，或在具体模型上给对应群组授权；社区里「非管理员的模型列表是空的」基本都是这么解决的。多人共用一个 XylemNode 密钥时，这一步往往就是漏掉的那步。