Hermes WebUI

一、Hermes WebUI是什么

• 开源性质：基于MIT协议，代码完全公开，可自由修改和分发。
• 技术栈：前端使用Vue 3 + TypeScript，后端基于Koa 2，支持Docker和本地部署。
• 定位差异：Hermes Agent本身是AI任务执行框架，而WebUI仅是其管理工具，不提供额外AI能力。

二、主要功能

1. AI聊天会话管理

• 实时流式对话：基于 SSE（Server-Sent Events）实现消息实时渲染，支持 Markdown 高亮和代码块一键复制。
• 多会话分组：按 Telegram、Discord 等平台来源自动分组，支持 Ctrl+K 全局搜索历史记录，活跃会话置顶显示。
• 上下文监控：实时显示 Token 消耗（输入/输出分离统计）及模型使用情况。

2. 多平台渠道统一配置

• 8大平台集成：Telegram、Discord、Slack、WhatsApp、Matrix、飞书、企业微信、微信（扫码登录）。
• 可视化配置：在单页面内完成 Bot Token、提及规则等设置，修改后自动重启网关，无需手动编辑 YAML 文件。

3. 成本与用量监控

• 30天趋势分析：提供 Token 消耗、会话数量、费用估算的图表与数据表，支持缓存命中率统计。
• 模型分布图：直观展示不同模型的调用占比，辅助优化资源分配。

4. 其他核心功能

• 定时任务管理：通过表单创建/编辑 Cron 任务，支持手动触发和执行日志查看。
• 文件与模型管理：集成 Web 终端（node-pty），可浏览/上传/下载文件；自动发现 auth.json 中的可用模型。

三、如何使用

1. 安装方式（三选一）

• npm 全局安装（推荐）：
  [bash]

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

  访问 http://localhost:8648。

• 一键脚本安装：自动检测系统并安装 Node.js（支持 Debian/Ubuntu/macOS/WSL）：
  [bash]

  bash <(curl -fsSL https://raw.githubusercontent.com/EKKOLearnAI/hermes-web-ui/main/scripts/setup.sh)

• Docker 部署：
  [bash]

  WEBUI_IMAGE=ekkoye8888/hermes-web-ui:latest docker compose up -d

  数据持久化目录为 ./hermes_data。

2. 基础操作流程

1. 启动后访问本地地址（默认 8648 端口）。
2. 首次使用需完成引导设置：验证 Hermes Agent 环境、配置模型提供方（如 OpenAI 兼容接口）、设置可选密码保护。
3. 通过左侧导航栏管理会话、平台配置、定时任务等，所有修改自动同步至 Hermes 的 config.yaml 和 .env 文件。

四、应用场景

1. 多平台AI机器人运营

• 统一管理Telegram、微信等 15+ 消息渠道的 AI 交互，避免切换命令行配置。
• 适合运营跨平台客服机器人或个人数字助理。

2. 成本与性能优化

• 实时监控 Token 消耗，识别高成本会话，调整模型选择以控制预算。
• 通过 30 天趋势分析优化模型切换策略（如优先使用低成本本地模型）。

3. 开发者效率工具

• 可视化配置定时任务（如每日数据报告生成），替代手动编写 Cron 表达式。
• 文件管理功能直接操作 Agent 工作目录，简化调试流程。

五、同类品对比

1. Hermes WebUI vs OpenClaw Dashboard

• Hermes WebUI优势：
  • 更全面的平台支持（8 大平台 vs OpenClaw 的 4-5 个）。
  • 独有的成本分析功能（Token 趋势图、费用估算），适合预算敏感场景。
  • 支持 群聊模式（多 Agent 协作）和远程文件管理。
• OpenClaw优势：
  • 内置 Skills 技能市场（380+ 预置技能包）和移动端配对功能。
  • 配置管理更直观（Web 界面直接编辑 JSON，无需重启）。

2. 核心差异总结

• 选Hermes WebUI：需 多平台集成、成本监控或远程文件操作。
• 选OpenClaw：侧重 技能扩展、移动端管理或简化配置流程。

六、会员价格

• 重要提示：Hermes Agent本身依赖的大模型 API（如 OpenAI）可能产生调用费用，但WebUI 仅作为管理工具，不涉及模型调用计费。

七、优点和缺点

优点

• 显著降低使用门槛：非技术用户可通过界面完成命令行复杂操作，避免手动编辑配置文件。
• 数据驱动决策：30 天用量趋势分析帮助优化模型选择，减少无效 API 调用成本。
• 跨平台兼容性：支持 Linux/macOS/WSL，Docker 部署方案简化环境配置。

缺点

• 非官方维护：由社区开发，功能更新可能滞后于 Hermes Agent 主版本。
• 依赖Hermes环境：需预先安装 Hermes Agent，无法独立运行（仅管理面板）。
• 微信等国内平台需额外配置：微信扫码登录需确保服务器网络可达，企业微信/飞书需手动填入凭证。

八、官方网站地址

• GitHub 仓库：https://github.com/EKKOLearnAI/hermes-web-ui（唯一官方代码源）。