Hermes Agent HelperHermes Agent Helper

Hermes Service Manager

A lightweight web interface to remotely manage your Hermes Agent server configuration via browser.

Overview

Hermes Service Manager is a lightweight HTTP/HTTPS server deployed on your Hermes Agent server. It provides a web interface to edit config.yaml and .env configuration files remotely via browser, without SSH access.

Additionally, it supports executing interactive hermes commands (like hermes model) in a browser terminal, allowing you to configure models, check status, and more—perfect for users unfamiliar with command line.

Core Features

Config Editor

Edit config.yaml and .env as forms, with modified fields highlighted in green

Interactive Terminal

PTY-supported hermes subcommand execution (e.g., hermes model)

System Authentication

Server password verification via Linux PAM, secure and reliable

Built-in HTTPS

Native HTTPS support (rustls), no nginx required

Feishu Quick Setup

One-click Feishu App ID/Secret and User ID config, auto-writes and restarts

Telegram Quick Setup

One-click Bot Token config, auto-writes and restarts

QQ Quick Setup

One-click QQ App ID/Secret and User ID config, auto-writes and restarts

Discord Quick Setup

One-click Bot Token and User ID config, auto-writes and restarts

Banana 2 Pro Setup

Quick LLM API Key configuration, no manual env editing needed

Multi-language Support

Supports Chinese and English interface switching

How to Access

If you use our managed deployment service, Hermes Service Manager is pre-installed on your server.

  1. 1Visit https://[your-server-IP]:9800 in browser
  2. 2Accept self-signed certificate warning (first visit)
  3. 3Enter server root password to authenticate
  4. 4Start editing config or executing hermes commands
Interface Tabs
The tool interface is divided into the following tabs, click to switch:

Config

Edit Hermes config.yaml main configuration file, including gateway settings, model configuration, etc. After modifications, click "Save Changes" to automatically restart the service.

Environment

Edit .env environment variables file, typically used for storing sensitive information like API Keys.

Feishu Setup

Quick setup for Feishu messaging platform. Enter App ID, App Secret, and Feishu User ID, click complete to auto-write config and restart gateway.

Telegram Setup

Quick setup for Telegram messaging platform. Enter Bot Token, click complete to auto-write config and restart gateway.

QQ Setup

Quick setup for QQ messaging platform. Enter App ID, App Secret, and QQ User ID, click complete to auto-write config and restart gateway.

Discord Setup

Quick setup for Discord messaging platform. Enter Bot Token and User ID, click complete to auto-write config and restart gateway.

Banana 2 Pro (LLM API)

Configure LLM API Key. After redeeming credits, enter your API Key here to use the LLM service.

Terminal

Execute hermes commands in browser. Supports interactive input, but note: arrow key selection is not supported, please use number input for selections.

Usage Tutorial

1. Login

After opening the tool page, enter the server root password to authenticate. The session is valid for 20 minutes after login, you'll need to re-login after timeout.

2. Edit Configuration

In the "Config" or "Environment" tabs, directly edit the corresponding fields. Modified fields will be highlighted in green. After editing, click the "Save Changes" button at the bottom.

3. Save and Restart

After clicking save, a confirmation window will pop up showing all modifications. After confirmation, the service will restart automatically. Restart takes about 30 seconds, messages may not be delivered during this time, please retry later.

4. Quick Platform Setup

If you need to configure Feishu or Telegram, you can use the corresponding quick setup tabs, fill in the required information and complete with one click.

5. Using Terminal

In the terminal tab, you can execute hermes subcommands like hermes model list (view model list), hermes gateway status (view gateway status), etc. Enter the command and press Enter to execute.

Common Commands
Here are some commonly used hermes commands:
  • hermes model list - View available AI model list
  • hermes model set - Set default AI model
  • hermes gateway status - View messaging gateway status
  • hermes gateway setup - Reconfigure messaging gateway (e.g., WeChat QR code)
  • hermes skill list - View installed skills
  • hermes skill install [name] - Install new skill
  • hermes pairing approve [platform] [id] - Approve messaging platform pairing request
Command Restrictions
For security, the tool only allows executing these hermes commands:

Allowed

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

Blocked

  • hermes (bare command)
  • hermes chat
  • Any command containing shell metacharacters
Troubleshooting

Login failed, password error?

Please confirm you're entering the server root user password (sent via email when deployment completed), not other account passwords.

Can't receive messages after saving config?

Saving config triggers a gateway restart, which takes about 30 seconds. Messages sent during this time may not be delivered, please resend later.

Terminal command not responding?

Please check if the command format is correct, it must start with hermes. For interactive commands (like selection lists), use number input instead of arrow keys.

Page shows "Network error"?

Please check your network connection, confirm server IP and port are correct. If using self-signed certificate, make sure you've accepted the browser security warning.

How to regenerate WeChat QR code?

Execute hermes gateway setup in the terminal and follow the prompts to regenerate the authorization QR code.

Security Features
  • Built-in HTTPS: Direct HTTPS service with TLS config, supports self-signed certificates
  • Rate limiting: IP locked for 10 minutes after 5 failed login attempts
  • Input protection: All form inputs disable autocomplete, token cleared on page close
  • Command whitelist: Only hermes subcommands allowed, all shell metacharacters blocked
  • Session expiry: Token auto-expires after 20 minutes (configurable)
Data Privacy Statement
  • This tool is deployed entirely on your own server and does not send any data to Hermes Agent Helper or any other external service.
  • All configuration files and command execution logs are stored locally on your server. We cannot access, collect, or view any of your data.
  • The tool's authentication system uses your server's own Linux PAM module. Passwords are never transmitted or stored to any external location.
Note

This tool requires root privileges to run, for PAM authentication and config file access. The tool is free for all managed users and pre-installed on your server—no manual installation needed.