Open WebUI 0.13.4 调整 Tether 沙箱与本地 MCP 连接,常见异常怎么排查绕行
Open WebUI 0.13.4 用 Tether 取代 Direct Connections,并调整沙箱终端、本地 MCP 工具与编码代理的接入方式。版本不匹配、工具服务器开关未开、模型 ID 冲突或沙箱无法强制执行时,功能会表现为连接失败或入口消失,本文整理排查顺序。
0.13.4 用 Tether 取代直连,终端与 MCP 需对齐版本
Open WebUI 0.13.4 不是纯修复版本,但沙箱终端、MCP 工具与编码代理的行为调整会表现为连接或启动异常。 官方把这一版的重心放在 Tether 上。
沙箱无法启用时终端停止
Tether 0.1.13 起可以把终端锁进沙箱,只允许访问你选定的一个文件夹;无法强制执行沙箱时,终端会保持停止而不是静默运行。开启期间浏览器与桌面控制也会关闭,这容易被误认为功能失效。(来源:Open WebUI 官方发布说明)
本地 MCP 与端口
Open WebUI 可以通过 Tether 0.1.16 直接启动以 stdio 运行的本地 MCP 服务器,不需要 mcpo 代理,也不用开放端口。本地命令以你自己的账号权限运行,位于 Tether 工作区沙箱之外。
模型与工具列表不可见
Tether 需要 0.1.14 以上,MCP 服务器、工具服务器与终端需要 0.1.16;工具服务器还要打开 ENABLE TOOL SERVERS。与 Open WebUI 已有模型 ID 相同的 Tether 模型会保持隐藏,从官方描述看,这也是模型选择器里看不到条目的常见原因。
Direct Connections 退场,编码代理与终端共享改版
用本地模型、自建 MCP 或编码代理的用户需要重新检查版本与开关,普通聊天感知较小。 直接连接被 Tether 取代。
Direct Connections 退场
Tether 取代 Direct Connections。原来通过直接连接接入的 Ollama、LM Studio 或 OpenAI 兼容服务,需要迁移到 Tether 才能在模型选择器里出现。
编码代理与推理档位
Hermes、Antigravity、GitHub Copilot、Goose 与 Qwen Code 加入代理列表;选择模型不支持的推理档位时,代理会直接报错停止。把档位调回模型支持的范围即可恢复。
终端与共享
Terminals 0.4.0 起可以按用户、会话或模型分配沙箱计算机;启动与停止需要 0.4.1,起始目录与安装脚本需要镜像内的 Open Terminal 0.17.7 以上。页面、笔记、频道与自动化也可以以标签页形式打开,新聊天会保留已打开的标签。
依赖本地 MCP 的用户需把 Tether 升到 0.1.16
依赖本地 MCP、沙箱终端或编码代理的用户建议升级,但要把 Tether 版本一起对齐。 只用云端模型聊天的可以按计划跟进。
谁适合先升级
使用 Tether、接入本地 MCP 工具或在 Open WebUI 里跑编码代理的用户优先;仍在使用 Direct Connections 的团队需要安排迁移。
升级方式
升级 Open WebUI 到 v0.13.4 的同时,把 Tether 升到 0.1.16 以上、Terminals 升到 0.4.1 以上,并按需启用工具服务器。具体安装命令官方未披露。
出问题怎么排查
工具不显示时先核对 Tether 版本、ENABLE TOOL SERVERS 与模型 ID 冲突;终端不启动时检查沙箱能否强制执行;代理报错时降低推理档位。同类客户端异常也可以参考 Claude Code 2.1.327 修复 /export 覆盖文件与 MCP 配置被清空的异常问题。
常见问题
- Open WebUI 0.13.4 为什么模型选择器里看不到 Tether 模型?
- Tether 版本需要 0.1.14 以上,且与已有模型 ID 相同的 Tether 模型会保持隐藏。
- Open WebUI 0.13.4 的本地 MCP 工具需要什么条件?
- 需要 Tether 0.1.16 以上,并打开 ENABLE TOOL SERVERS,工具服务器与终端才能显示。
- Open WebUI 0.13.4 的沙箱终端为什么不启动?
- 沙箱无法强制执行时,终端会保持停止而不是静默运行,这是本版的设计。
- Open WebUI 0.13.4 还能用 Direct Connections 吗?
- Tether 取代了 Direct Connections,原来的直连需要迁移到 Tether。
相关术语
- Tether
- Tether 是 Open WebUI 的本地计算接入组件,把本机模型、工具与终端安全地暴露给网页端。
- MCP
- MCP 是模型上下文协议,用统一方式向模型提供工具与数据源。
- 沙箱终端
- 沙箱终端是限制在单一目录内运行的终端,模型与编码代理只能访问指定文件夹。
- Direct Connections
- Direct Connections 是 Open WebUI 旧版的直连方式,本版由 Tether 取代。
这篇文章的来源是什么?
文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。
- v0.13.4 · Open WebUI · 2026-11-18
「v0.13.4」 —— Open WebUI
文章目录