上周我统计了一下,光是管理Hermes Agent的各个渠道,每天要在终端里敲20+条命令,看日志、改Telegram配置、查Token消耗、配定时任务,来回切换4-5个终端窗口。
直到发现了Hermes Web UI这个项目,16天涨到2300+ Star,我是真的觉得这玩意儿解决了大问题,实测一行命令装好,浏览器打开就完事了。
今天把我的使用体验分享出来,包括安装过程、核心功能实测、以及踩过的坑。
一、它解决什么问题?
Hermes Agent是NousResearch的开源AI Agent框架,能同时对接Telegram、Discord、Slack、飞书等8个平台。
但问题来了:
管理这些渠道全靠命令行,怎么说呢,效率真的低。改个Telegram Bot配置要手动编辑config.yaml,看使用数据要跑hermes stats命令,配定时任务又要用hermes cron。每个操作都在不同终端,效率很低。
Hermes Web UI把这一切搬到了浏览器里:
• 多平台渠道配置 → 一个页面搞定 • Token消耗/会话数据 → 可视化图表 • 定时任务管理 → 点击操作 • 日志查看 → 带过滤和高亮 • 文件管理 → 浏览器里直接操作 • 远程终端 → 内置Web Terminal
坦白讲,把命令行的活儿变成了点点点。
二、核心功能实测
2.1 AI聊天界面
SSE实时流式对话,响应速度和命令行体验一致。几个亮点:
• 多会话管理:可以创建、重命名、删除、切换会话,按来源分组显示 • 全局搜索:Ctrl+K搜索所有历史对话,找之前聊过的内容很方便 • 工具调用可视化:Agent调用了什么工具、传了什么参数、返回了什么结果,全部展开可看 • 文件上传下载:直接拖文件进聊天框
2.2 多平台渠道管理(最实用)
一个页面配置8个平台:
Telegram:Bot Token、@提及控制、表情反应、自由聊天模式 Discord:Bot Token、自动建线程、表情反应、频道黑白名单 Slack:Bot Token、@提及控制、机器人消息处理 WhatsApp:扫码登录(浏览器扫码,自动保存凭证) 飞书:App ID / Secret、@提及控制 企业微信:Bot ID / Secret Matrix:Access Token、Homeserver、自动线程 WeChat:扫码登录
关键细节: 改完配置自动重启网关,不需要手动hermes gateway restart。
2.3 使用数据分析
打开就能看到:
• 总Token用量(输入/输出分开统计) • 会话数和日均会话趋势 • 费用追踪和缓存命中率 • 模型使用分布图 • 30天趋势图
实测体验: 说真的,比自己跑hermes stats然后手动算方便太多,直接看图表就知道哪个模型烧钱最多。
2.4 定时任务管理
可视化创建、编辑、暂停、恢复、删除Cron任务,支持即时执行。内置常用Cron表达式快捷选项(每小时、每天早上9点等)。
2.5 其他实用功能
模型管理:从auth.json自动发现模型,每个Provider自动拉取可用模型列表。
多Profile管理:可以创建、克隆、导入导出Profile,适合多环境切换。
文件浏览器:浏览本地/Docker/SSH文件,支持上传下载、语法高亮查看。
群聊:多Agent群聊房间,@提及路由触发对应回复。
Web终端:内置xterm.js终端,多会话支持,窗口自适应。
三、安装(3步搞定)
方式一:npm全局安装(推荐)
npm install -g hermes-web-uihermes-web-ui start浏览器打开 http://localhost:8648
首次运行自动生成认证Token,在日志里打印,输入即可登录。后续可在设置页改成用户名密码登录。
方式二:一键脚本
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-agent hermes-webui常用命令:
hermes-web-ui start --port 9000 # 自定义端口hermes-web-ui stop # 停止hermes-web-ui restart # 重启hermes-web-ui status # 查看状态hermes-web-ui update # 更新并重启四、踩坑记录
坑1:认证Token要保存好
这块要注意一下,首次启动的Token只在日志里打印一次,没保存就找不回来了。建议第一时间改成用户名密码登录。
坑2:WhatsApp/WeChat扫码登录依赖第三方
这两个平台的扫码功能依赖外部API服务,稳定性取决于第三方。如果扫码失败,大概率是第三方服务挂了。
坑3:必须先装Hermes Agent
坦率的讲,这不是独立的AI聊天工具,是Hermes Agent的管理界面。没装Hermes Agent的话,面板跑不起来。
坑4:SSH/Singularity后端要额外配置
文件浏览器支持远程后端,但需要先配好SSH连接或Singularity环境,不是开箱即用。
五、适合谁用?
已经在用Hermes Agent的开发者:省去命令行操作,效率提升明显。
多平台运营团队:一个页面配8个平台,不用来回切换后台。
技术管理者:数据分析面板直接看Token消耗、会话趋势,不用自己跑命令算。
六、技术栈
前端:Vue 3 + TypeScript + Vite + Naive UI + PiniaBFF层:Koa 2终端:node-pty + xterm.js协议:MIT
总结
Hermes Web UI把Hermes Agent从命令行搬到了浏览器,一行命令安装,功能覆盖聊天、多平台管理、数据分析、定时任务、文件管理。
如果你在用Hermes Agent,我是真的推荐试试这个面板。
GitHub仓库:EKKOLearnAI/hermes-web-ui Hermes Agent主仓库:NousResearch/hermes-agent
npm install -g hermes-web-uihermes-web-ui start你在用Hermes Agent吗?管理多个平台的时候遇到过什么问题?评论区聊聊。

关注我,持续分享AI Agent实战干货。
夜雨聆风