Hermes Agent HelperHermes Agent Helper

Hermes 服务管理工具

轻量级 Web 界面，通过浏览器远程管理你的 Hermes Agent 服务器配置。

工具简介

Hermes 服务管理工具是一个部署在你的 Hermes Agent 服务器上的轻量级 HTTP/HTTPS 服务器。它提供 Web 界面，让你可以通过浏览器远程编辑 config.yaml 和 .env 配置文件，无需 SSH 登录。

此外，它还支持在浏览器终端中执行交互式 hermes 命令（如 hermes model），让你可以随时配置模型、查看状态等，非常适合不熟悉命令行的用户。

核心功能

配置编辑器

以表单形式编辑 config.yaml 和 .env，修改项绿色高亮显示

交互式终端

支持 PTY 的 hermes 子命令执行（如 hermes model）

系统认证

通过 Linux PAM 验证服务器密码，安全可靠

内置 HTTPS

原生 HTTPS 支持（rustls），无需 nginx

飞书快捷配置

一键填入飞书 App ID/Secret 和用户 ID，自动写入配置并重启

Telegram 快捷配置

一键填入 Bot Token，自动写入配置并重启

QQ 快捷配置

一键填入 QQ App ID/Secret 和用户 ID，自动写入配置并重启

Discord 快捷配置

一键填入 Bot Token 和用户 ID，自动写入配置并重启

Banana 2 Pro 配置

快捷配置大模型 API Key，无需手动编辑环境变量

多语言支持

支持中文和英文界面切换

如何访问

如果你使用我们的托管部署服务，Hermes 服务管理工具已预装在你的服务器上。

  1. 1在浏览器中访问 https://[你的服务器IP]:9800
  2. 2接受自签名证书警告（首次访问）
  3. 3输入服务器 root 密码进行认证
  4. 4开始编辑配置或执行 hermes 命令
功能标签页
工具界面分为以下标签页，点击标签切换：

配置 (Config)

编辑 Hermes 的 config.yaml 主配置文件，包括网关设置、模型配置等。修改后点击「保存更改」会自动重启服务。

环境变量 (Environment)

编辑 .env 环境变量文件，通常用于存储 API Key 等敏感信息。

飞书配置 (Feishu Setup)

快捷配置飞书消息平台。填入 App ID、App Secret 和飞书用户 ID，点击完成配置即可自动写入并重启网关。

Telegram 配置 (Telegram Setup)

快捷配置 Telegram 消息平台。填入 Bot Token，点击完成配置即可自动写入并重启网关。

QQ 配置 (QQ Setup)

快捷配置 QQ 消息平台。填入 App ID、App Secret 和 QQ 用户 ID，点击完成配置即可自动写入并重启网关。

Discord 配置 (Discord Setup)

快捷配置 Discord 消息平台。填入 Bot Token 和用户 ID，点击完成配置即可自动写入并重启网关。

Banana 2 Pro (LLM API)

配置大模型 API Key。兑换额度后在此填入 API Key，即可使用大模型服务。

终端 (Terminal)

在浏览器中执行 hermes 命令。支持交互式输入，但注意：不支持方向键选择，请使用数字输入进行选择。

使用教程

1. 登录

打开工具页面后，输入服务器 root 密码进行认证。登录后会话有效期为 20 分钟，超时需重新登录。

2. 编辑配置

在「配置」或「环境变量」标签页中，直接编辑对应字段。修改过的字段会显示绿色高亮。编辑完成后点击底部的「保存更改」按钮。

3. 保存并重启

点击保存后会弹出确认窗口，显示所有修改项。确认后服务会自动重启。重启大约需要 30 秒，期间消息可能无法送达，请稍后重试。

4. 快捷配置消息平台

如果你需要配置飞书或 Telegram，可以直接使用对应的快捷配置标签页，填入必要信息后一键完成配置。

5. 使用终端

在终端标签页中，可以执行 hermes 子命令，如 hermes model list（查看模型列表）、hermes gateway status（查看网关状态）等。输入命令后按回车执行。

常用命令
以下是一些常用的 hermes 命令：
  • hermes model list - 查看当前可用的 AI 模型列表
  • hermes model set - 设置默认 AI 模型
  • hermes gateway status - 查看消息网关状态
  • hermes gateway setup - 重新配置消息网关（如微信扫码）
  • hermes skill list - 查看已安装的技能
  • hermes skill install [name] - 安装新技能
  • hermes pairing approve [platform] [id] - 批准消息平台配对请求
命令限制
为安全起见，工具仅允许执行以下 hermes 命令：

允许执行

  • hermes model
  • hermes config show
  • hermes version
  • hermes status

禁止执行

  • hermes (裸命令)
  • hermes chat
  • 任何包含 Shell 元字符的命令
常见问题

登录失败，提示密码错误？

请确认输入的是服务器 root 用户密码（部署完成时邮件发送的密码），不是其他账号密码。

保存配置后消息收不到？

保存配置会触发网关重启，大约需要 30 秒。在此期间发送的消息可能无法送达，请稍后重新发送。

终端命令执行没有响应？

请检查命令格式是否正确，必须以 hermes 开头。如果是交互式命令（如选择列表），请用数字输入而不是方向键。

页面显示「Network error」？

请检查网络连接，确认服务器 IP 和端口正确。如果使用自签名证书，请确保已接受浏览器安全警告。

如何重新生成微信二维码？

在终端中执行 hermes gateway setup，按提示操作即可重新生成授权二维码。

安全特性
  • 内置 HTTPS：配置 TLS 段后直接提供 HTTPS 服务，支持自签名证书
  • 频率限制：5 次登录失败后锁定 IP 10 分钟
  • 输入保护：所有表单输入框禁用自动填充，页面关闭时清除 token
  • 命令白名单：仅允许 hermes 子命令，Shell 元字符全部拦截
  • 会话过期：token 20 分钟后自动过期（可配置）
数据隐私声明
  • 此工具完全部署在你自己的服务器上，不会将任何数据发送到 Hermes Agent Helper 或其他外部服务。
  • 所有配置文件和命令执行记录都存储在你的服务器本地，我们无法访问、收集或查看你的任何数据。
  • 工具的认证系统使用你服务器自身的 Linux PAM 模块，密码不会被传输或存储到任何外部位置。
注意事项

此工具需要 root 权限运行，用于 PAM 认证和配置文件读写。工具为每位托管用户免费提供，已预装在服务器上，无需手动安装。