Web Dashboard#
Web Dashboard 是一个基于浏览器的 UI,用于管理你的 Hermes Agent 安装。无需编辑 YAML 文件或运行 CLI 命令,即可通过简洁的 Web 界面配置设置、管理 API 密钥并监控会话。快速开始#
这将启动一个本地 Web 服务器,并在浏览器中打开 http://127.0.0.1:9119。Dashboard 完全在你的机器上运行——数据不会离开 localhost。| 标志 | 默认值 | 描述 |
|---|
--port | 9119 | Web 服务器运行端口 |
--host | 127.0.0.1 | 绑定地址 |
--no-open | — | 不自动打开浏览器 |
--insecure | 关闭 | 允许绑定到非 localhost 主机(危险——会在网络上暴露 API 密钥;请配合防火墙和强认证使用) |
--tui | 关闭 | 启用浏览器内 Chat 标签页(通过 PTY/WebSocket 嵌入 hermes --tui)。也可设置 HERMES_DASHBOARD_TUI=1。 |
前置条件#
默认的 hermes-agent 安装不包含 HTTP 栈或 PTY 辅助工具——这些是可选扩展。Web Dashboard 需要 FastAPI 和 Uvicorn(web 扩展)。Chat 标签页还需要 ptyprocess 来在伪终端(pseudo-terminal)后面启动嵌入式 TUI(POSIX 上的 pty 扩 展)。使用以下命令同时安装:web 扩展会引入 FastAPI/Uvicorn;pty 扩展会引入 ptyprocess(POSIX)或 pywinpty(原生 Windows——注意嵌入式 TUI 本身仍需要 WSL)。pip install hermes-agent[all] 包含两个扩展,如果你还需要消息/语音等功能,这是最简便的方式。在没有依赖项的情况下运行 hermes dashboard 时,它会告诉你需要安装什么。如果前端尚未构建且 npm 可用,则会在首次启动时自动构建。Chat 标签页在普通 hermes dashboard 启动时默认关闭。如需嵌入式浏览器聊天面板,请使用 hermes dashboard --tui 启动,或设置 HERMES_DASHBOARD_TUI=1。Status(状态)#
Gateway 状态——运行中/已停止、PID、已连接平台及其状态
最近会话——最近 20 个会话的列表,包含模型、消息数、token 用量和对话预览
Chat(聊天)#
Chat 标签页将完整的 Hermes TUI(与 hermes --tui 相同的界面)直接嵌入浏览器。你在终端 TUI 中能做的一切——斜杠命令、模型选择器、工具调用卡片、Markdown 流式输出、clarify/sudo/approval 提示、皮肤主题——在这里都完全一致,因为 Dashboard 运行的是真实的 TUI 二进制文件,并通过 xterm.js 的 WebGL 渲染器以像素级精度渲染其 ANSI 输出。/api/pty 打开一个经 Dashboard 会话 token 认证的 WebSocket
服务器在 POSIX 伪终端后面启动 hermes --tui
xterm.js 的 WebGL 渲染器将每个单元格绘制到整数像素网格;鼠标追踪(SGR 1006)、宽字符(Unicode 11)和方框绘制字形均原生渲染
调整浏览器窗口大小会通过 @xterm/addon-fit 插件调整 TUI 大小
恢复已有会话: 在 Sessions 标签页中,点击任意会话旁的播放图标(▶)。这会跳转到 /chat?resume=<id> 并以 --resume 参数启动 TUI,加载完整历史记录。Node.js(与 hermes --tui 相同的要求;TUI 包在首次启动时构建)
ptyprocess——由 pty 扩展安装(pip install 'hermes-agent[web,pty]',或 [all] 同时包含两者)
POSIX 内核(Linux、macOS 或 WSL2)。/chat 终端面板特别需要 POSIX PTY——原生 Windows Python 没有等效实现,因此在原生 Windows 安装上,Dashboard 的其余部分(sessions、jobs、metrics、config editor)可以正常工作,但 /chat 标签页会显示提示,告知你需要使用 WSL2 才能使用该功能。
关闭浏览器标签页后,PTY 会在服务器端被干净地回收。重新打开会启动一个新会话。Config(配置)#
config.yaml 的表单式编辑器。所有 150+ 个配置字段均从 DEFAULT_CONFIG 自动发现,并按标签页分类组织:model — 默认模型、提供商、基础 URL、推理设置
terminal — 后端(local/docker/ssh/modal)、超时、Shell 偏好
display — 皮肤、工具进度、恢复显示、spinner 设置
agent — 最大迭代次数、gateway 超时、服务层级
delegation — 子 agent 限制、推理力度
approvals — 危险命令审批模式(ask/yolo/deny)
更多——config.yaml 的每个部分都有对应的表单字段
具有已知有效值的字段(terminal 后端、皮肤、审批模式等)渲染为下拉菜单。布尔值渲染为开关。其余均为文本输入框。Save — 立即将更改写入 config.yaml
Reset to defaults — 将所有字段恢复为默认值(点击 Save 前不会保存)
Import — 上传 JSON 配置文件以替换当前值
配置更改在下一次 agent 会话或 gateway 重启时生效。Web Dashboard 编辑的是 hermes config set 和 gateway 读取的同一个 config.yaml 文件。
API Keys(API 密钥)#
管理存储 API 密钥和凭据的 .env 文件。密钥按类别分组:LLM Providers — OpenRouter、Anthropic、OpenAI、DeepSeek 等
Tool API Keys — Browserbase、Firecrawl、Tavily、ElevenLabs 等
Messaging Platforms — Telegram、Discord、Slack bot token 等
Agent Settings — 非敏感环境变量,如 API_SERVER_ENABLED
Sessions(会话 )#
浏览和检查所有 agent 会话。每行显示会话标题、来源平台图标(CLI、Telegram、Discord、Slack、cron)、模型名称、消息数、工具调用数以及最后活跃时间。实时会话以脉冲徽章标记。Search — 使用 FTS5 对所有消息内容进行全文搜索。结果显示高亮片段,展开时自动滚动到第一条匹配消息。
Expand — 点击会话以加载完整消息历史。消息按角色(user、assistant、system、tool)用颜色区分,并以带语法高亮的 Markdown 渲染。
Tool calls — 包含工具调用的 assistant 消息显示可折叠块,包含函数名和 JSON 参数。
Delete — 使用垃圾桶图标删除会话及其消息历史。
Logs(日志)#
查看 agent、gateway 和错误日志文件,支持过滤和实时追踪。File — 在 agent、errors 和 gateway 日志文件之间切换
Level — 按日志级别过滤:ALL、DEBUG、INFO、WARNING 或 ERROR
Component — 按来源组件过滤:all、gateway、agent、tools、cli 或 cron
Lines — 选择显示行数(50、100、200 或 500)
Auto-refresh — 切换实时追踪,每 5 秒轮询新日志行
Color-coded — 日志行按严重程度着色(错误为红色,警告为黄色,debug 为暗色)
Analytics(分析)#
基于会话历史计算的用量和成本分析。选择时间段(7、30 或 90 天)查看:Summary cards — 总 token 数(输入/输出)、缓存命中率、总估算或实际成本,以及总会话数和日均值
Daily token chart — 堆叠柱状图,显示每日输入和输出 token 用量,悬停提示显示明细和成本
Daily breakdown table — 每日日期、会话数、输入 token、输出 token、缓存命中率和成本
Per-model breakdown — 显示每个使用模型的会话数、token 用量和估算成本的表格
Cron(定时任务)#
创建和管理按定期计划运行 agent prompt 的定时任务。Create — 填写名称(可选)、prompt、cron 表达式(如 0 9 * * *)和投递目标(local、Telegram、Discord、Slack 或 email)
Job list — 每个任务显示其名称、prompt 预览、计划表达式、状态徽章(enabled/paused/error)、投递目标、上次运行时间和下次运行时间
Pause / Resume — 在活跃和暂停状态之间切换任务
Trigger now — 在正常计划之外立即执行任务
Skills(技能)#
浏览、搜索和切换技能与工具集。技能从 ~/.hermes/skills/ 加 载,并按类别分组。Search — 按名称、描述或类别过滤技能和工具集
Category filter — 点击类别标签缩小列表范围(如 MLOps、MCP、Red Teaming、AI)
Toggle — 使用开关启用或禁用单个技能。更改在下一次会话时生效。
Toolsets — 单独的部分显示内置工具集(文件操作、Web 浏览等),包含其活跃/非活跃状态、设置要求和包含的工具列表
Web Dashboard 会读写包含 API 密钥和机密的 .env 文件。它默认绑定到 127.0.0.1——只能从本机访问。如果绑定到 0.0.0.0,网络上的任何人都可以查看和修改你的凭据。Dashboard 本身没有任何认证机制。
/reload 斜杠命令