🤖 连接智能体
将 Open WebUI 用作自主 AI 智能体（Agent）的聊天前端。
AI 智能体比简单的模型提供商更进一步。它们可以执行终端命令、读写文件、搜索网页、管理记忆并链式处理复杂的工作流。由于许多智能体框架都暴露了兼容 OpenAI 的 API，因此 Open WebUI 可以仅需极少配置就为它们提供精致且功能齐全的对话界面。
这与模型提供商有什么不同？
当您连接模型提供商时，您连接的是一个模型。它接收您的消息并返回一个响应。仅此而已。
而当您连接一 个**智能体（Agent）**时，您连接的是一个自主系统，它可以：
- 🖥️ 在您的机器上运行终端命令
- 📁 在您的工作区中读写文件
- 🔍 搜索网页以获取实时信息
- 🧠 在对话之间保持记忆
- 🧩 使用技能和插件来扩展其能力
- 🔗 链式调用多个工具来解决复杂的任务
智能体会根据您的消息决定何时以及如何使用这些工具，而 Open WebUI 会在熟悉的对话界面中显示结果。
可用的智能体（Agent）
| 智能体 | 描述 | 指南 |
|---|---|---|
| Hermes Agent | 由 Nous Research 提供的自主智能体，具有终端、文件操作、网页搜索、记忆和可扩展的技能 | Set up Hermes Agent → |
| OpenClaw | 开源自托管智能体框架，具有 Shell 访问、文件操作、网页浏览和即时通讯渠道集成功能 | Set up OpenClaw → |
工作原理
无论您连接哪个智能体，其架构都是相同的：
┌──────────────┐ ┌──────────────────┐ ┌──────────────┐
│ │ HTTP │ │ 工具 │ │
│ Open WebUI │────────▶│ 智能体网关 │────────▶│ 终端、文件、│
│ (前端) │◀────────│ (API 服务器) │◀────────│ 网页 │
│ │ 流式 │ │ 结果 │ │
└──────────────┘ └──────────────────┘ └──────────────┘
- 您在 Open WebUI 中键入一条消息
- Open WebUI 将其发送到智能体的 API 服务器（就像发送给 OpenAI 一样）
- 智能体决定使用哪些工具，执行它们，并对结果进行推理
- 最终响应流式传回给 Open WebUI，并带有可选的进度指示器
- 您在熟悉的对话界面中看到响应，并具有完整的对话历史记录、用户账户和所有 Open WebUI 功能
提示
因为智能体采用的是标准的 OpenAI Chat Completions 协议，所以添加一个智能体就像在管理员设置 → 外部连接 → OpenAI中添加 URL 和 API Key 一样简单。无需任何插件、管道（Pipes）或中间件。