开始使用 Open WebUI
在不到五分钟的时间里，从零开始开启您的第一次 AI 对话。
Open WebUI 可以运行在任何地方（Docker、Kubernetes、pip 或是裸机），并且开箱即用地连接到 Ollama、OpenAI 兼容的 API 以及 Open Responses 服务商。只需选择一种安装方法，连接您的模型服务商，即可开始进行聊天。
⏱️ 快速安装
安装 Open WebUI，连接模型，开始聊天。
这是一个正常工作环境所需要的一切配置。选择 Docker 以获得最快的部署路径，选择 Python 获得轻量级的安装，或者选择 Kubernetes 满足生产级编排需求。每个指南均包含连接您首个模型服务商的步骤。
| 🐳 Docker | 单条命令部署，官方最推荐的部署路径 |
| 📦 Python (pip / uv) | 适用于低资源环境或手动配置的轻量级安装方法 |
| ☸️ Kubernetes (Helm) | 具备横向扩缩容能力的生产级编排部署 |
| 🖥️ 桌面版 App | 原生客户端程序，不需要 Docker 环境 |
| 🔌 连接服务商 | Ollama、OpenAI、Anthropic、llama.cpp、vLLM 等模型集成 |
| ⚙️ 理解配置项 | 了解管理员设置（Admin Settings）和用户设置（User Settings）是如何协同工作的 |
Open WebUI 必备核心
已完成安装并能进行聊天了，接下来该怎么做？
以下五个精炼章节，涵盖了每位新用户在第一天都希望早点知道的事情：什么是插件（plugins）以及如何安装它们，为什么长对话最终会报错（以及如何用过滤器 filter 来解决它），支撑标题生成和自动补全的“隐形”任务模型（Task Model），如何针对自己的文档进行基础的 RAG 知识检索，以及开启原生工具调用（Native tool calling）。
| 🧩 插件 | Tools、Pipes、Filters、Actions — 平台的核心可 扩展架构 |
| 🧠 上下文管理 | 为什么长对话会遇到瓶颈，以及如何优雅地处理它 |
| 🤖 任务模型 | 让标题生成、打标签和自动补全等任务不占用您的主模型 |
| 📚 基础 RAG | 与您上传的本地文档进行聊天 |
| 🔧 工具调用 | 原生工具调用模式，以及首批推荐安装的 Tools 工具 |
🤖 连接 Agent
超越简单的模型集成。连接一个具备自主能力的 AI Agent。
像 Hermes Agent 和 OpenClaw 这样的 AI Agent 携带了它们自己的工具箱（终端、文件操作、网页搜索、记忆等），并使用 Open WebUI 作为精美的前端聊天界面。Agent 会自主决定何时使用工具、执行它们，并将结果实时流式传输给您。
| 🧠 Hermes Agent | Nous Research 开发的 Agent，具备终端操作、文件管理、网页搜索和技能系统 |
| 🐾 OpenClaw | 自托管 Agent 框架，提供 shell 访问、网页浏览和频道机器人 |
分享 Open WebUI
只需一次部署，即可为整个团队和组织提供 AI 服务。
Open WebUI 不仅仅是一个本地的 AI 交互界面。它被设计为面向团队的中心化 AI 操作系统。只需部署一次，即可享受到简化的人员入伙（onboarding）、协同智能、资源共享以及集中式的安全管控。
| 局域网与隧道 | Tailscale、Cloudflare Tunnels 以及本地 IP 访问方式 |
| 反向代理 | 使用 Nginx、Caddy 或 HAProxy 保护您的实例安全 |
| 团队接入 | 管理员审批流与企业级单点登录 (SSO) 集成 |
| 共享上下文 | 频道（Channels）、共享聊天以及公共知识库（Knowledge bases） |
🛠️ 进阶主题
对您的部署进行扩容、观测和定制。
超越基础应用。配置环境变量、连接外部数据库、添加云存储、启用 OpenTelemetry，或使用 Redis 和多个工作进程（Workers）进行横向扩展。
| ⚖️ 扩展 | 多 Worker、多节点及 Redis 状态共享 |
| 📊 日志与可观测性 | OpenTelemetry 追踪、指标度量以及结构化日志 |
| 🧪 开发环境配置 | 从源码在本地运行以进行二次开发和测试 |
🔄 版本更新
紧跟最新功能，及时修复安全漏洞。
只需一条 Docker 或 pip 命令即可进行手动更新，或者使用 Watchtower、WUD 或 Diun 自动升级。指南包含备份/恢复规程以及生产环境下的版本锁定方法。
| 🔄 手动更新 | 拉取 Docker 新镜像重新建容器，或升级 pip 包 |
| 🤖 自动更新 | 使用 Watchtower、WUD 或 Diun 自动化程序 |
| 📌 版本锁定 | 锁定到特定发布版本以保证稳定性 |
| 💾 备份与恢复 | 一键执行卷备份和系统恢复 |