快速结论:这个需求场景是 Open WebUI 中“Chat History”内置工具类别(search_chats、view_chat)缺少实例级总开关和 RBAC 权限控制,导致管理员无法集中禁止模型读取用户对话历史。优先排查当前版本中是否存在 `ENABLE_CHAT_HISTORY` 环境变量或 `features.chat_history` 权限配置项。
适用环境:Open WebUI(GitHub 仓库 open-webui/open-webui),涉及通过环境变量或 RBAC 管理内置工具类别的部署场景。
最快修复方案:暂无确认的一步修复方案。Issue 中提出的环境变量和权限方案属于功能建议,尚未在代码中实现。
注意事项:这是功能请求(Feature Request),不是 Bug 报告。目前唯一的替代方案是手动在“Workspace → Models → Edit → Builtin Tools”中逐个取消勾选“Chat History”类别,且新建模型时会默认开启,无法集中审计与强制。
问题场景
管理员在配置 Open WebUI 内置工具(Builtin Tools)时发现,“Chat History”类别(包含 search_chats、view_chat 两个工具)缺乏与其他敏感数据类别(如 Memory、Notes、Web Search、Image Generation 等)同等级别的全局禁用开关和 RBAC 权限控制。对于有合规或数据治理要求的组织,需要确保模型永远不能搜索或读取用户的对话历史,但当前只能在每个模型上手动取消勾选,无法集中执行和审计。
报错原文
feat: request chat history to be disabled
The "Chat History" Builtin Tools category (search_chats, view_chat) has no instance-wide way to disable it.
Every other Builtin Tools category that touches personal or sensitive data has a global kill switch and/or an RBAC permission.
Chat History has neither. The only control point is the per-model "Chat History" checkbox in Workspace → Models → Edit → Builtin Tools, which:
- defaults to on for every new model,
- has no corresponding features.* permission to restrict it by user/group,
- and has no environment variable to disable it instance-wide.
原因分析
可能原因:Open WebUI 的内置工具类别中,“Chat History”是一个功能缺口——其他所有涉及个人或敏感数据的类别都同时具备环境变量总开关(如 ENABLE_MEMORIES、ENABLE_NOTES)和 RBAC 权限(如 features.memories、features.notes),唯独 Chat History 没有对应的两层控制机制。因此管理员只能依赖模型编辑界面中的复选框,而该复选框默认为开启状态且无法通过用户/用户组进行权限限制。
环境排查
- 确认 Open WebUI 当前部署版本是否已引入
ENABLE_CHAT_HISTORY环境变量(Issue 提出时不存在,建议升级到最新版本后检查)。 - 检查环境变量参考文档中是否存在
ENABLE_CHAT_HISTORY或类似配置项。 - 确认管理面板的“用户权限”(USER_PERMISSIONS_FEATURES_* 模式)中是否新增了
features.chat_history配置。 - 如果使用 Docker 部署,检查
docker-compose.yml或启动命令中的环境变量列表。
解决步骤
- 升级 Open WebUI 到最新版本,并检查官方环境变量参考文档是否新增了
ENABLE_CHAT_HISTORY(默认值应为True)或features.chat_history权限项。 - 如果尚未实现,可暂时采用手动方案:进入“Workspace → Models → Edit → Builtin Tools”,在每个模型上取消勾选“Chat History”类别。
- 为避免新建模型时默认开启,建议保留一个模板模型,每次创建新模型时复制该模板并手动检查“Chat History”是否处于关闭状态。
- 如需全局限用,可考虑在反向代理层(如 Nginx)或应用防火墙中拦截对
/api/chat等接口的search_chats、view_chat工具调用(此方案未经 Issue 验证,仅作替代思路)。 - 若升级后仍未实现该功能,可订阅或关注该 Issue 的进展,或考虑在社区提交 PR 实现
ENABLE_CHAT_HISTORY环境变量与features.chat_history权限。
验证方法
确认问题是否解决的标准:设置 ENABLE_CHAT_HISTORY=False(如果可用)后,所有模型的内置工具列表中应不再出现 search_chats 和 view_chat;或设置 features.chat_history 权限后,被限制的用户/用户组无法在模型上启用该类别。若属于功能未实现,则验证方式为在官方更新日志中确认该功能已合并。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。
![[Question]: How to deal with the situation that the user_id returned in the Conversation table in the database is null?](https://www.chat-gpts.plus/wp-content/uploads/2026/08/7940-bcfd3c79-768x403.jpg)
![[Question]: dependency failed to start: container ragflow-mysql is unhealthy](https://www.chat-gpts.plus/wp-content/uploads/2026/08/7501-3cad0829-768x403.jpg)
