DEV Community

Cover image for ๐Ÿš€ Connect Hermes Agent to Discord: Step-by-Step Gateway Setup
Vishnu Damwala
Vishnu Damwala

Posted on • Originally published at meshworld.in

๐Ÿš€ Connect Hermes Agent to Discord: Step-by-Step Gateway Setup

๐Ÿš€ Connect Hermes Agent to Discord: Step-by-Step Gateway Setup

In the recently released v0.17.0 "Reach Release" of Hermes Agent (the open-source autonomous agent framework by Nous Research), setting up platform connections (like Discord, Telegram, and Slack) has migrated to a local browser-based Web Admin Panel, deprecating the older terminal wizards.

Here is the quick checklist to connect your agent to Discord:

1. Discord Developer Portal Config

  • Create a new application at the Discord Developer Portal.
  • Under the Bot tab, generate and copy your Bot Token.
  • Scroll down and enable all three Privileged Gateway Intents (Presence Intent, Server Members Intent, and Message Content Intent). Warning: Message Content Intent is critical; if disabled, the bot cannot read your messages to respond.

2. Invite the Bot

  • Under Installation, configure default scopes to include bot and applications.commands.
  • Check required bot permissions: Send Messages, Read Message History, Send Messages in Threads, View Channel, Add Reactions.
  • Use the generated install link to invite the bot to your Discord server.

3. Configure via Hermes Web UI

  • In your terminal, start the local panel:
  hermes dashboard
Enter fullscreen mode Exit fullscreen mode
  • Open http://127.0.0.1:9119 in your browser.
  • Go to the Gateways tab, click Discord, paste your Bot Token, and hit Save. (You can also set a specific Channel ID filter to prevent the bot from reading all channels).

4. Launch the Bridge

  • Click Start Gateway in the dashboard, or run:
  hermes gateway start
Enter fullscreen mode Exit fullscreen mode
  • Verify status with:
  hermes gateway status
Enter fullscreen mode Exit fullscreen mode

Read the complete gateway setup guide with custom start parameters and troubleshooting details on MeshWorld

Top comments (0)