Matrix
Matrix Setup Hermes Agent integrates with Matrix, the open, federated messaging protocol. Matrix lets you run your own homeserver or use a public one like matri
Hermes Agent integrates with Matrix, the open, federated messaging protocol. Matrix lets you run your own homeserver or use a public one like matrix.org — either way, you keep control of your communications. …
What this page covers
- How Hermes Behaves
- Capability Matrix
- Session Model in Matrix
- Mention and Threading Configuration
- Project Room Isolation
- Step 1: Create a Bot Account
- Option A: Register on Your Homeserver (Recommended)
- Option B: Use matrix.org or Another Public Homeserver
- Option C: Use Your Own Account
- Step 2: Get an Access Token
- Option A: Access Token (Recommended)
- Option B: Password Login
- Step 3: Find Your Matrix User ID
- Step 4: Configure Hermes Agent
- Option A: Interactive Setup (Recommended)
- Option B: Manual Configuration
- Private Deployment Hardening
- Start the Gateway
- End-to-End Encryption (E2EE)
- Requirements
- Enable E2EE
- Matrix Tools and Controls
- Media Limits
- Synapse Integration Tests
- Cross-Signing Verification (Recommended)
- Home Room
- Using the Slash Command
- Manual Configuration
- Room allowlist (allowedrooms)
- Commands in Matrix
- Troubleshooting
- Bot is not responding to messages
- Bot joins rooms but silently drops every message (clock skew)
- "Failed to authenticate" / "whoami failed" on startup
- "mautrix not installed" error
- Encryption errors / "could not decrypt event"
- Upgrading from a previous version with E2EE
- Proxy Mode (E2EE on macOS)
- How It Works
- Step 1: Configure the Host (macOS)
- Step 2: Configure the Docker Container (Linux VM)
- Step 3: Start Both
- Configuration Reference
- Works for Any Platform
- Bot connects and sends, but ignores inbound messages
- Sync issues / bot falls behind
- Bot is offline
- "User not allowed" / Bot ignores you
- Bot ignores an entire room
- Bridge messages loop or echo
- Security
- Notes
Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.
More in Messaging Platforms
Messaging Gateway
Chat with Hermes from Telegram, Discord, Slack, WhatsApp, Signal, SMS, Email, Home Assistant, Mattermost, Matrix, DingTalk, Feishu/Lark, WeCom, Weixin, BlueBubb
Telegram
Telegram Setup Hermes Agent integrates with Telegram as a full featured conversational bot. Once connected, you can chat with your agent from any device, send v
Discord
Discord Setup Hermes Agent integrates with Discord as a bot, letting you chat with your AI assistant through direct messages or server channels. The bot receive
Slack
Slack Setup Connect Hermes Agent to Slack as a bot using Socket Mode. Socket Mode uses WebSockets instead of public HTTP endpoints, so your Hermes instance does
WhatsApp Setup Hermes connects to WhatsApp through a built in bridge based on Baileys . This works by emulating a WhatsApp Web session — not through the officia
Signal
Signal Setup Hermes connects to Signal through the signal cli daemon running in HTTP mode. The adapter streams messages in real time via SSE (Server Sent Events