

GitHub 地址:https://github.com/EKKOLearnAI/hermes-web-ui
Hermes Web UI 是专为 Hermes Agent(NousResearch 开源的多平台 AI Agent 框架)设计的全功能 Web 管理面板。它解决了 Hermes 原生 命令行 界面(CLI)操作繁琐的痛点,将聊天会话管理、渠道配置、成本监控等能力封装进一个现代化的响应式 Web 界面中。该项目采用 MIT 协议,基于 Vue 3 + Koa 2 技术栈构建,旨在让非技术用户也能轻松管理复杂的 AI 机器人集群。
实时流式对话:基于 Server-Sent Events (SSE) 实现消息的实时流式渲染,支持 Markdown 语法高亮和代码块一键复制。
会话分组与搜索:对话按来源(Telegram、Discord、Slack 等)自动分组,支持全局搜索(Ctrl+K)快速定位历史记录。
上下文监控:实时显示每个会话的 Token 消耗(输入/输出)及模型使用情况。
在一个可视化页面内集中配置所有接入平台,无需手动编辑复杂的 YAML 文件。支持平台包括:
即时通讯:Telegram、Discord、Slack、WhatsApp、Matrix
办公协同:飞书(Lark)、企业微信、微信(扫码登录)
配置信息自动写入 Hermes 的 config.yaml和 .env文件,修改后自动重启网关服务。
Token 统计:按模型、按会话统计 Token 消耗量,计算预估 API 成本。
趋势分析:提供 30 天内的用量趋势图表(柱状图+数据表),帮助优化模型选择与预算控制。
任务编排:通过表单创建、编辑、暂停或恢复定时任务,支持 Cron 表达式快捷模板。
执行监控:支持手动立即触发任务,查看任务执行日志和状态,替代命令行操作。
模型发现:自动从凭证池(auth.json)发现可用模型,支持添加自定义 OpenAI 兼容 Provider。
文件操作:集成 Web 终端(基于 node-pty),支持浏览、上传、下载文件,兼容本地、Docker、SSH、Singularity 等多种后端。
基础环境:已安装 Hermes Agent(若未安装,脚本可自动引导)。
Node.js:建议 Node.js 18+(一键脚本可自动安装)。
系统支持:Debian/Ubuntu/macOS 原生支持;Windows 用户需通过 WSL 运行。
npm 全局安装(推荐)
npm install -g hermes-web-ui hermes-web-ui start
访问 http://localhost:8648。
一键脚本安装(自动装 Node.js)
bash <(curl -fsSL https://raw.githubusercontent.com/EKKOLearnAI/hermes-web-ui/main/scripts/setup.sh)
脚本会自动检测并安装缺失的 Node.js,适用于纯净系统。
Docker Compose 部署
WEBUI_IMAGE=ekkoye8888/hermes-web-ui:latest docker compose up -d
适合容器化环境,数据持久化目录为 ./hermes_data。
服务启动时,BFF 后端会自动执行以下初始化操作,无需手动干预:
校验并补全 Hermes 配置文件(~/.hermes/config.yaml)中的 api_server字段。
检测并自动启动 Hermes Gateway(若未运行)。
解决端口冲突(清理残留进程)。
启动服务:在终端执行 hermes-web-ui start,浏览器自动打开 http://localhost:8648。
配置渠道:在“平台渠道”页面填入各平台的 Bot Token 或 App Secret,保存后网关自动重启生效。
监控对话:在“对话”页面查看各平台流入的会话,实时监控 Token 消耗。
管理任务:在“定时任务”页面创建新闻推送或数据巡检任务,设置投递目标(如 Telegram 频道)。
安装后可使用以下命令管理后台服务:
hermes-web-ui stop:停止服务。
hermes-web-ui restart:重启服务。
hermes-web-ui status:查看运行状态。
hermes-web-ui update:更新至最新版本。
痛点:团队在 Telegram、Discord、飞书等多个平台部署了客服机器人,但运营人员无法同时查看所有渠道的对话记录,且无法直观统计各平台的服务量。
Hermes Web UI 方案:
部署 Hermes Web UI,在“渠道配置”页面统一录入各平台的密钥。
运营人员在 Web 界面的“对话”列表中,可按平台筛选查看所有用户咨询,并利用全局搜索快速定位特定问题。
在“分析”页面查看各平台的日均会话量和 Token 成本,优化资源分配。
价值:将分散在多个 App 的客服工作收敛到一个 Web 后台,实现了跨平台会话的统一归档与成本核算。
痛点:运维人员使用 Hermes Cron 定时检查服务器状态,但编写 Cron 表达式和查看执行日志需通过命令行,对非技术人员极不友好。
Hermes Web UI 方案:
在“定时任务”页面,通过表单创建任务:名称(“每日服务巡检”)、调度时间(0 9 * * *)、提示词(“检查 Nginx 和数据库状态”)、投递目标(“飞书运维群”)。
任务执行后,直接在 Web 界面查看执行日志,若巡检失败可手动立即触发重跑。
价值:运维经理无需学习 Linux Cron 语法,即可通过可视化界面配置和监控自动化巡检流程,降低了 AI 运维的门槛。
痛点:团队共用一套 Hermes 实例,不同成员滥用高成本模型(如 GPT-4 )导致月度账单激增,且无法追溯责任人。
Hermes Web UI 方案:
管理员在 Web UI 的“模型”页面配置好可用的模型池(如 GPT-4、Claude 3 Sonnet、DeepSeek)。
成员在聊天时可在界面右上角切换模型,Web UI 会记录每个会话的模型选择。
月底在“分析”页面,按模型类型和会话来源(渠道)导出 Token 消耗报表,精准定位高成本来源。
价值:实现了模型使用的可视化与可审计,为团队成本管控提供了数据支撑。
Hermes Web UI 填补了 Hermes Agent 在可视化运维上的空白。它通过将 CLI 能力 Web 化,极大地降低了多平台 AI 机器人的管理门槛,特别适合需要统一管理多个社交平台机器人的运营团队和关注 API 成本的技术负责人。