Discord

Overview

ArgentOS supports Discord as a channel, allowing your agent to interact in server channels and direct messages. The bot uses Discord's Gateway (WebSocket) for real-time events and the REST API for sending messages.

Prerequisites

• A Discord account
• A Discord server where you have Manage Server permissions
• ArgentOS gateway running

Step 1: Create a Discord Application

1. Go to the Discord Developer Portal
2. Click New Application and give it a name
3. Navigate to the Bot section
4. Click Reset Token and copy the bot token

Step 2: Configure Intents

In the Bot section, enable these Privileged Gateway Intents:

• Message Content Intent -- required to read message text
• Server Members Intent -- optional, for member lookups
• Presence Intent -- optional, for online status

Step 3: Invite the Bot

1. Go to OAuth2 > URL Generator
2. Select scopes: bot, applications.commands
3. Select permissions: Send Messages, Read Message History, Embed Links, Attach Files
4. Copy the generated URL and open it in your browser
5. Select your server and authorize

Step 4: Add the Channel

argent channels add discord

Paste your bot token when prompted.

Configuration

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "your-discord-bot-token",
      "intents": ["GUILDS", "GUILD_MESSAGES", "DIRECT_MESSAGES", "MESSAGE_CONTENT"],
      "allowedGuilds": [],
      "allowedUsers": [],
      "channelScope": "collapsed"
    }
  }
}

Channel Scope

The channelScope option controls how Discord channels map to agent sessions:

• "collapsed" -- All channels in a guild share one session (default)
• "per-channel" -- Each channel gets its own session with separate context

Supported Features