📝

用Open WebUI给Hermes Agent做个好看的前端，浏览器里聊AI

原文链接：https://mp.weixin.qq.com/s/49DwbRgyrOTRMy_DKYjpAQ

用Open WebUI给Hermes Agent做个好看的前端，浏览器里聊AI

给Hermes装一张漂亮的脸：Open WebUI + Hermes Agent

来源：Hermes Agent 官方文档 · hermesagent.org.cn

你有没有这种感觉——Hermes Agent 挺好用的，但每次都得在终端里敲命令，对着黑屏幕和返回的 JSON 打交道，总觉得差点意思。我懂。这就像买了台性能车，结果内饰是二十年前的桑塔纳。

今天介绍一个免费方案：用 Open WebUI 给 Hermes Agent 装一个漂亮的前端。装完之后，你就能在浏览器里用聊天的方式指挥 AI 了。

先说说 Open WebUI 是什么

这是一个开源的网页聊天界面，GitHub 上有12.6 万颗星，是同类项目里最受欢迎的前端之一。

它本来是用来接 ChatGPT 或本地模型的，但它的 API 兼容 OpenAI 格式。而 Hermes Agent 内置了 API 服务器，正好能接上去。

于是你就有了：

一个好看的网页聊天界面

对话历史自动保存

多用户支持（每人独立配置、记忆、技能）

工具调用进度实时显示

——你在让它查资料、跑代码，界面上会一行行刷出来

整个是免费的，部署在自己电脑上，不用担心数据外泄。

工作原理（简单说）

简单画一下连接关系：

你的浏览器 → Open WebUI → Hermes Agent API 服务器 → 完整的工具集

Open WebUI 把你的对话发到 Hermes Agent，Agent 用它全套的工具处理（终端、文件、网络、记忆、技能），然后把结果返回，界面上一行行流式显示出来。整个过程是本地通信，不需要额外配置什么 CORS。

怎么接上去？三步搞定

第一步：开启 Hermes Agent 的 API 服务器

在配置文件 ~/.hermes/.env 里加两行：

API_SERVER_ENABLED=true API_SERVER_KEY=随便写个密钥，比如 my-secret-key

然后运行：

1	`hermes gateway`

看到这行就说明成功了：

[API Server] API server listening on http://127.0.0.1:8642

第二步：启动 Open WebUI

用 Docker，一条命令搞定：

`docker run -d \ -p 3000:8080 \ -e OPENAI_API_BASE_URL=http://host.docker.internal:8642/v1 \ -e OPENAI_API_KEY=my-secret-key \ --add-host=host.docker.internal:host-gateway \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:main`

解释一下关键参数：-p 3000:8080

访问地址是 http://localhost:3000

OPENAI_API_BASE_URL：必须带 /v1 后缀，这是最容易踩的坑

OPENAI_API_KEY：和第一步你设的密钥保持一致就行

第三步：打开网页，开始聊

浏览器访问 http://localhost:3000，注册一个管理员账号，进到主页。在模型下拉菜单里，找到你的 Agent，点进去就能开始聊天了。

界面长什么样？

Open WebUI 的界面风格接近 ChatGPT，支持：

流式输出：AI 一边想一边打字，你一边看

工具调用可视化：当 Agent 在执行工具时，界面上会实时刷出它调用了哪些工具，比如 💻 ls -la、🔍 Python 3.12 release，执行完才继续往下走

对话管理：历史记录都在，侧边栏随便翻

Markdown 渲染：代码、表格、链接都能正常显示

如果你是多人使用，每个人可以设置独立的 Hermes Profile——每人一套独立的记忆、技能和配置，互不干扰。

踩过的坑提醒一下

坑1：URL 忘记加 /v1

这是最多人出错的地方。API 地址一定要写成：http://xxx:8642/v1，结尾的 /v1 千万不能省。不加的话，连接测试能通过，但模型下拉菜单里是空的。

坑2：API 密钥两端要一致

.env 里设的 API_SERVER_KEY，Docker 里 OPENAI_API_KEY 要一模一样，多一个空格都不行。

坑3：Linux 上 host.docker.internal 无法解析

如果你用的是 Linux 系统（没有 Docker Desktop），host.docker.internal 这个地址可能不通。解决方案是加一行 –network=host，同时把 URL 改成 http://localhost:8642/v1。

谁适合用？

说实话，如果你觉得命令行没问题，这个方案属于锦上添花。

但如果你是：非技术背景的同事，想用 AI 但不想碰终端

团队Leader，想给团队搭一个统一的 AI 工作台

想研究 AI但 ChatGPT Plus 太贵，API 费用也不便宜

这个组合值得试试——完全免费，部署在本地，数据不经过任何第三方。

Hermes Agent 负责”脑子”，Open WebUI 负责”脸”，两个人一组合，就成了一个本地版的私有 AI 助手。

💬 本文评论区已开启，但暂无读者留言。

本文转载自微信公众号，如有侵权请联系删除。

给Hermes装一张“漂亮的脸”