Skip to main content
Connecting Discord lets your team interact with your AI assistant directly inside your Discord server. This takes about 10 minutes and requires a Discord account with permission to manage your server.

​
Step 1: Create a Discord application

1

Open the Discord Developer Portal

Go to discord.com/developers/applications and log in with your Discord account.
2

Create a new application

Click New Application in the top-right corner. Give your application a name (for example Hellenic Assistant) and click Create.

​
Step 2: Configure the bot and enable intents

1

Go to the Bot section

In the left sidebar, click Bot.
2

Enable Privileged Gateway Intents

Scroll down to Privileged Gateway Intents and enable all three:
  • Message Content Intent — required. Without this the bot connects but cannot read any messages.
  • Server Members Intent — recommended. Needed for user allowlists and name matching.
  • Presence Intent — optional.
Click Save Changes.
Message Content Intent is mandatory. If it is not enabled, your bot will appear online but will not respond to anything.
3

Copy the bot token

Still on the Bot page, click Reset Token, then copy the token that appears.
Keep your bot token private. Anyone with the token can control your bot and read all messages it can see. Never share it publicly or commit it to a code repository. If it is ever compromised, reset it immediately in the Developer Portal.

​
Step 3: Invite the bot to your server

1

Go to OAuth2 URL Generator

In the left sidebar, click OAuth2, then click URL Generator.
2

Select scopes

Under Scopes, check both:
  • bot
  • applications.commands
3

Select bot permissions

Under Bot Permissions, check:
  • View Channels
  • Send Messages
  • Read Message History
  • Embed Links
  • Attach Files
4

Copy and open the invite URL

Scroll down and copy the generated URL. Open it in your browser.
5

Select your server

Select the server you want to add the bot to from the dropdown, then click Continue and Authorise.Your bot will now appear in your server member list.

​
Step 4: Connect to hellenicAI Assistants

1

Go to your instance dashboard

Log in at app.hellenicai.com and open your instance.
2

Open the Channels section

Scroll down to the Channels section on your instance page.
3

Paste your bot token

Find the Discord card, paste the token you copied from the Developer Portal, then click Connect.The status will change to Not paired and a Step 2 panel will appear.

​
Step 5: Pair your Discord account

After connecting the token, you need to pair your personal Discord account. This is a one-time step that authorises your user to interact with the assistant.
1

DM your bot in Discord

Open Discord, find your bot in the member list, right-click it, and click Message. Send any message — for example hello or /pair.The bot will reply with a message like this:
OpenClaw: access not configured.

Your Discord user id: 123456789012345678
Pairing code: GC5CC9FK

Ask the bot owner to approve with:
openclaw pairing approve discord GC5CC9FK
Copy the 8-character pairing code.
Pairing must be done via a Direct Message to the bot, not in a server channel. Once paired, the bot will respond to you in any channel it has access to.
2

Paste the code in your dashboard

Back in the hellenicAI Assistants dashboard, paste the pairing code into the Step 2 input and click Approve.
3

Confirm pairing

The status badge will change to Paired. Your assistant will now respond to your messages in Discord.
Each team member who wants to chat with the assistant needs to complete this pairing step once. If you need to link a different account, click Re-pair next to the Paired badge and repeat the process.

​
Step 6: Test the connection

1

Send a message in a server channel

Go to any channel in your Discord server that the bot has access to and send a message. No @mention is required — the bot responds to all messages in permitted channels.
2

Check the reply

Your AI assistant should reply within a few seconds. If it does, the connection is working correctly.

​
Troubleshooting

ProblemSolution
Bot does not respond to anythingMessage Content Intent is likely not enabled. Go to the Developer Portal → Bot → Privileged Gateway Intents → enable Message Content Intent → Save Changes
Bot says “This channel is not allowed”This appears in server channels before pairing is complete. Send a DM to the bot first to receive the pairing code, complete Step 5, then try the channel again
Bot appears offline after connecting tokenThe token may be incorrect. Go to the Developer Portal, reset the token, and save it again in the Channels section
Pairing code not receivedMake sure you are sending the DM to the bot directly (not in a server channel). Right-click the bot user and click Message
Pairing code is rejectedThe code may have expired or already been used. Send a new DM to get a fresh code and paste it immediately
Status shows “Not paired”Complete Step 5 above to approve your Discord account
”Missing Access” errorRe-invite the bot using the OAuth2 URL Generator with the correct scopes (bot and applications.commands) and permissions
Bot responds in some channels but not othersCheck that the bot role has View Channels and Send Messages permissions in that specific channel, not just server-wide
Token save shows “Connection refused”Your instance may be restarting. Wait 30 seconds and try again
Need more help? Email [email protected].