📝

Hermes Agent 官方 Web UI 来了，一行命令就能用发现一个 16 天涨到

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

Hermes Agent 官方 Web UI 来了，一行命令就能用发现一个 16 天涨到

Hermes Agent 官方 Web UI 来了，一行命令就能用

发现一个 16 天涨到 2300+ Star 的项目 Hermes Web UI。Hermes Agent 的 Web 管理面板，一行命令启动，聊天、多平台管理、数据分析、定时任务全都有。先看看它做了什么。

为什么关注这个？

Hermes Agent 是 NousResearch 推出的开源 AI Agent 框架。之前管理 Hermes 主要靠命令行，要开 Telegram Bot、Discord Bot、看使用数据、配定时任务，得跑好几个命令，切换不同终端。

Hermes Web UI 把这些都集成到一个网页界面里了。npm 全局安装，一行命令启动，浏览器打开就能用。

一、它是什么？

GitHub：EKKOLearnAI/hermes-web-ui（2364 Star，MIT 协议）

Hermes Agent 的完整 Web 管理面板。支持多平台 AI 聊天、会话管理、定时任务、使用数据分析、渠道配置（Telegram、Discord、Slack、WhatsApp、飞书、企业微信、Matrix），还有内置的文件浏览器、Web 终端和群聊功能。

Vue 3 + TypeScript + Naive UI 前端，Koa 做 BFF 层，MIT 协议。

二、核心功能

AI 聊天

SSE 实时流式对话，支持异步运行。多会话管理，可以创建、重命名、删除、切换会话。按来源（Telegram、Discord、Slack 等）分组，折叠显示。

Ctrl+K 全局搜索所有对话。支持 Markdown 渲染、代码高亮、文件上传下载。工具调用详情可以展开查看参数和结果。

多平台渠道管理

这是最实用的功能之一。在一个页面配置 8 个平台：

平台
功能

Telegram
Bot Token、@提及控制、表情反应、自由聊天

Discord
Bot Token、自动建线程、表情反应、频道黑白名单

Slack
Bot Token、@提及控制、机器人消息处理

WhatsApp
扫码登录（浏览器扫码，自动保存凭证）

飞书
App ID / Secret、@提及控制

企业微信
Bot ID / Secret

Matrix
Access Token、Homeserver、自动线程

WeChat
扫码登录

改完配置自动重启网关，不需要手动操作。

使用数据分析

总 Token 用量统计（输入/输出）、会话数和日均会话、费用追踪和缓存命中率、模型使用分布图、30 天趋势图。

不用自己跑命令算数据了，打开面板就能看到消耗情况。

定时任务

创建、编辑、暂停、恢复、删除 Cron 任务，支持即时执行。内置常用 Cron 表达式快捷选项。

模型管理

从凭证池（~/.hermes/auth.json）自动发现模型。每个 Provider 自动拉取可用模型列表（/v1/models）。支持添加、更新、删除 Provider，支持 OpenAI Codex 和 Nous Portal OAuth 登录。

多 Profile 管理

创建、重命名、删除、切换 Hermes Profile。可以克隆现有 Profile 或从归档文件导入。导出 Profile 做备份或分享。每个 Profile 独立管理网关、配置和缓存。

文件浏览器

浏览后端文件（本地、Docker、SSH、Singularity），支持上传、下载、重命名、复制、移动、删除、创建目录。带语法高亮的文件内容查看。

群聊

多 Agent 群聊房间，Socket.IO 实时消息。@提及路由——提及某个 Agent 触发对应回复。对话历史超限时自动压缩摘要。房间创建、删除和邀请码管理。

Web 终端

内置终端，基于 node-pty 和 xterm.js。多会话支持，实时键盘输入和输出流。支持窗口大小自适应。

日志查看

查看 Agent 日志、网关日志、错误日志。按日志级别、文件和关键词过滤。结构化日志解析，HTTP 访问日志高亮。

三、安装

最简单的安装方式：

1

2

        
npm install -g hermes-web-ui
hermes-web-ui start

