一条命令打造你的 AI Agent 控制台：Hermes Web UI 上手指南

Hermes Web UI 能做什么？

• AI 聊天：SSE 实时流式对话，多会话管理，支持 Markdown 渲染和代码高亮，自带全局模型选择器，文件上传下载都行。
• 8 大平台集成：Telegram、Discord、Slack、WhatsApp、Matrix、飞书、微信、企微——在同一个页面管理所有渠道的配置。微信支持扫码登录，飞书和企微填 App ID / Secret 即可。
• 使用分析：Token 用量细分、成本追踪、缓存命中率、模型分布图、30 天趋势——帮你搞清楚 Agent 到底花了多少钱。
• 定时任务（Cron）：在 Web 界面创建、编辑、暂停、恢复定时任务，还能一键立即执行。
• 模型管理：自动发现 ~/.hermes/auth.json 里所有 Provider 的模型，支持添加自定义 OpenAI 兼容端点。
• 文件浏览器：支持本地、Docker、SSH、Singularity 四种后端，上传下载、重命名、移动、预览。
• 群组聊天：多 Agent 聊天室，@mention 路由到指定 Agent，上下文自动压缩。
• Web 终端：浏览器里直接开终端，xterm.js 驱动，多会话支持。
• 8 种语言：中文、英语、德语、法语、西班牙语、日语、韩语、葡萄牙语。

安装：三种方式任选

方式一：npm（推荐，最快）

前提：Node.js >= 23。

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

浏览器自动打开 http://localhost:8648。

就这么两行命令。不需要 git clone，不需要 npm install 依赖，不需要配数据库。

方式二：一键安装脚本

适合没有 Node.js 的 Linux/macOS 机器。脚本会自动安装 Node.js，然后装 Hermes Web UI。

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

WSL 用户也用这个脚本。WSL 模式下会自动用 hermes gateway run 后台启动网关。

方式三：Docker Compose

适合服务器部署、想跑 Hermes Agent + Web UI 一整套的环境。

# 用预构建镜像（推荐）
WEBUI_IMAGE=ekkoye8888/hermes-web-ui:latest docker compose up -d hermes-agent hermes-webui

# 或者从源码构建
git clone https://github.com/EKKOLearnAI/hermes-web-ui.git
cd hermes-web-ui
docker compose up -d --build hermes-agent hermes-webui

浏览器打开 http://localhost:6060（注意 Docker 模式端口是 6060，不是 8648）。

数据持久化在 ./hermes_data 目录。首次启动的认证 Token 会打印在容器日志里。

CLI 命令速查

首次启动和配置

启动后 BFF 服务器会自动做这些事：

1. 检查 ~/.hermes/config.yaml，补全缺失的 api_server 字段
2. 如果修改了配置，自动备份原文件为 config.yaml.bak
3. 检测 Hermes Gateway 是否在运行，没运行就自动启动
4. 检查端口是否冲突，有冲突就清理僵尸进程
5. 成功启动后自动打开浏览器

认证方式：首次启动会自动生成 Token，打印在终端日志里。你也可以在设置页面开启用户名/密码登录。不需要认证的话，设置环境变量 AUTH_DISABLED=1 即可关闭。

连接你的第一个 AI 模型

Hermes Web UI 会自动读取 ~/.hermes/auth.json 里的凭证池，发现所有可用模型。

如果你的凭证池里已经有模型（比如之前配过 Claude、GPT、DeepSeek），打开面板就能看到。

如果还没有配置 Provider：

1. 打开面板，进入 模型管理 页面
2. 点击 添加 Provider
3. 选择预设（Anthropic / OpenAI / Google 等）或填自定义 OpenAI 兼容端点
4. 填入 API Key
5. 面板自动调用 /v1/models 获取可用模型列表

支持的 Provider 包括：Claude、GPT、Gemini、DeepSeek，以及任何 OpenAI 兼容的端点。

在聊天界面的顶部有一个 全局模型选择器，随时切换模型。

接入聊天平台

这是 Hermes Web UI 最强的差异化功能——在同一个页面配置 8 个平台。

