Hermes Slack Setup: Connect Hermes Agent to Slack
Connect Hermes Agent to Slack with app permissions, channel tests, gateway config, troubleshooting checks, and team-safe automation patterns.
Quick answer
Hermes Slack setup starts with one private test channel, a Slack app with only the scopes the workflow needs, the token stored in the active Hermes gateway profile, and one verified reply before you add production channels, scheduled reports, or workflow automation.
Connecting Hermes to Slack turns your workspace into an AI-powered command center — your team can ask questions, trigger automations, and get research done without leaving the tools they already use.
Managed cloud · API costs included · Skill library · Cancel anytime
Before you start:
- ☑Hermes Agent installed and running on a publicly accessible server (Slack requires webhook callbacks)
- ☑Slack workspace admin permissions
- ☑A public URL or ngrok tunnel for local development
Steps
- 1
Create a Slack app for Hermes
Create a Slack app in the target workspace and install it into one private test channel before exposing it to production channels.
- 2
Add the minimum Slack scopes
Grant only the bot scopes needed for reading selected messages and posting replies. Avoid broad workspace access until the first workflow is verified.
- 3
Store the token in the active Hermes profile
Put the Slack token in the active Hermes gateway profile or environment, not in prompts, screenshots, or committed repository files.
- 4
Restart the Hermes gateway
Restart the gateway and verify the process is using the same profile and token you edited.
- 5
Verify one private channel reply
Send one harmless test message in the private channel, check logs, and only then add production channels, scheduled reports, or workflow automation.
Pro Tips
- 💡Use Socket Mode in Slack's developer settings for local development — it doesn't require a public URL and is easier to set up for testing
- 💡Restrict Hermes to specific Slack channels using 'slack: allowedChannelIds' to prevent it from responding everywhere
- 💡Slack's rate limits are strict — configure response batching if Hermes sends many messages quickly
Troubleshooting
❌ Slack app shows 'not responding' when mentioned
✅ Slack requires a response within 3 seconds. Enable async response mode in config.yaml so Hermes acknowledges immediately and follows up with the full response.
❌ OAuth scopes error when installing to workspace
✅ Make sure you've added all required bot token scopes: chat:write, channels:history, im:history, and app_mentions:read. Missing scopes require reinstalling the app.
❌ Hermes not receiving messages in private channels
✅ Hermes must be explicitly invited to private channels with '/invite @hermes'. Bot scopes don't grant access to private channels by default.
FAQ
How do I set up Hermes Slack?
Create a Slack app, install it into a private test channel, store the token in the active Hermes gateway profile, restart the gateway, then verify one reply before adding production channels.
Can Hermes Agent post scheduled reports to Slack?
Yes. Use Hermes cron with an explicit delivery target after the Slack gateway is verified. Start with a harmless test report before sending production alerts.