给 Hermes Agent 安装 WebUI 有几种不同的方案，我整理了三种最实用的，你可以根据自己的需求选择：
方案一：Docker 部署 Hermes WebUI
这是最简单、最标准的方式，通过 Docker 一键部署可视化面板，安装后通过浏览器访问 http://localhost:3001 即可使用 。
前置准备
-
已安装 Docker Desktop（如果还没装，去 Docker 官网下载安装并启动）
-
确保 Docker 处于运行状态
安装步骤
第一步：拉取镜像
docker pull ghcr.io/nesquena/hermes-webui:latest
第二步：创建数据目录（用于持久化存储）
mkdir -p ~/docker/hermes
第三步：启动容器
docker run -d --name hermes-webui -p 3001:8787 \ -e HERMES_WEBUI_STATE_DIR=/app/data \ -v /yourpath/hermes:/app/data \ --restart unless-stopped \ ghcr.io/nesquena/hermes-webui:latest
第四步：访问 WebUI
打开浏览器，访问 http://localhost:3001
注意：如果没有 Docker，可以先安装 Docker Desktop（Windows/Mac 都有图形化安装包），然后再执行上述命令 。
方案二：源码部署（最推荐）
# 方式一：一键完整安装命令
git clone https://github.com/nesquena/hermes-webui.git hermes-webui && cd hermes-webui && ./start.sh
# 方式二：分步骤操作： # 克隆项目
git clone https://github.com/nesquena/hermes-webui.git hermes-webui
# 进入目录
cd hermes-webui
# 启动服务
./start.sh
或
python3 bootstrap.py
方案三：docker-compose
version: '3.8'
services:
# 后端 Agent（处理所有 Hermes 核心操作）
hermes-agent:
image: nousresearch/hermes-agent:latest
container_name: hermes-agent
volumes:
- /Users/用户/.hermes:/home/agent/.hermes
environment:
- HERMES_HOME=/home/agent/.hermes
command: gateway run
restart: unless-stopped
# 前端 WebUI（只做界面，不直接操作 .hermes）
hermes-webui:
image: ghcr.io/nesquena/hermes-webui:latest
container_name: hermes-webui
ports:
- "3001:8787"
depends_on:
- hermes-agent
environment:
- HERMES_WEBUI_STATE_DIR=/app/data
- UPSTREAM=http://hermes-agent:8642
volumes:
- /Users/用户/data/go/hermes:/app/data
restart: unless-stoppeddocker-compose up -d
- THE END -
最后修改：2026年4月29日
非特殊说明，本博所有文章均为博主原创。
