跳到主要内容

记忆与个性化 🧠

实验性功能

Memory（记忆）系统目前处于 Beta/实验性 阶段。你可能会在模型存储或检索信息时遇到不一致的情况，且存储格式在未来的更新中可能会发生变化。

Open WebUI 包含一个先进的 Memory 系统，允许模型在不同的对话中记住事实、偏好和上下文。 随着 原生工具调用 (Native Tool Calling) 的引入，该系统已从被动的注入机制升级为主动的、由模型管理的“长期记忆”。

工作原理​

Memory 系统存储了关于你的信息片段（例如，“我更倾向于使用 Python 进行后端任务”或“我住在维也纳”）。这些 Memory 有两种使用方式：

1. 手动管理（设置）​

用户可以通过导航到以下路径来手动添加、编辑或删除 Memory： 设置 > 个性化 > 记忆 (Settings > Personalization > Memory)

2. 原生记忆工具（Agent 模式）​

当使用启用了 原生函数调用 (Native Function Calling / Agent 模式) 的模型时，高质量的模型可以使用五个内置工具自主管理你的 Memory。有关管理员如何配置和管理这些系统级工具的详细说明，请参阅 核心工具调用指南。

用于 Memory 管理的高质量模型

自主 Memory 管理在使用前沿模型（如 GPT-5、Claude 4.5+、Gemini 3+）时效果最佳，这些模型可以智能地决定哪些事实值得保存，以及何时检索相关的 Memory。小型本地模型可能难以进行适当的 Memory 选择。

  • add_memory：允许模型在对话过程中主动保存其了解到的关于你的新事实。
  • search_memories：允许模型在你的 Memory 库中搜索相关的上下文。结果包含每个 Memory 片段的唯一 id。模型可以选择指定要返回的 Memory 数量（默认为 5）。
  • replace_memory_content：允许模型使用其 id 来更新或纠正特定的现有 Memory。
  • delete_memory：允许模型使用其 id 删除不再相关或不正确的 Memory。
  • list_memories：允许模型检索用户的全部已存储 Memory，包括内容 and 时间戳。

新记忆系统的优势​

  • 主动学习：模型不需要你手动输入偏好，而是可以说：“我会记住你在 UI 项目中更倾向于使用暗黑模式”，并在后台调用 add_memory。
  • 上下文检索：如果对话漂移到几个月前提到的话题，模型可以使用 search_memories “搜索它的大脑”来找到过去的这些细节。
  • 动态修正：如果模型记错了某些内容，它可以使用 replace_memory_content 来修复该事实，而不是创建重复项。
  • 清理：模型可以使用 delete_memory 来删除过时或无关的事实，保持你的 Memory 库整洁。
  • 完全可视：通过使用 list_memories，模型可以审查它所知道的关于你的一切，并识别出空白或矛盾之处。
  • 用户控制：尽管模型可以添加 Memory，但用户仍保留完全的控制权。模型添加的每一条 Memory 都可以由用户在“个性化”设置中进行审查和删除。

启用记忆工具​

  1. 管理员启用：确保 Memory 功能已被管理员全局启用，并且你拥有所需的权限。
  2. 原生模式（Agent 模式）：在模型的通用参数中启用 原生函数调用 (Native Function Calling)（管理员面板 > 设置 > 模型 > 模型特定设置 > 高级参数 (Admin Panel > Settings > Models > Model Specific Settings > Advanced Parameters)）。
  3. 需要高质量模型：为了有效地解锁这些功能，请使用具有强大推理能力的前沿模型（例如 GPT-5、Claude 4.5 Sonnet、Gemini 3 Flash、MiniMax M2.5）以获得最佳体验。小型本地模型可能无法有效地自主管理 Memory。
  4. 按模型类别切换：确保在 工作区 > 模型 > 编辑 > 内置工具 (Workspace > Models > Edit > Builtin Tools) 中为模型启用了 Memory 类别（默认启用）。
核心工具文档

有关所有内置 Agent 工具（包括 Memory、Web 搜索和 Knowledge Base 知识库）以及如何配置它们的完整详细信息，请参阅 原生/Agent 模式工具指南。

管理员控制​

管理员对 Memory 功能拥有完全的控制权，包括全局禁用它或限制特定用户群组的使用。

全局开关​

可以为整个实例开启或关闭 Memory 功能。禁用时，所有用户的“个性化”选项卡将被隐藏，且与 Memory 相关的 API 端点将被阻止。

  • 管理员 UI：管理员面板 > 设置 > 常规 > 功能 > Memory (Admin Panel > Settings > General > Features > Memories)
  • 环境变量：ENABLE_MEMORIES（默认：True）

细粒度权限​

管理员还可以在“权限”界面中，基于角色或群组来控制 Memory 访问权限。

  • 管理员 UI：管理员面板 > 用户 > 权限 > 功能 > Memory (Admin Panel > Users > Permissions > Features > Memories)
  • 环境变量：USER_PERMISSIONS_FEATURES_MEMORIES（默认：True）

隐私与安全​

Memory 本地存储在你的 Open WebUI 数据库中，并绑定到你的用户账户。默认情况下，它们不会与其他用户共享，你也可以随时清空你的整个 Memory 库。

This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.