This guide will help you connect QClaw to Discord, so you can control QClaw and receive responses directly through Discord messages.
Prerequisites
Before getting started, make sure you have:
QClaw installed on your computer
A Discord account
A Discord server where you have Administrator or Manage Server permissions (required to add bots)
If you don't have a Discord server, you can create one for free. Open Discord, click the + icon on the left sidebar, and select Create My Own.
-----------------------------------------
Setup Flow
Overall Process
Create a Discord Application & Bot -> Get the Bot Token -> Invite the Bot to Your Server -> Configure QClaw
-----------------------------------------
Detailed Steps:
Step 1: Create a Discord Application
1. Go to the Discord Developer Portal and log in with your Discord account.
2. Click "New Application" in the top-right corner.
3. Enter a name for your application (e.g., QClaw Bot) and click "Create".
This name will be visible to other members of your server when they interact with the bot, so choose something recognizable.
4. (Optional) Upload an icon and add a description for your bot on the General Information page.
-----------------------------------------
Step 2: Get the Bot Token
1. In the left sidebar, click "Bot".
2. Scroll down to the Privileged Gateway Intents section and enable permissions
3. On the Bot page, click "Reset Token" (or "Copy" if a token is already shown).
Security Notice: Keep your bot token private. Anyone with this token can control your bot. Do not share it or commit it to public repositories.
4. Save this token, you will need it when configuring QClaw.
-----------------------------------------
Step 3: Set Bot Permissions
1. In the left sidebar, click "OAuth2"
2. Under Scopes, check "bot"
3. Under Bot Permissions, check:
Send Messages
Read Message History
View Channels
Manage Threads
Attach Files (for image and file processing)
any other permission you want
4. Copy the generated OAuth2 URL at the bottom of the page.
-----------------------------------------
Step 4: Invite the Bot to Your Server
1. Open the generated URL from Step 3 in your browser.
2. Select the Discord server you want to add the bot to, then click "Authorize".
3. Open Discord — your bot should now appear in the member list of your server
-----------------------------------------
Step 5: Configure QClaw
1. Open QClaw on your computer.
2. Click the Channels button in the bottom-left corner.
3. Select "Discord" from the list of platforms, then click "Configure".
4. Paste the Bot Token you copied in Step 3 into the token field.
5. Click "Connect" to complete the setup.
6. Now, you have Discord Connected to your QClaw
-----------------------------------------
Start Using
QClaw on Discord supports two usage modes: Direct Message (DM) and Server Channel.
1. Direct Message (DM): Open Discord and find your bot in your Direct Messages list. Send it a message — for example, "Hello" — to test the connection. If configured correctly, QClaw will receive the message and reply in Discord.
2. Server Channel: Go to any text channel in your server where the bot has been granted access. Mention the bot using @BotName followed by your message. If configured correctly, QClaw will receive the mention and reply in the channel.
For example: @QClaw Bot Hello
If the bot replies successfully, you have completed the QClaw–Discord integration! 🎉
-----------------------------------------
Frequently Asked Questions
1. The bot doesn't respond — what should I check?
Check your bot token: Make sure the token pasted in QClaw is correct and hasn't been reset. If you reset the token in the Developer Portal, you need to update it in QClaw as well.
Check QClaw is running: The bot only works when QClaw is actively running on your computer.
Check channel permissions: Make sure the bot has View Channel and Send Messages permissions in the channel you're using.
2. The bot appears offline in my server — what's wrong?
This usually means QClaw is not running, or the bot token in QClaw is incorrect. Check that QClaw is open on your computer and that the token matches the one in the Discord Developer Portal.
3. The bot can't see my messages — what should I do?
Make sure Message Content Intent is enabled under Bot → Privileged Gateway Intents in the Discord Developer Portal. Without this, the bot cannot read message content in servers.