浏览器打开 http://localhost:8648

一行命令搞定。首次运行自动生成认证 Token，浏览器打开后输入 Token 即可登录。

其他安装方式：

1

2

3

4

5

        
# 一键安装（自动检测系统，含 Node.js 安装）
bash <(curl -fsSL https://raw.githubusercontent.com/EKKOLearnAI/hermes-web-ui/main/scripts/setup.sh)
 
# Docker Compose（和 Hermes Agent 一起运行）
WEBUI_IMAGE=ekkoye8888/hermes-web-ui:latest docker compose up -d hermes-agent hermes-webui

常用命令：

命令
说明

hermes-web-ui start
后台启动

hermes-web-ui start --port 9000
自定义端口启动

hermes-web-ui stop
停止

hermes-web-ui restart
重启

hermes-web-ui status
查看运行状态

hermes-web-ui update
更新到最新版并重启

启动时会自动做几件事：验证配置文件、自动启动网关、解决端口冲突、打开浏览器。

四、架构

1

2

3

4

5

6

        
Browser → BFF (Koa, :8648) → Hermes Gateway (:8642)
                ↓
           Hermes CLI (sessions, logs, version)
                ↓
           ~/.hermes/config.yaml  (渠道行为配置)
           ~/.hermes/auth.json    (凭证池)

前端负责展示和交互，BFF 层做 API 代理（路径重写）、SSE 流式传输、文件上传下载、配置管理。Hermes 特定代码都命名空间在 hermes/ 目录下，方便后续接入其他 Agent。

技术栈比较清晰：Vue 3 + TypeScript + Vite + Naive UI + Pinia 前端，Koa 2 做 BFF，node-pty 做 Web 终端。

五、适合谁用？

已经在用 Hermes Agent 的团队，之前靠命令行管理多个渠道、看日志、配定时任务的，这个面板能省不少操作时间。

需要多平台分发的运营团队，一个页面配 Telegram、Discord、Slack、WhatsApp、飞书、企业微信，不用在不同平台后台来回切换。

技术管理者，数据分析面板直接看 Token 消耗、会话趋势、模型使用分布，不用自己跑命令算。

六、注意事项

需要配合 Hermes Agent 使用。这不是一个独立的 AI 聊天工具，是 Hermes Agent 的管理界面。没有 Hermes Agent 的话，面板跑不起来。

Web 微信登录依赖第三方 API。WhatsApp 和 WeChat 的扫码登录功能依赖外部服务，稳定性取决于对应 API 的可用性。

认证 Token 首次运行生成。第一次启动会在日志里打印 Token，记得保存。后续可以在设置页改成用户名密码登录。

SSH/Singularity 后端需要额外配置。文件浏览器支持远程后端，但需要先配置好 SSH 连接或 Singularity 环境。

总结

Hermes Web UI 把 Hermes Agent 用户从命令行搬到了网页上。一行命令安装，打开浏览器就能用。

多平台渠道管理、数据分析、定时任务、文件浏览器、Web 终端，这些功能以前得跑不同命令、开不同终端才能做，现在集中在一个页面里。

如果你在用 Hermes Agent，这个面板值得试试。

安装命令：

1

2

        
npm install -g hermes-web-ui
hermes-web-ui start

仓库链接：EKKOLearnAI/hermes-web-ui

Hermes Agent 主仓库：NousResearch/hermes-agent

如果你也在用 Hermes 做多平台 Agent 分发，欢迎在评论区交流经验。

免责声明：本文内容仅为个人学习分享，不构成产品推荐建议。文中工具功能描述基于官方文档和 README，实际功能以项目最新发布为准。提及的项目均为 MIT 开源项目，遵守对应许可条款即可使用。

感谢你的阅读。

如果这篇文章对你有帮助，欢迎：

点赞支持
分享给朋友
在评论区分享你的想法

关注「AI 工程化实战派」，不空谈虚概念，只输出务实干货。

期待和你的交流！

AI工程化实战派公众号二维码

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

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