快速结论:该报错发生在 Open WebUI 最新 dev 版本中,点击 Open Terminal 的 “Copy Path” 按钮后浏览器控制台报错 `navigator.clipboard` 未定义,且剪贴板无内容。优先排查是否通过非 HTTPS(如局域网 HTTP)访问界面,因为 Clipboard API 仅在安全上下文(HTTPS 或 localhost)下可用。
适用环境:Open WebUI dev-slim 版本(2026-08-25T06:22:29.419435095Z)、Docker 安装方式、Pop!_OS 22.04、Chrome 浏览器最新版;Open Terminal 版本 0.12.1。
最快修复方案:暂无确认的一步修复方案。Issue 讨论中确认通过 localhost 访问可以正常复制,可优先尝试改用 localhost 或在 Open WebUI 前配置 TLS 反向代理。
注意事项:该方案只是绕过问题,并未修复 dev 版本底层代码逻辑;需要在非 localhost 环境使用剪贴板功能时,仍需等待官方合入 `document.execCommand(‘copy’)` 回退逻辑。
问题场景
用户在 Open WebUI 最新 dev 版本中打开 Open Terminal 0.12.1,点击任意文件或文件夹的 “Copy Path” 按钮时,界面无任何错误提示,但剪贴板中没有任何内容。浏览器 DevTools 控制台出现 JavaScript 报错。
报错原文
issue: Copy path in open-terminal fails on latest dev
navigator.clipboard is undefined in FileEntryRow.svelte
原因分析
可能原因:Open WebUI 的 “Copy Path” 功能调用了浏览器 Clipboard API(navigator.clipboard),但该 API 只在安全上下文(HTTPS 或 localhost)中可用。当用户通过局域网 HTTP 地址访问 Open WebUI 时,navigator.clipboard 为 undefined,导致复制操作静默失败。Issue 评论中确认改用 localhost 访问后功能正常;同时指出代码块复制功能在 HTTP 下仍可用,说明其可能使用了不同的复制实现方式(如 document.execCommand('copy'))。
环境排查
- 确认 Open WebUI 访问地址是否为
http://<局域网IP>:<端口>而非https://或http://localhost - 检查浏览器控制台是否报错
navigator.clipboard is undefined - 确认是否使用 Open WebUI dev-slim 版本(2026-08-25T06:22:29.419435095Z)
- 确认 Open Terminal 版本是否为 0.12.1
解决步骤
- 将浏览器访问地址从
http://<IP>:<端口>改为http://localhost:<端口>,再点击 “Copy Path” 验证是否恢复正常(Issue 评论中已验证此方法有效)。 - 如果必须在局域网内使用,可优先尝试在 Open WebUI 前配置 TLS 反向代理(如 Nginx、Caddy),使其通过 HTTPS 访问。
- 如需彻底修复 dev 版本的功能,可在官方 Issue 中跟踪进展,等待合入
document.execCommand('copy')回退逻辑(讨论中提到的可能修复方案,尚未验证)。
验证方法
点击 “Copy Path” 后,在任意文本编辑器中粘贴(Ctrl+V),确认剪贴板中是否有文件路径内容;同时检查浏览器控制台是否不再出现 navigator.clipboard is undefined 报错。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


