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=truepe 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).