Skip to content
alxx.dev logoalxxAI Commands

alxxAI Slash Commands

Complete documentation for all alxxAI slash commands. Commands are organized by category with syntax, parameters, permissions, and examples.

Last updated: January 2026

Permission Levels

Lock

Understanding Permissions

alxxAI commands require different permission levels based on their impact. Understanding these levels helps you configure your server's moderation structure effectively.

  • Administrator: Requires "Administrator" permission on the server. Reserved for server configuration, digest management, and memory channel setup.
  • Moderator: Requires specific moderation permissions (noted in each command). Used for daily moderation tasks like bans, mutes, and warnings.
  • Anyone: Can be used by any server member. These commands have no permission restrictions.

Moderation Commands

Moderation Shield

Moderation Toolkit

/ban

Ban a member from the server permanently.

Syntax:

/ban user:@member reason:"Optional reason"

Parameters:

  • user (required): The member to ban
  • reason (optional): Reason for the ban

Permissions Required:

User: "Ban Members" | Bot: "Ban Members"

Notes:

  • Cannot ban members with equal or higher role than you or the bot
  • Action is logged to moderation log channel (if configured)
  • Increments moderation statistics

/unban

Remove a ban from a previously banned user.

Syntax:

/unban user:"User ID, mention, or name" reason:"Optional reason"

Parameters:

  • user (required): User ID, mention, or partial username (fuzzy search in ban list)
  • reason (optional): Reason for unbanning

Permissions Required:

User: "Ban Members" | Bot: "Ban Members"

Notes:

  • If multiple users match a partial name, you'll get a list and must retry with specific ID
  • Action is logged to moderation log channel

/kick

Remove a member from the server (they can rejoin with an invite).

Syntax:

/kick user:@member reason:"Optional reason"

Permissions Required:

User: "Kick Members" | Bot: "Kick Members"

Notes:

  • Kicked members can rejoin if they have an invite link
  • Cannot kick members with equal or higher roles

/mute

Timeout a member, preventing them from sending messages or speaking in voice channels.

Syntax:

/mute user:@member duration:60 reason:"Optional reason"

Parameters:

  • user (required): The member to mute
  • duration (required): Timeout duration in minutes (max: 40320 = 28 days)
  • reason (optional): Reason for the mute

Permissions Required:

User: "Moderate Members" | Bot: "Moderate Members"

Notes:

  • Duration is in minutes, not seconds or hours
  • Maximum duration: 40320 minutes (28 days - Discord limit)
  • Muted members cannot send messages, speak/share video, react, or create threads

/unmute

Remove a timeout from a member.

Syntax:

/unmute user:@member

Permissions Required:

User: "Moderate Members" | Bot: "Moderate Members"

Notes:

Only works on members currently timed out. Action is logged to moderation log channel.

/clear

Bulk delete messages from a channel.

Syntax:

/clear amount:50

Parameters:

  • amount (required): Number of messages to delete (1-100)

Permissions Required:

User: "Manage Messages" | Bot: "Manage Messages"

Notes:

  • Maximum 100 messages at a time (Discord API limit)
  • Cannot delete messages older than 14 days (Discord limitation)
  • Deleted count is logged to moderation channel

Warning Commands

Warning

Warnings & Records

Warnings are permanent records stored in the database, including the warned user, moderator, timestamp, and reason.

/warn

Issue a formal warning to a member. Warnings are tracked and can be viewed later.

Syntax:

/warn user:@member reason:"Reason for warning"

Parameters:

  • user (required): The member to warn
  • reason (required): Reason for warning (stored in database)

Permissions Required:

User: "Moderate Members"

Notes:

  • Warnings are permanent records unless cleared by /warning clear
  • Each warning includes: warned user, moderator, timestamp, and reason
  • View user's warning history with /warning list

/warning list

View all warnings issued to a specific user.

Syntax:

/warning list user:@member

Permissions Required:

User: "Moderate Members"

Response Shows:

  • Total warning count
  • List of up to 10 most recent warnings (newest first)
  • Warning ID, moderator, date/time, and reason for each

/warning clear

Clear all warnings for a specific user.

Syntax:

/warning clear user:@member

Permissions Required:

User: "Administrator"

Notes:

  • Requires Administrator permission (higher than regular moderation)
  • Permanently deletes all warning records for the user
  • Action is logged to moderation log channel
  • Cannot be undone - use cautiously

Server Stats Commands

Statistics

Moderation Analytics

View comprehensive moderation statistics for your server.

/modstats

Syntax:

/modstats

Parameters:

None

Permissions Required:

User: "Moderate Members"

Response Shows:

  • Total Actions Summary: Total moderation actions performed with breakdown by type (bans, kicks, mutes, warnings, clears)
  • Top Moderated Users: Users with most actions against them and action count per user
  • Top Moderators: Moderators who performed the most actions with action count per moderator

Notes:

  • Statistics are server-wide (all-time)
  • Counts number of commands executed, not impact (e.g., /clear 100 counts as 1 action)
  • Ephemeral response (only visible to you)

Memory & AI Commands

AI Brain

Memory Control Center

Configure which channels alxxAI remembers. Messages in memory channels are automatically ingested and used by the AI for context-aware responses.

/memorychannel add

Enable memory ingestion for a channel. Messages in this channel will be stored and used by the AI for context.

Syntax:

/memorychannel add channel:#channel-name