进入 平台渠道 页面，你会看到所有平台的状态（已配置 / 未配置）。

Telegram

1. 找 @BotFather 创建 Bot，拿到 Token
2. 填入 Token，保存
3. 配置 @提及控制（是否只在被 @ 时才回复）
4. 可选：开启 Reactions、自由回复模式

Discord

1. 在 Discord Developer Portal 创建 Bot，拿到 Token
2. 填入 Token，保存
3. 配置频道黑白名单（允许/忽略的频道）
4. 可选：开启自动线程、Reactions

飞书（Lark）

1. 在飞书开放平台创建应用，拿到 App ID 和 App Secret
2. 填入 ID 和 Secret，保存
3. 配置 @提及控制

微信

微信的接入方式比较特殊——不需要手动填 Token，而是通过扫码登录：

1. 在面板点击 微信登录
2. 弹出二维码，用微信扫码
3. 凭证自动保存，下次启动不需要重新扫码

企微（WeCom）

1. 在企业微信管理后台创建 Bot，拿到 Bot ID 和 Secret
2. 填入面板，保存

配置完成后，所有平台的配置会写入 ~/.hermes/.env（凭证）和 ~/.hermes/config.yaml（行为），网关自动重启生效。

进阶功能：让 Agent 自动跑起来

定时任务（Cron）

想每天早上自动跑一个任务？用 Cron 功能：

1. 进入 定时任务 页面
2. 点击 创建任务
3. 填写 Cron 表达式（比如 0 9 * * * 表示每天 9 点）
4. 填写任务内容（发给 Agent 的 Prompt）
5. 保存

支持的操作：创建、编辑、暂停、恢复、删除、立即执行。还有 Cron 表达式快捷预设，不用手写表达式。

群组聊天

想让多个 Agent 在一个房间里协作？

1. 创建聊天室
2. 添加 Agent 到房间（每个 Agent 可以有独立的 Profile）
3. 在聊天中 @mention 特定 Agent 触发回复
4. 上下文超过 Token 阈值时自动压缩

基于 Socket.IO 实时通信，手机端也能用。

文件浏览器

进入 文件浏览 页面，选择后端（本地 / Docker / SSH / Singularity），就能浏览和操作 Agent 能访问的文件。

支持：上传、下载、新建目录、重命名、复制、移动、删除、预览文件内容（带语法高亮）。

Web 终端

需要直接跑命令？面板内置了 Web 终端，基于 node-pty + xterm.js。

支持多终端会话，可以同时开多个标签。窗口大小自适应。

使用分析

想知道 Agent 每天花多少钱？进入 使用分析 页面：

• Token 用量：输入 / 输出 Token 分项统计
• 成本追踪：按模型估算花费
• 缓存命中率：看看有多少 Token 命中了缓存（省钱指标）
• 模型分布：哪个模型用得最多
• 30 天趋势：柱状图 + 数据表，按天看用量变化

常见问题

Q: 端口被占用了怎么办？

启动时会自动检测端口冲突，清理占用进程。也可以手动指定端口：hermes-web-ui start --port 9000。

Q: Node.js 版本不够怎么办？

要求 Node.js >= 23。用 nvm 切换版本：nvm install 23 && nvm use 23。或者用一键安装脚本，它会自动装 Node.js。

Q: Docker 模式下数据存在哪？

在 ./hermes_data 目录。包括 Hermes 配置、会话数据、Web UI Token。删除容器不会丢数据，只要 volume 没删。

Q: 支持多个 Agent Profile 吗？

支持。在 多 Profile 页面可以创建、切换、克隆、导入导出 Profile。每个 Profile 有独立的配置和缓存，可以启动独立的网关。

Q: 怎么更新？

运行 hermes-web-ui update，自动拉取最新版并重启。

参考资料

• GitHub 仓库：EKKOLearnAI/hermes-web-ui — Star 一下，获取更新
• 官方网站：ekkolearnai.com — 功能概览和文档
• npm 包：hermes-web-ui — 直接装