如何在 Mac 上卸载 Open WebUI
移除 Open WebUI Desktop 前,先导出需要的聊天,官方聊天导出说明使用 Settings › Data Controls › Export Chats,服务器备份还可能需要上传文件和其他数据,本页覆盖官网 Mac 桌面应用,不包括独立安装的 Docker 或 Python 服务器。
先退出,再移除应用
先核对聊天导出文件,结束桌面应用中的任务,再按 Cmd + Q 退出 Open WebUI,剩余辅助进程先核对是否来自桌面应用,再把 Open WebUI.app 移进废纸篓,不要只因名称相同就停止或删除独立服务器。
核对桌面数据
核对聊天导出并退出后,在 Finder 按 Shift + Command + G 分别打开 ~/Library/Application Support/open-webui 和 ~/Library/Preferences/com.openwebui.desktop.plist,先把要留的本地状态复制到支持目录之外,再把决定删除的桌面文件夹或偏好设置文件移到废纸篓,不存在的跳过,独立服务器的数据、上传文件和模型留着。
~/Library/Application Support/open-webui是本机测试和 cask 记录的 Mac 桌面数据目录,核对父目录前,先保留需要的配置或本地状态。- 其中的 Electron 缓存子目录,包括
Cache、Code Cache和GPUCache,与父目录数据分开列出。 ~/Library/Preferences/com.openwebui.desktop.plist保存桌面偏好设置。- 所连接的服务器可以单独保存聊天、上传文件和知识内容,官方备份说明区分了持久化服务器存储与 Ollama 模型卷,移除桌面目录不等于备份或删除这些内容。
检查卸载结果
pgrep -ifl "Open WebUI|open-webui"
ls -ld "/Applications/Open WebUI.app" "$HOME/Library/Application Support/open-webui" "$HOME/Library/Preferences/com.openwebui.desktop.plist"
pgrep 没有输出只表示没有找到这个名称,不代表所有辅助进程都已退出,有输出时核对它的实际可执行文件路径,ls 提示路径不存在只说明这一处没有了,权限错误仍无法判断,留下的文件夹也可能是你要保留的数据。
用 Homebrew 安装时
Mac cask 没有单独的卸载辅助程序,Mac 的 zap 目标是 ~/Library/Application Support/open-webui,包含桌面数据,~/.config/open-webui 那段适用于 Linux,不适用于本页的 Mac 卸载。
不运行 zap 时,用下面的命令卸载:
brew uninstall --cask open-webui
Mole 会先核对 Homebrew 的整份删除清单,涉及未勾选的数据、共享文件或无法确认的内容时跳过 --zap,已勾选的残留仍由 Mole 清理。自行运行 brew uninstall --cask --zap open-webui 会执行 Homebrew 的完整 zap 清单,不会读取 Mole 的勾选状态。
所连接的服务
移除桌面应用不会删除远端账户、取消供应商计费或移除独立托管的服务器数据,各个服务单独处理。
Mole 会列出什么
Mole 默认勾选应用、精确桌面偏好设置和可归属的 Electron 缓存,~/Library/Application Support/open-webui 会列出来供你检查,「卸载时一并移除数据和配置」关闭时不预选,开启后符合条件的自有数据可以预选,想留本地状态就检查并取消勾选,精确归属于应用的最近文档清单单文件可以列出并勾选,共享父目录和其他 Apple 系统状态仍受保护。
这次检查覆盖了什么
2026 年 9 月 25 日,从官网 Mac 包拷出的 Open WebUI Desktop 0.0.20 用 Mole 开发构建测试,记录中勾选的数据移除后,观察窗口内没有可归属的残留,没有验证已有聊天恢复,也没有验证远端服务器、Docker 卷或模型库的移除。