Permissions Required:

User: "Administrator"

What Happens:

  • Channel is marked for memory ingestion
  • Backfill job starts to ingest historical messages
  • Future messages in the channel are automatically ingested
  • AI can now search and reference conversations from this channel

Notes:

  • Works with both text channels and forum channels
  • Forum channels: All threads (active + archived) are ingested
  • Backfill may take several minutes for large channels
  • Check progress with /memorychannel status

/memorychannel remove

Disable memory ingestion for a channel and delete all stored messages from that channel.

Syntax:

/memorychannel remove channel:#channel-name

Permissions Required:

User: "Administrator"

Notes:

  • Data is permanently deleted and cannot be recovered
  • AI will no longer reference past messages from this channel
  • Future messages in the channel are ignored

/memorychannel list

List all channels currently configured for memory ingestion.

Syntax:

/memorychannel list

Permissions Required:

User: "Administrator"

/memorychannel status

View detailed status of memory channel backfill jobs.

Syntax:

/memorychannel status

Response Shows:

  • Completed: Historical messages fully ingested
  • Pending: Backfill job queued but not started
  • Running: Currently ingesting historical messages
  • Failed: Backfill encountered an error

Digest Commands

Digest entries are curated pieces of knowledge that the AI always has access to. Use these for server rules, FAQs, important context, and permanent information.

/digest add

Create a new curated digest entry that the AI will reference.

Key Parameters:

  • title (required): Short title for the entry
  • body (required): The actual content (max 10,000 characters)
  • entry_type (optional): rule, policy, decision, faq, context, other
  • priority (optional): normal, high, canonical
  • always_include (optional): Include in every AI response (default: false)

Permissions Required:

User: "Administrator"

Important Notes:

  • The number of entries marked with always_include: true is limited
  • priority: canonical means "this is the definitive source of truth"
  • Use /digest update to modify entries, /digest remove to delete
  • View all entries with /digest list

AI Access Control

Control who can trigger AI replies when the bot is mentioned. This is a role-based gate stored per server and does not affect moderation commands.

/aiconfig set_role

Require a role to use mention-triggered AI replies.

Syntax:

/aiconfig set_role role:@RoleName

Parameters:

  • role (required): The Discord role required to use AI replies

Permissions Required:

User: "Moderate Members" or "Administrator"

Behavior:

  • Saves the required role for AI access
  • Sends an ephemeral confirmation embed
  • Logs the change to the moderation log channel (if configured)

Notes:

  • Users without the role see an AI ACCESS DENIED embed that auto-deletes after ~5 seconds
  • Only mention-triggered AI replies are gated

/aiconfig remove_role

Remove the AI role restriction (allow everyone).

Syntax:

/aiconfig remove_role

Permissions Required:

User: "Moderate Members" or "Administrator"

Behavior:

  • Clears the required role for AI access
  • Sends an ephemeral confirmation embed
  • Logs the change to the moderation log channel (if configured)

/aiconfig view

View the current AI access configuration.

Syntax:

/aiconfig view

Permissions Required:

User: "Moderate Members" or "Administrator"

Response Shows:

  • Required Role: Role mention or "Everyone"
  • Status: restricted, restricted (role deleted), or unrestricted

Notes:

Response is ephemeral.

Guide

Want to learn about memory? Check out our guide.

Open Memory Guide →

Server Management Commands

Logging

Logging Commands

Configure where the bot sends moderation action logs and message event logs.

/logchannel set

Set a log channel for moderation actions or message events.

Syntax:

/logchannel set type:moderation channel:#mod-logs

Parameters:

  • type (required): moderation (bans, kicks, mutes, warns, clears) or message (deleted/edited messages)
  • channel (required): The text channel where logs should be sent

Permissions Required:

User: "Administrator"

Notes:

  • Bot needs "Send Messages" and "Embed Links" permissions in log channels
  • One channel can be used for both types if desired
  • Log embeds use color coding (red for bans, yellow for warns, etc.)
  • Use /logchannel remove to stop logging, /logchannel list to view current config
Embed

Embed Commands

Send custom embeds to channels. Useful for announcements, formatted messages, and more.

/embed

Syntax (Simple):

/embed title:"Announcement" body:"Message text" channel:#announcements accent:"blue"

Key Parameters:

  • title (optional): Embed title
  • body (optional): Main embed description/content
  • channel (optional): Channel to send the embed (default: current channel)
  • accent (optional): Embed color (red, orange, yellow, green, blue, purple, pink, black, white, or hex code)
  • sections (optional): Create fields using Name::Value||Name2::Value2 format

Permissions Required:

User: "Administrator"

Notes:

  • Advanced JSON schemas supported for full embed control
  • Use || to separate multiple sections, :: to separate name from value
Tips

Tips & Best Practices

Memory System

  • Add high-signal channels like rules, announcements, or FAQ first
  • Don't enable memory for every channel, focus on valuable discussions
  • Use digest entries for information that should always be accessible
  • Monitor backfill status with /memorychannel status

Digest Entries

  • Use always_include: true sparingly (only for critical info)
  • Set priority: canonical for authoritative sources
  • Update entries instead of creating duplicates
  • Use descriptive titles for easy identification in /digest list

Ready to Use These Commands?

Start using alxxAI commands to moderate, manage memory, and build an intelligent Discord community.

Add to Discord↗Contact Support↗