Skip to content
BENIBIX Learn

Hermes Gateway Allowlist

AI🪽 Hermes AgentHermes Gateway

Also known as TELEGRAM_ALLOWED_USERS, GATEWAY_ALLOWED_USERS

The list of people the Hermes gateway will answer. All others get no reply.

Think of it like

It is like a guest list at the door. If your name is not on it, you do not get in.

Example

Leo puts his own Telegram user ID in the list. A stranger who finds the bot gets no reply.

Why it matters

A bot that can run shell commands must not answer anyone who happens to find it.

Definition

The gateway allowlist is the list of people who may talk to Hermes Agent from a chat app. By default the gateway turns away all who are not on it or paired, since the bot can run commands on your machine. You write the list in the .env file. Each app gets its own line, or one line can cover all apps.

Example code

console
TELEGRAM_ALLOWED_USERS=123456789,987654321
Only these two Telegram users may talk to the bot.

Common mistake

Turning on the allow all users switch for a quick test, then leaving it on.

Key takeaways

  1. 1
    Deny by default. Safe start.
  2. 2
    Per app or for all. In .env.
  3. 3
    User IDs. Not names.

Compare