← All connection guides

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 --write

Create 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 gateway

4. 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

  1. 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