1---2name: hermes-gateways-23description: 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).4metadata:5 source: https://skillmd.com/skills/fusengine/hermes-gateways-26---78<objective>9Connect one or more Hermes Agent profiles to messaging platforms through the10single multiplexed gateway, route proactive output (briefs, alerts, decisions)11to the right channel, and give the agent a voice that keeps working. Every key,12flag and env var below was read in the official 0.23.0 docs or source; anything13that is a design pattern rather than a Hermes feature is labelled **Pattern**.14</objective>1516# Hermes Gateways1718## Freshness check1920Before writing or changing any Hermes config, run `hermes --version` and21`hermes update --check`, then read22https://github.com/NousResearch/hermes-agent/releases/latest. If the installed23or latest version is newer than 0.23.0, read every release note since 0.23.024("Upgrade notes" first) and adjust. Never apply guidance from this skill to a25newer version without that check.2627## Native vs pattern2829| Need | Status in 0.23.0 | Where |30|------|------------------|-------|31| One gateway process serving every profile | Native, default (`gateway.multiplex_profiles`) | [multiplex-gateway.md](references/multiplex-gateway.md) |32| Slack / Telegram / Discord / Email adapters | Native, bundled platform plugins (auto-loaded) | [messaging-adapters.md](references/messaging-adapters.md) |33| Several mailboxes for one owner | **Pattern** - one Email adapter = one mailbox per profile | [messaging-adapters.md](references/messaging-adapters.md#several-mailboxes) |34| 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) |35| TTS / STT providers, `/voice` modes | Native | [voice.md](references/voice.md) |36| Replies written for the ear | **Pattern** (prompt rules) + native normalisation knobs | [voice.md](references/voice.md#written-for-the-ear) |37| 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) |3839## Decision map4041| Question | Load |42|----------|------|43| How many gateway processes? Park one profile? Shared bot token (`profile_routes`)? Agent-to-agent (`a2a`)? | [multiplex-gateway.md](references/multiplex-gateway.md) |44| Enable Slack/Telegram/Discord/Email, allowlists, pairing | [messaging-adapters.md](references/messaging-adapters.md) |45| Where do briefs, alerts, failures and decisions land? | [notification-routing.md](references/notification-routing.md) |46| Voice in/out, providers, voice that degrades gracefully | [voice.md](references/voice.md) |47| Ready-to-fill files | [templates/](references/templates/) |4849## Critical rules50511. **One host gateway.** Never `gateway install` a named profile on a52 multiplexed host; it refuses (exit 78). Manage a served profile with53 `hermes -p <name> gateway stop|start|restart` (park / unpark / reconnect).542. **One bot credential = one profile.** The same `(platform, token)` in two55 profiles parks the duplicate adapter (`duplicate_credential`).563. **Secrets in each profile's `.env`, never in `config.yaml`.** Credentials,57 allowlists and outbound egress (cron delivery, `hermes send`; `send_message`58 is not a model-callable tool at v0.23.0 - tools/send_message_tool.py L28-30,59 toolsets.py L186-187) are resolved per profile and never fall back to the60 default profile.614. **Allowlist every adapter.** The gateway denies unlisted users by default;62 never set `GATEWAY_ALLOW_ALL_USERS=true` on a profile with terminal access.635. **The Email adapter replies by itself** (SMTP, in-thread). Never point it at64 a mailbox where "nothing leaves without the owner's go" applies - use a65 dedicated agent address, or read-only triage (hermes-mail-triage) plus the66 go gate (hermes-security).676. **Explicit `stt.provider` is strict** (no silent engine switch), and there is68 no automatic TTS provider fallback: a backup voice is something you build.697. Restart the gateway after editing platform config70 (`hermes gateway restart` on the default profile), then confirm with71 `hermes gateway status` and `/platform list`.7273## Workflow74751. Freshness check, then `hermes gateway status` and `hermes status --full`76 to see the host process and served profiles.772. Per profile: fill `.env` from [profile.env.example](references/templates/profile.env.example)78 (`hermes -p <name> config set UPPER_SNAKE value` writes to that `.env`).793. Per profile: merge [gateway-config.yaml](references/templates/gateway-config.yaml)80 into its `config.yaml` (`hermes -p <name> config edit`).814. Route proactive output ([notification-routing.md](references/notification-routing.md)),82 then test with `hermes -p <name> send --to <target> "routing test"`.835. Voice: pick providers, then install the backup-voice pattern if voice84 matters ([voice.md](references/voice.md)).856. Verify: `hermes doctor`, `hermes gateway status`, one real message per86 platform, one voice note round trip.8788## Sources8990- https://hermes-agent.nousresearch.com/docs/user-guide/multi-profile-gateways91- https://hermes-agent.nousresearch.com/docs/user-guide/messaging/92- https://hermes-agent.nousresearch.com/docs/user-guide/messaging/slack93- https://hermes-agent.nousresearch.com/docs/user-guide/messaging/email94- https://hermes-agent.nousresearch.com/docs/user-guide/features/tts95- https://hermes-agent.nousresearch.com/docs/user-guide/features/voice-mode96- https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins (bundled platform plugins)97- https://hermes-agent.nousresearch.com/docs/reference/cli-commands (`hermes send`, `hermes config`)98- https://github.com/NousResearch/hermes-agent/releases/tag/v0.23.0 ("Every messaging adapter is now a plugin")