Connect your agent to Discord or Slack

Create a Discord bot with the right permissions, get it connected to your agent, and fix the common problems. Slack works the same way.

In this tutorial

You can talk to your agent in your own Discord server, in DMs and in channels. One honest note first: Discord and Slack can't yet be connected with one click from the dashboard the way Telegram and WhatsApp can. You create the bot yourself (about ten minutes, below), then connect it by following the official setup docs. It's a technical job, so it suits people comfortable with a little configuration.

If you just want to message your agent from your phone, Telegram or WhatsApp are faster.

Step 1: create the Discord application

You need a Discord account and a server you own or administer. (No server? In Discord, click + in the left sidebar, then Create My Own.)

  1. Go to the Discord Developer Portal and click New Application.
  2. Give it any name, accept the terms, and click Create.
  3. In the left sidebar, click Bot. Set the Username, which is the name people see in Discord. Add a picture if you like.

Step 2: turn on Message Content Intent

Still on the Bot page, scroll to Privileged Gateway Intents and turn on:

  • Message Content Intent: required. Without it, the bot shows as online but never replies.
  • Server Members Intent: recommended.

Click Save Changes.

Step 3: copy the bot token

At the top of the Bot page, click Reset Token (the first time, this just creates one) and copy it. Keep it somewhere safe. The token is a password for your bot: never post it in a channel or a screenshot. If it leaks, click Reset Token again.

Step 4: invite the bot to your server

  1. In the left sidebar, click OAuth2, then the URL Generator.
  2. Under Scopes, tick bot and applications.commands.
  3. Under Bot Permissions, tick View Channels, Send Messages, Send Messages in Threads, Read Message History, Embed Links, Attach Files and Add Reactions. Don't tick Administrator; your bot doesn't need it.
  4. Copy the generated URL, open it, pick your server, and click Authorize.

The bot now appears in your server's member list. It shows as offline until it's connected to your agent.

Step 5: connect it to your agent

Open your agent, click the Connect pill under an empty chat, and in the Messaging apps window click View docs next to Discord. It opens the official setup docs for your agent type (OpenClaw or Hermes). Follow them to add your bot token to your agent.

Once Discord is set up, it appears in the Messaging apps window as Connected, with Turn on and Turn off. If it shows Needs attention, go back through the docs and check the token and settings.

On OpenClaw, the first time you DM the bot it may reply with a pairing code that has to be approved before it'll talk to you. That's Discord access control working as intended.

Slack

Slack works the same way: there's no one-click connect yet. Click View docs next to Slack in the Messaging apps window and follow the setup docs for your agent type.

If something isn't working

The bot is online but never replies. Check Message Content Intent (step 2). Then check the bot can Send Messages in that channel: channel-level permission overrides can block it even if the server role allows it. Test in a brand-new channel with no special permissions.

It replies in DMs but not in channels. By default, agents usually only answer in channels when you @mention them. Mention the bot and try again. If you want it to answer every message in your private server, the setup docs explain how to turn off the mention requirement.

It shows "typing…" and then nothing. Usually the reply was too long for one Discord message, or the agent hit an error. Ask for something tiny ("reply with one word: pong"). If that works, ask for long answers in parts or as a file.

It's silent in one thread. The thread may be archived or locked. Unarchive it, or start a new thread. Also check Send Messages in Threads is allowed.

It replies to everything and gets noisy. Add group-chat rules to its personality: "In Discord channels, only reply when someone mentions you or asks you directly. Send one message per reply. Stay quiet otherwise." See give your agent a personality.

It sends tables that look broken. Discord doesn't display markdown tables. Tell it: "In Discord, never use tables. Use short bullet lists."

It can't pin or moderate. Agents are good at reading and replying; moderation actions often aren't available. Ask it to quote the message to pin, and pin it yourself.

The Developer Portal says to verify your email, but you already did. You're probably signed in to a different Discord account in the portal. Sign out of discord.com and the portal, sign back in with one account, and try again in a single browser tab.

It worked, then went offline. Check your agent's status on Agents and start or restart it. See agent not responding.

Frequently asked questions

Why can't I connect Discord from the dashboard like Telegram?

Discord needs more setup (an application, permissions and server access) than Telegram. One-click setup isn't built yet, so for now you connect it by following the docs from the View docs button. If that's more than you want to take on, Telegram and WhatsApp connect in about a minute.

Does each Discord channel have its own conversation?

Yes. Each channel, and your DMs with the bot, are separate conversations with the same agent. That's useful: make #research and #writing channels to keep topics apart.

Is Discord the same conversation as the dashboard chat?

No. It's the same agent with the same memory and files, but a separate chat history. On OpenClaw, Discord conversations also appear in the dashboard's Chats list.

Should I give the bot Administrator permission?

No. The permissions in step 4 are all it needs. Giving it less access is safer.

How do I join the Heyron members' Discord server?

That's different from connecting your agent. Go to Community in the dashboard and click Link Discord.

Still stuck?

Open a ticket and a person will help. Tell us what you tried and what you saw.

Contact support