AI Integration

Pair @robojs/moderation with @robojs/ai to control moderation through natural language. Instead of typing slash commands, mention the bot with a plain-language instruction and the AI maps it to the appropriate moderation command.

Setup

Install both plugins:

npx robo add @robojs/moderation@next @robojs/ai@next

Configure @robojs/ai with your API key and preferences. See the AI plugin documentation for full setup instructions.

Usage

Mention your bot with a moderation instruction:

"@SageBot please ban @Baguette for spamming bread"

"@SageBot warn @User for posting links in the wrong channel"

"@SageBot kick @Troll reason: being disruptive"

The AI plugin reads the command metadata (descriptions, option names, types) from the moderation commands and routes the natural language request to the correct handler. The same permission checks apply — if the user doesn't have BanMembers permission, the AI can't execute a ban on their behalf.

How it works

No special adapter code is needed. The moderation commands use standard Robo.js CommandConfig exports with descriptions and typed options. The AI plugin discovers these at runtime and uses them to understand which command to invoke.

The AI:

Parses the natural language request
Identifies the matching moderation command
Extracts parameters (user, reason, etc.)
Executes the command with the same permission checks as a slash command

Next Steps

Commands

Full reference for all moderation commands.

Configuration

Plugin options, intents, and permissions.