Connect Hermes Agent to Your Slack Workspace

Turn your Slack workspace into an AI-powered command center with an AI Slack agent. Your team can ask questions, trigger automations, and get research done without leaving the tools they already use.

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.

Before you start

  • Hermes Agent installed and running on a publicly accessible server
  • Slack workspace admin permissions
  • A public URL or ngrok tunnel for local development

Step 1: Create a Slack app for Hermes

Go to the Slack API dashboard and create a new app. Choose From scratch, name it "Hermes", and select your target workspace. Install it into one private test channel before exposing it to production channels.

Step 2: Add the minimum Slack scopes

Grant only the bot token scopes your workflow actually needs. Navigate to OAuth & Permissions and add:

  • chat:write — Send messages as Hermes
  • channels:history — Read channel messages
  • im:history — Read direct messages
  • app_mentions:read — Respond when mentioned

Avoid broad workspace access until the first workflow is verified. If you add scopes after the initial install, you'll need to reinstall the app.

Step 3: Store the token in Hermes

After installing the app to your workspace, copy the Bot User OAuth Token. Store it in the active Hermes gateway profile or environment configuration — never in prompts, screenshots, screenshots, or committed repository files.

If you're using the Hermes config.yaml, add the token under the Slack gateway section and set the profile as active.

Step 4: Restart the Hermes gateway

Restart the Hermes gateway process so it picks up the new token and profile. Verify the process is using the correct profile by checking the startup logs. If you're running Hermes with Docker, restart the container.

Step 5: Verify one private channel reply

Send a harmless test message in your private test channel and mention Hermes. Check the gateway logs to confirm the message was received and a response was sent. Once verified, you can add production channels, scheduled reports, or workflow automation.

/invite @hermes
@hermes hello, can you hear me?

Pro tips

Use Socket Mode for local development

Socket Mode in Slack's developer settings doesn't require a public URL and is much easier to set up for testing. Enable it in your app's Settings page.

Restrict Hermes to specific channels

Use slack: allowedChannelIds in your Hermes configuration to prevent the agent from responding in every channel.

Configure response batching

Slack's rate limits are strict. If Hermes sends many messages quickly, configure response batching in the gateway settings to avoid hitting limits.

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 the message immediately and follows up with the full response.

OAuth scopes error when installing

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

Related articles

The End of Infinite Tabs: Why Your Next Software Shouldn't Be a Web App — It Should Be a Slack Bot

Slack-native bots eliminate context friction and reduce context switching. Why the web app portal paradigm is ending for internal B2B tools.

Custom Slack App vs Buying Another Tool: When to Build vs Buy

A framework for deciding when to build a custom Slack app instead of buying another SaaS tool. Learn when custom Slack apps, workflows, and automation make sense.

Google Analytics Insights in Slack: Real-Time Marketing Monitoring Without Dashboard Fatigue

Monitor GA4, Google Ads, Meta Ads, Search Console, and Shopify directly in Slack with intelligent alerts for marketing and ecommerce teams.

Your Team Is Sitting on an AI Feature They Probably Scrolled Right Past

Slack quietly shipped Skills for Slackbot — encode repeatable processes your team can build, share, and reuse without writing code.

Slack and Jira Integration Best Practices: Automate Ticket Management and PR Reviews

Best practices for connecting Jira with Slack — instant issue lookups, smart notifications, slash commands, and automated ticket creation via Workflow Builder.

How to Send Emails to Slack: Complete Guide with 3 Methods

Send emails directly into Slack channels or DMs. Step-by-step guide covering channel email addresses, Gmail/Outlook plugins, and Slackbot forwarding.

Slack CI/CD Best Practices: Automate Your Slack App Pipeline

Set up CI/CD pipelines for Slack app development with GitHub Actions, Slack CLI testing, and environment management.

How to Use Slack's MCP Server with AI Agents: A Complete Guide

Connect AI agents to Slack via MCP — search messages, manage canvases, and orchestrate workflows using natural language.

How to Deploy Your First Workflow in Slack

Build and publish automated workflows using the Slack Workflow Builder — triggers, steps, variables, and publishing.

Slack AI Agent vs Custom Agents: LangGraph, Hermes, and When to Build Your Own

Compare Slack's native AI agent vs custom agents built with LangGraph and Hermes.

How to Develop AI Agents with Bolt for Slack: A Complete Guide

Develop AI agents using Bolt for JavaScript and Python — CLI setup, custom functions, triggers, sandbox testing, and deployment.

Slack AI Agents Subscription: What You Get with a Dedicated Team

Compare building in-house vs a subscription with a dedicated team for Slack AI agents.

Salesforce Agentforce in Slack: AI Agents That Work Alongside Your Team

Learn how Salesforce Agentforce turns AI agents into Slack teammates. Deploy HR, IT, sales, and service agents in channels and DMs.

Slack + WhatsApp API for Ecommerce: A Case Study in Customer Service Automation

How a bootstrap ecommerce founder unified customer service by integrating Slack with WhatsApp Business API.

Need help with your AI agent setup?

We build custom AI agents, workflows, and automation for teams on Slack. Book a call and tell us what you need.