Discord

Connect your LemonClaw instance to Discord with a bot application

Connect Discord to your LemonClaw instance and chat with AI directly in your server or DMs. This guide works for both hosted Claw instances and self-hosted LemonClaw deployments.

Prerequisites

• A Discord account
• A Discord server where you have Manage Server permission
• A LemonClaw instance:
  • Hosted: create a Claw instance
  • Self-hosted: install LemonClaw

Setup Guide

1. Create a Discord Application

   1. Go to the Discord Developer Portal
   2. Click New Application
   3. Give it a name (e.g., “My AI Bot”) and click Create
2. Create a Bot

   1. In your application, go to the Bot tab
   2. Click Add Bot → Yes, do it!
   3. Under Privileged Gateway Intents, enable:
      • Message Content Intent (required)
      • Server Members Intent (recommended)
   4. Click Reset Token to generate a bot token
   5. Copy the token — you’ll need it next

   The token is only shown once. If you lose it, you’ll need to reset it.

3. Invite the Bot to Your Server

   1. Go to the OAuth2 tab → URL Generator
   2. Under Scopes, select: bot, applications.commands
   3. Under Bot Permissions, select: Send Messages, Read Message History
   4. Copy the generated URL and open it in your browser
   5. Select your server and click Authorize
4. Open the LemonClaw WebUI

   1. If you’re using hosted Claw, go to your Claw Dashboard and click Open WebUI
   2. If you’re self-hosting LemonClaw, open your own WebUI (for example http://your-ip:18789) and sign in with your token
   3. In the WebUI, navigate to Settings → Channels
   4. Expand the Discord section
   5. Paste your Bot Token
   6. Click Save
5. Start Chatting

   1. In your Discord server, mention the bot or send it a DM
   2. The first user is automatically paired as the owner — no code needed!
   3. Start chatting with AI!

Using in Servers

Group Settings

Configure server (guild) behavior in the Channels settings of your LemonClaw WebUI:

Setting	Options	Description
Group Policy	Open (default) / Allowlist / Disabled	Controls access to server channels
Require @mention	On / Off	Bot only responds when @mentioned (recommended)
Group IDs	List of guild IDs	Restrict to specific servers (empty = all servers)

Discord uses per-guild user allowlists instead of a global group allowlist. For advanced per-guild user filtering, configure directly in the LemonClaw config file.

DM Policy

Control who can send direct messages to your bot:

Policy	Behavior
Pairing (default)	New users get a pairing code — enter it in the WebUI to authorize
Allowlist	Only user IDs you specify can DM the bot
Open	Anyone can DM the bot (use with caution)

Troubleshooting

Bot is online but doesn't respond

• Make sure Message Content Intent is enabled in the Developer Portal
• Verify the bot token is correct
• Check that the bot has permission to read and send messages in the channel

Bot shows as offline

• Check your instance status in the dashboard (should be green/running)
• Try restarting the instance
• Verify the token hasn’t been reset in the Developer Portal

409 Conflict errors in logs

• This happens when two instances try to use the same bot token
• Make sure only one LemonClaw instance is configured with this token