1---2name: hermes-gateways3description: Use when wiring Hermes Agent to the outside world - the single multi-profile gateway (default since v0.22.0), one shared bot routed to profiles (`gateway.profile_routes`), agent-to-agent calls (`a2a` platform), messaging adapters (Slack, Telegram, Discord, Email and the other bundled platform plugins), several mailboxes, home channels and routing notifications to a dedicated channel, `hermes send`, voice replies (TTS/STT providers, `/voice`), written-for-the-ear replies, or a backup voice when a TTS provider fails. Not for approvals and send gating (hermes-security), cron schedules (hermes-cron) or plugin/MCP management (hermes-extend).4versions:5 hermes-agent: "0.23.0"6user-invocable: false7references:8 - references/multiplex-gateway.md9 - references/messaging-adapters.md10 - references/notification-routing.md11 - references/voice.md12 - references/templates/gateway-config.yaml13 - references/templates/profile.env.example14 - references/templates/tts-healthcheck.sh15related-skills:16 - hermes-core17 - hermes-cron18 - hermes-security19 - hermes-extend20 - hermes-mail-triage21 - hermes-rhythm22metadata:23 source: https://skillmd.com/skills/fusengine/hermes-gateways24---2526<objective>27Connect one or more Hermes Agent profiles to messaging platforms through the28single multiplexed gateway, route proactive output (briefs, alerts, decisions)29to the right channel, and give the agent a voice that keeps working. Every key,30flag and env var below was read in the official 0.23.0 docs or source; anything31that is a design pattern rather than a Hermes feature is labelled **Pattern**.32</objective>3334# Hermes Gateways3536## Freshness check3738Before writing or changing any Hermes config, run `hermes --version` and39`hermes update --check`, then read40https://github.com/NousResearch/hermes-agent/releases/latest. If the installed41or latest version is newer than 0.23.0, read every release note since 0.23.042("Upgrade notes" first) and adjust. Never apply guidance from this skill to a43newer version without that check.4445## Native vs pattern4647| Need | Status in 0.23.0 | Where |48|------|------------------|-------|49| One gateway process serving every profile | Native, default (`gateway.multiplex_profiles`) | [multiplex-gateway.md](references/multiplex-gateway.md) |50| Slack / Telegram / Discord / Email adapters | Native, bundled platform plugins (auto-loaded) | [messaging-adapters.md](references/messaging-adapters.md) |51| Several mailboxes for one owner | **Pattern** - one Email adapter = one mailbox per profile | [messaging-adapters.md](references/messaging-adapters.md#several-mailboxes) |52| Proactive output to a dedicated channel | Native targets (`deliver`, `hermes send`, home channel) + **Pattern** for a "decisions" channel | [notification-routing.md](references/notification-routing.md) |53| TTS / STT providers, `/voice` modes | Native | [voice.md](references/voice.md) |54| Replies written for the ear | **Pattern** (prompt rules) + native normalisation knobs | [voice.md](references/voice.md#written-for-the-ear) |55| Backup voice when the TTS provider fails | **Pattern** - no native TTS fallback chain | [voice.md](references/voice.md#backup-voice-pattern) + [tts-healthcheck.sh](references/templates/tts-healthcheck.sh) |5657## Decision map5859| Question | Load |60|----------|------|61| How many gateway processes? Park one profile? Shared bot token (`profile_routes`)? Agent-to-agent (`a2a`)? | [multiplex-gateway.md](references/multiplex-gateway.md) |62| Enable Slack/Telegram/Discord/Email, allowlists, pairing | [messaging-adapters.md](references/messaging-adapters.md) |63| Where do briefs, alerts, failures and decisions land? | [notification-routing.md](references/notification-routing.md) |64| Voice in/out, providers, voice that degrades gracefully | [voice.md](references/voice.md) |65| Ready-to-fill files | [templates/](references/templates/) |6667## Critical rules68691. **One host gateway.** Never `gateway install` a named profile on a70 multiplexed host; it refuses (exit 78). Manage a served profile with71 `hermes -p <name> gateway stop|start|restart` (park / unpark / reconnect).722. **One bot credential = one profile.** The same `(platform, token)` in two73 profiles parks the duplicate adapter (`duplicate_credential`).743. **Secrets in each profile's `.env`, never in `config.yaml`.** Credentials,75 allowlists and outbound egress (cron delivery, `hermes send`; `send_message`76 is not a model-callable tool at v0.23.0 - tools/send_message_tool.py L28-30,77 toolsets.py L186-187) are resolved per profile and never fall back to the78 default profile.794. **Allowlist every adapter.** The gateway denies unlisted users by default;80 never set `GATEWAY_ALLOW_ALL_USERS=true` on a profile with terminal access.815. **The Email adapter replies by itself** (SMTP, in-thread). Never point it at82 a mailbox where "nothing leaves without the owner's go" applies - use a83 dedicated agent address, or read-only triage (hermes-mail-triage) plus the84 go gate (hermes-security).856. **Explicit `stt.provider` is strict** (no silent engine switch), and there is86 no automatic TTS provider fallback: a backup voice is something you build.877. Restart the gateway after editing platform config88 (`hermes gateway restart` on the default profile), then confirm with89 `hermes gateway status` and `/platform list`.9091## Workflow92931. Freshness check, then `hermes gateway status` and `hermes status --full`94 to see the host process and served profiles.952. Per profile: fill `.env` from [profile.env.example](references/templates/profile.env.example)96 (`hermes -p <name> config set UPPER_SNAKE value` writes to that `.env`).973. Per profile: merge [gateway-config.yaml](references/templates/gateway-config.yaml)98 into its `config.yaml` (`hermes -p <name> config edit`).994. Route proactive output ([notification-routing.md](references/notification-routing.md)),100 then test with `hermes -p <name> send --to <target> "routing test"`.1015. Voice: pick providers, then install the backup-voice pattern if voice102 matters ([voice.md](references/voice.md)).1036. Verify: `hermes doctor`, `hermes gateway status`, one real message per104 platform, one voice note round trip.105106## Sources107108- https://hermes-agent.nousresearch.com/docs/user-guide/multi-profile-gateways109- https://hermes-agent.nousresearch.com/docs/user-guide/messaging/110- https://hermes-agent.nousresearch.com/docs/user-guide/messaging/slack111- https://hermes-agent.nousresearch.com/docs/user-guide/messaging/email112- https://hermes-agent.nousresearch.com/docs/user-guide/features/tts113- https://hermes-agent.nousresearch.com/docs/user-guide/features/voice-mode114- https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins (bundled platform plugins)115- https://hermes-agent.nousresearch.com/docs/reference/cli-commands (`hermes send`, `hermes config`)116- https://github.com/NousResearch/hermes-agent/releases/tag/v0.23.0 ("Every messaging adapter is now a plugin")