Connecting Discord lets your team interact with your AI assistant directly inside your Discord server. This is ideal for team workspaces, community servers, or customer support channels.
This takes about 10 minutes and requires a Discord account with permission to manage your server.
Step 1: Create a Discord application
Open the Discord Developer Portal
Create a new application
Click New Application in the top-right corner. Give your application a name (e.g. Hellenic Assistant) and click Create.
Step 2: Set up the bot and copy the token
Go to the Bot section
In the left sidebar, click Bot.
Add a bot
Click Add Bot and confirm by clicking Yes, do it!
Configure permissions
Scroll down to Bot Permissions and enable:
- Send Messages
- Read Message History
- View Channels
These are the minimum permissions needed for your assistant to read and reply to messages. Copy the bot token
Click Reset Token (or Copy if shown), 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, post it in chat, or commit it to a code repository. If it is ever compromised, go back to the Bot section and click Reset Token immediately.
Step 3: Invite the bot to your server
Go to OAuth2 → URL Generator
In the left sidebar, click OAuth2, then click URL Generator.
Select bot permissions
Under Bot Permissions, check:
- Send Messages
- Read Message History
- View Channels
Copy and open the invite URL
Scroll down and copy the generated URL. Open it in your browser.
Select your server
Select the server you want to add the bot to from the dropdown, then click Continue → Authorise.
Step 4: Connect to Hellenic Claw
Go to your instance dashboard
Open the Channels tab
Click the Channels tab.
Select Discord
Find the Discord card and click Connect.
Paste your bot token
Paste the token you copied from the Discord Developer Portal, then click Save or Connect.
Step 5: Test the connection
Go to your Discord server, find a channel the bot has access to, and send a message mentioning the bot (e.g. @HellenicAssistant Hello!). It should reply within a few seconds.
Troubleshooting
| Problem | Solution |
|---|
| Bot appears offline | Check that the token is correct in the Channels tab |
| Bot does not reply | Make sure the bot has View Channels and Send Messages permissions in the specific channel |
| ”Missing Access” error | Re-invite the bot with the correct permissions using the OAuth2 URL Generator |
