使用指南
Hermes Agent Web UI 中文指南
Hermes Agent 的 Web UI 就是用 hermes dashboard 启动的浏览器管理后台:配置、API Key、会话、日志、定时任务、技能、MCP、配对和消息渠道都在里面,还有一个在浏览器里运行 Hermes 终端界面的 Chat 页。本文讲它有什么、怎么打开、手机怎么安全访问,以及不想自己折腾时怎么用托管版。
Web UI 里到底有什么
后台是 Hermes 自带的本地网页服务,一个后台管理本机所有 Hermes profile(侧边栏可切换)。主要页面:
- Status — 版本、网关状态、已连接平台、活跃会话
- Chat — 在浏览器里运行完整的 Hermes 终端界面(和
hermes --tui一样),旁边有会话列表可切换 - Config / API Keys — 用表单改
config.yaml和.env,不用手动编辑文件 - Sessions / Logs / Analytics — 可搜索的会话记录(含工具调用)、实时日志、Token 和费用统计
- Cron — 新建、暂停、编辑、立即触发定时任务
- Skills / MCP — 开关已装技能、从技能中心安装,添加和测试 MCP 服务器
- Pairing / Channels — 批准或撤销消息用户,用表单接入 Telegram、Discord、飞书、企业微信等平台
- System — 启停和重启消息网关、选记忆服务、跑
doctor、备份与恢复
本地打开
装好 Hermes 后运行:
hermes dashboard # 打开 http://127.0.0.1:9119
hermes dashboard --port 8080 # 换端口
hermes dashboard --no-open # 不自动打开浏览器默认地址是 http://127.0.0.1:9119。注意 8642 是另一回事:那是 OpenAI 兼容 API,给 Open WebUI 这类工具连的,不是网页界面。
用官方 Docker 镜像的话,设 HERMES_DASHBOARD=1 并映射 9119 端口,后台会和网关一起跑:
docker run -d --name hermes --restart unless-stopped \
-v ~/.hermes:/opt/data \
-p 8642:8642 -p 9119:9119 \
-e HERMES_DASHBOARD=1 \
nousresearch/hermes-agent gateway run容器里的后台绑定 0.0.0.0,会自动开启登录门槛(见下一节),所以同样要配好登录方式。在 Docker Desktop 上挂载本机原生安装留下的旧 ~/.hermes 时,会话数据库可能需要做一次转换,在容器里跑 docker exec hermes hermes doctor 会提示,处理方法见官方 Docker 文档。
怎么从手机 / 外网访问
后台默认只绑定 127.0.0.1,只有本机能连。想从别的设备用,有三种安全做法:
- SSH 隧道或 Tailscale,不设登录 — 保持本机绑定,用隧道连进来,比如
ssh -L 9119:127.0.0.1:9119 你的服务器,然后在本地打开http://127.0.0.1:9119。官方建议不想设登录时就这么用。 - 可信网络里用用户名密码 — 在
~/.hermes/.env里设HERMES_DASHBOARD_BASIC_AUTH_USERNAME、HERMES_DASHBOARD_BASIC_AUTH_PASSWORD和HERMES_DASHBOARD_BASIC_AUTH_SECRET,再运行hermes dashboard --host 你的Tailscale或局域网IP。 - 要公网访问就用 Nous Portal OAuth — 用
hermes dashboard register --redirect-uri https://你的域名/auth/callback注册后台,把HERMES_DASHBOARD_PUBLIC_URL设成https://你的域名(不带回调路径),再用 Nous 账号登录。也支持自建 OIDC。
只要绑定到非本机地址,就必须配置登录方式;没配的话后台直接拒绝启动,而不是裸奔。
安全加固
后台能读写你的 .env(API Key 和机器人 token),还能执行 agent 命令,所以谁能进后台就相当于谁有 shell 权限。官方文档里两条要点:
- 只有用户名密码的后台不要直接放公网。它只有一组共享密码,没有二次验证。放在 Tailscale 这类 VPN 后面;真要公网访问就用 OAuth。
- 已经没有“不安全模式”开关了。旧的
--insecure参数和HERMES_DASHBOARD_INSECURE现在都不起作用。不想设登录,就保持默认的本机绑定,用隧道访问。
在任意机器上可以检查登录门槛有没有生效:curl -s http://主机:9119/api/status 会返回 auth_required 和已配置的 auth_providers。
大家在里面都做什么
- 不想在 Telegram 里聊,直接在浏览器 Chat 页和 agent 对话,或在 Sessions 页接着聊旧会话
- 在 Pairing 页批准新的 Telegram / Discord 用户
- 在 Channels 页接入消息平台,并在同一页重启网关
- 不打开
.env就能新增或更换 API Key - 开关某个技能,或从技能中心安装
- 长任务跑着,开 Logs 页实时看
Web UI vs 直接聊天渠道
Web UI 不是 Telegram / Discord 的替代品,而是互补:
- Web UI 适合要看全貌、改设置的时候:配置、日志、会话、配对、技能一次看清
- 聊天渠道 适合日常、走动中用,或者让别人也能用这个 bot
常见问题排查
8642 端口打不开页面
8642 是 API,不是后台。运行 hermes dashboard 后打开 http://127.0.0.1:9119;Docker 里要映射 9119 并设 HERMES_DASHBOARD=1。
绑定公网地址时后台拒绝启动
这是登录门槛在起作用。绑定到 127.0.0.1 以外的地址之前,先配好用户名密码或 OAuth;或者保持本机绑定,用 SSH 隧道访问。
Windows 上 Chat 页显示提示横幅
Chat 页需要 POSIX 伪终端。原生 Windows 上后台其他页面都能用,但浏览器里的 Chat 需要 WSL2。
平台配好了却没连上
网关启动时才会连接已启用的平台。在 Channels 页(或 System 页)点 Restart gateway,再到 Logs 页选 gateway 日志查看。
托管版省心方案
上面这些都是自己跑的场景。在 OpenClaw Launch 的 Hermes 托管上,每个机器人卡片都有打开仪表板按钮,通过 HTTPS 打开这个机器人的 Hermes 后台,并用你的 OpenClaw Launch 账号登录保护 — 不用配端口、隧道或登录方式。同一张卡片上还有快速聊天、终端和文件,几步就能接好 Telegram、Discord 等平台,也能把 Hermes Desktop 客户端连上去。首月 $3,之后 $6/月。
下一步
- Hermes Agent 中文介绍
- 安装与配置 — docker-compose 一键部署
- 接入飞书
- 网关配对说明