How to connect Hermes Agent to Slack
Connect Hermes to Slack with a generated app manifest, Socket Mode, bot and app tokens, and a member allowlist.
Free guide · Updated
Based on official documentation · Checked
Ask your agent
Copy the prompt and paste it into your assistant.
Quick answer
Use Hermes’s Slack integration with Socket Mode. The gateway opens a WebSocket connection, so it does not need a public webhook URL. You need two separate credentials: a bot token starting xoxb- and an app-level token starting xapp-.
1. Generate the Slack manifest
For a new app, run the documented Agent-view manifest command:
hermes slack manifest --agent-view --writeCreate the Slack app
Open api.slack.com/apps, choose Create New App and From an app manifest, select your workspace and paste the generated ~/.hermes/slack-manifest.json contents. Review the requested permissions. The manifest supplies the event subscriptions, slash commands and Socket Mode settings. Use it for a new app; migrating an existing Slack messaging experience has separate consequences.
2. Obtain both tokens
Install the app to the workspace to get its Bot User OAuth Token. In Basic Information, create an App-Level Token with connections:write for Socket Mode. Workspace approval may be required. Keep both token values private; they are not interchangeable.
3. Configure Hermes
Copy your Slack Member ID from your profile’s menu. Run gateway setup, choose Slack and provide the tokens and allowed member IDs. Then start the gateway:
hermes gateway setup
hermes gateway4. Open a conversation
Send the app a DM. For a channel, invite the bot with /invite @YourBotName, using its actual Slack name. It does not join every channel automatically. Member IDs control who can use Hermes; channel membership controls where Slack delivers messages.
Practice
Check a complete reply
- Send a simple question in a DM, then mention the bot in a channel you invited it to.
Output: A reply appears in the correct conversation, using your configured Hermes model provider.
Troubleshooting and removal
DMs disabled: check the Messages tab and its permission to send messages. DMs work but channels fail: inspect channel invitation, history scopes and event subscriptions. After changing scopes, reinstall the Slack app when prompted. To disconnect, stop the relevant gateway and revoke that app’s credentials without disabling unrelated workspace apps.
Sources
Read the primary material
- Hermes SlackNous Research / Hermes Agent