Gateway de mesagerie: Telegram, Discord, Slack și alte platforme în Hermes Agent CLI

Extensibilitate și Automatizări Hermes Agent v0.22 (oct. 2026)

Cum conectezi Hermes la Telegram, Discord, Slack și alte platforme, cum limitezi accesul și cum separi administratorii de utilizatori.

Sintaxă & invocare
hermes gateway setup   →   hermes gateway start   →   hermes pairing approve <platformă> <cod>

Ce face Gateway de mesagerie: Telegram, Discord, Slack și alte platforme

Gateway-ul te lasă să vorbești cu Hermes de pe Telegram, Discord, Slack, WhatsApp, Signal, SMS, e-mail, Matrix, Mattermost, Microsoft Teams, LINE și alte platforme. Nu există un flag --channel: platformele se configurează cu hermes gateway setup, iar tokenii și listele de utilizatori ajung în ~/.hermes/.env. Pornești apoi serviciul cu hermes gateway start sau în prim-plan cu hermes gateway run.

Implicit, gateway-ul refuză pe oricine nu este pe o listă de acces sau împerecheat. Listele se dau prin variabile ca TELEGRAM_ALLOWED_USERS, DISCORD_ALLOWED_USERS sau GATEWAY_ALLOWED_USERS. Alternativ, un utilizator necunoscut primește în DM un cod de împerechere, pe care îl aprobi cu hermes pairing approve; codurile expiră după o oră.

Pe lângă acces, poți separa administratorii de utilizatorii obișnuiți: în blocul extra: al platformei, allow_admin_from listează administratorii, iar user_allowed_commands comenzile slash permise celorlalți (plus /help și /whoami). Fiecare chat are sesiunea lui persistentă, iar /sethome marchează chatul curent drept canal implicit pentru livrări (cron, /handoff).

Sintaxă și opțiuni

Opțiune / Parametru Descriere
hermes gateway setup Asistent interactiv pentru toate platformele.
TELEGRAM_ALLOWED_USERS, DISCORD_ALLOWED_USERS, … Liste de ID-uri permise, per platformă, în ~/.hermes/.env.
GATEWAY_ALLOWED_USERS Listă comună pentru toate platformele.
GATEWAY_ALLOW_ALL_USERS=true Permite oricui; nerecomandat pentru boți cu acces la terminal.
hermes pairing approve <platformă> <cod> Aprobă un utilizator care a primit cod în DM.
allow_admin_from / user_allowed_commands Separarea admin / utilizator, per platformă și per scop (DM vs. grup).
/sethome Chatul curent devine canalul home al platformei.
/approve, /deny Aprobi sau refuzi din chat o comandă periculoasă în așteptare.

Exemple practice

Exemplul 1: Configurare și pornire

hermes gateway setup
hermes gateway start

Exemplul 2: Listă de acces în ~/.hermes/.env

TELEGRAM_ALLOWED_USERS=123456789,987654321

Exemplul 3: Aprobarea unui cod de împerechere

Codul din exemplul oficial:

hermes pairing approve telegram XKGH5N7P

Exemplul 4: Admini și comenzi permise (config.yaml)

gateway:
  platforms:
    discord:
      extra:
        allow_from: ["111", "222", "333"]
        allow_admin_from: ["111"]
        user_allowed_commands: [status, model]

Greșeli frecvente și bune practici

  • Setezi GATEWAY_ALLOW_ALL_USERS=true pe un bot care are acces la terminal.
  • Crezi că statutul de admin din DM se aplică și în grupuri. Fiecare scop are lista lui (group_allow_admin_from).
  • Pe Slack trimiți comenzi slash într-un fir. Slack nu le livrează; folosește prefixul ! (!stop, !new).

Comenzi înrudite