Skip to main content

​
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

​
Setup

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
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
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
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:
ModeBehavior
"collapsed"All channels in a guild share one session (default)
"per-channel"Each channel gets its own session with separate context

​
Supported Features

FeatureSupported
Text messagesYes
EmbedsYes
File attachmentsYes
DMsYes
Server channelsYes
Slash commandsPlanned
Voice channelsNo
Message history readPlanned