Appearance
Hermes-Web-UI部署教程:极空间Docker+Multi-Agents管理面板
第三方Hermes-Web-UI吊打官方版本,支持中文、Multi-Agents,可视化配置代替改yaml文件。
为什么需要第三方Web-UI?
Hermes-Agent火了,但官方Web-UI只能说是简陋至极。
| 对比 | OpenClaw | Hermes官方 |
|---|---|---|
| 可视化管理 | 强大 | 简陋 |
| 配置方式 | 图形界面 | yaml文件 |
| 新手体验 | 友好 | 直线下降 |
Github上第三方Hermes-Web-UI解决这个痛点:
- 支持中文
- 支持Multi-Agents
- 可视化配置
一、极空间Docker部署
架构说明
双容器结构:
| 容器 | 端口 | 功能 |
|---|---|---|
| hermes-agent | 8642(gateway) | 核心Agent |
| hermes-webui | 6060 | Web管理面板 |
WebUI通过gateway端口管理Hermes,直接读取Home路径下的.env和config.yaml修改配置。
Docker Compose配置
打开极空间NAS的Docker应用,创建Compose新项目:
yaml
services:
hermes-agent:
image: nousresearch/hermes-agent:latest
container_name: hermes-agent
volumes:
- ./hermes_data:/home/agent/.hermes
- hermes-agent-src:/opt/hermes
environment:
- HERMES_HOME=/home/agent/.hermes
stdin_open: true
tty: true
restart: unless-stopped
hermes-webui:
image: lingganwu/hermes-web-ui
container_name: hermes-webui
entrypoint: ["node", "dist/server/index.js"]
depends_on:
- hermes-agent
ports:
- "6060:6060"
volumes:
- ./hermes_data:/home/agent/.hermes
- ./hermes_data/hermes-web-ui-data:/app/dist/data
- hermes-agent-src:/opt/hermes
environment:
- PORT=6060
- UPSTREAM=http://hermes-agent:8642
- HERMES_HOME=/home/agent/.hermes
- HERMES_BIN=/opt/hermes/.venv/bin/hermes
- AUTH_DISABLED=false
restart: unless-stopped
volumes:
hermes-agent-src:注意事项:
- 如果原来已部署Hermes,把
./hermes_data改成你的原始路径 - 存储位置代表Hermes工作目录所在空间
获取登录Token
容器启动后,在Compose页面找到日志标签页,搜索Auth即可看到前端密钥。
如果丢了,去 /home/agent/.hermes/hermes-web-ui-data/.token 里找。
二、Web-UI功能介绍
登录配置
系统自带中文,首页输入token直接登录。
八大功能模块
| 模块 | 功能 |
|---|---|
| 模型配置 | 内置Provider整合,填API Key即可,比改ENV效率高太多 |
| 记忆模块 | 事实、用户画像、Soul文件直接读取和修改 |
| Skills管理 | 列出所有技能,灵活开关,侧边栏显示SKILL.md指引 |
| 频道渠道 | 对接IM工具(飞书、WeChat推荐) |
| Cron定时任务 | 查看Hermes创建的定时任务,手动创建新任务 |
| 网关日志 | 各级别日志查看、搜索、滚动,排查问题利器 |
| Multi-Agents | 多Agent并行管理(下文详解) |
| 系统配置 | 压缩上下文、会话、隐私等参数 |
模型配置优势
所有配置好的模型都会展示在列表里。
对比之前:改配置文件和ENV,效率差太多。
现在:内置模型一选,填入API Key就完成。
Skills管理亮点
把所有技能列出,可以灵活配置开/关。侧边栏可以看到所有Skills下的SKILL.md指引,有用与否一目了然。
三、Multi-Agents支持
这是最神的功能。
架构对比
| 项目 | OpenClaw | Hermes |
|---|---|---|
| 架构 | 单网关多Agents | 单网关单Agent |
| 多Agent方式 | 一个网关管理多个Agent | 多网关并行控制 |
实现方式
除了default之外的Agent保存在 ~/.profiles/ 目录里。
在系统下拉的Agents列表里可以切换不同Agent。
四、内置终端
系统有一个内置终点,可以直接访问到Hermes容器内部。
用途:调试、排查问题、执行命令。
五、优缺点总结
优点
| 优点 | 说明 |
|---|---|
| ✅ 中文支持 | 本地化友好 |
| ✅ 可视化配置 | 不用改yaml |
| ✅ Multi-Agents | 多Agent并行管理 |
| ✅ 八大模块 | 覆盖配置全流程 |
| ✅ 内置终端 | 直接访问容器 |
缺点
| 缺点 | 说明 |
|---|---|
| ❌ 系统级日志不足 | 以配置文件为主 |
| ❌ 抓取分析缺失 | 深度监控还未支持 |
总结
有了这套可视化面板:
| 操作 | 之前 | 现在 |
|---|---|---|
| 和Hermes对话 | 命令行 | 网页直接对话 |
| 配置底层文件 | 手动编辑 | 可视化修改 |
| 配置模型 | 改ENV | 填API Key |
| 配置IM渠道 | 写配置 | 点击完成 |
便捷度大大提升。
关键词:Hermes-Web-UI, Docker部署, 极空间, Multi-Agents, 可视化面板, Hermes Agent
