Skip to content
wireclaw Docs

Connect Discord

Connect your agent to Discord so it can respond in your server channels.

Prerequisites

Section titled “Prerequisites”
  • A Wireclaw agent (create one if you haven’t)
  • A Discord account with Manage Server permission on the target server

Setup

Section titled “Setup”

  1. Create a Discord application

    Go to the Discord Developer Portal → New Application.

    Name it (e.g., “Wireclaw Research Bot”) and click Create.

  2. Create a bot user

    In your application → Bot tab → Add Bot.

    Under Privileged Gateway Intents, enable:

    • Message Content Intent (required for reading messages)

    Click Reset Token and copy the bot token.

  3. Invite the bot to your server

    Go to OAuth2 → URL Generator.

    Select scopes: bot, applications.commands

    Select bot permissions: Send Messages, Read Message History, Embed Links

    Copy the generated URL and open it in your browser to invite the bot.

  4. Add the token in Wireclaw

    Go to Dashboard → Your Agent → Channels → Add Discord.

    Paste the bot token and click Connect.

    [channels.discord]
    token = "YOUR_DISCORD_BOT_TOKEN"
    guild_id = "123456789012345678"  # Optional: restrict to one server

  5. Verify the connection

    Green checkmark = connected. The bot should appear online in your server.

Test it

Section titled “Test it”

Mention your bot or send a message in a channel it has access to. The agent responds inline.

Troubleshooting

Section titled “Troubleshooting”
IssueSolution
Bot appears offlineCheck agent status is “Running” in Dashboard
”Missing Access” errorEnsure bot has Send Messages permission in the channel
Bot doesn’t read messagesEnable Message Content Intent in Developer Portal → Bot tab

Next steps

Section titled “Next steps”