ClovaX Documentation

Getting Started

Add the bot to your server

Click Invite in the header (or use the invite link from the login page) to add ClovaX to your Discord server. You need "Manage Server" or "Administrator" permission.

Login to the dashboard

Go to /login and sign in with Discord. Select a server where the bot is installed, then click Manage to open the dashboard.

Enable modules

In the dashboard, go to Modules and toggle on the features you want: Economy, Gambling, Games, AI Chat, Moderation. Each module has sub-modules you can enable individually.

Dashboard

The dashboard is your control center. Use the left sidebar to switch between sections.

Tabs

• Games — Counting, Trivia. Set channels and rules.
• Moderation — Link filtering, auto-mod rules.
• AI — AI chat personality, best friends, GIF replies.
• Economy — Points, ranks, tiers, currency name.
• Shops — Create shops and items.
• Gambling — Blackjack, slots, roulette, poker, high-low, crash, lottery, daily, bank, rob. Configure each game.
• Activity — Audit log of config changes and commands.
• Commands — Enable/disable slash commands, rename them.
• Analytics — AI usage stats (admin/mod only).
• Public Server Page — Each server has a public page at /guild/:guildId showing leaderboards (economy, trivia, gambling XP, best friends, achievements). Share the link so members can view stats.
• Admin — Site owner only (Discord ID in discordAdmin env var): logo, site config.

Server switcher

Use the server dropdown at the top to switch between servers where the bot is installed. You must have manage permission in each server.

Commands

ClovaX supports both slash commands (e.g. /gamble) and prefix commands (e.g. $gamble). The prefix defaults to $ and can be changed in Gambling settings.

Slash commands

Type / in Discord to see available commands. Slash commands are registered per server and can be enabled/disabled or renamed in the dashboard (Commands tab).

Prefix commands

Prefix commands use the configured prefix (default $). Example: $balance, $daily, $bj 50.

Gambling quick commands

Other commands

Economy

Enable Economy in Modules to give users points. Configure the currency name (e.g. "Coins", "Gems"), points cap, and how users earn points.

Ranks & tiers

Create rank tiers with role rewards. Users level up by earning XP (e.g. from messages). Assign Discord roles when users reach tiers.

Earning points

Points are earned through: message activity (if configured), gambling wins, daily claims, trivia, counting, and other activities. Configure each source in the dashboard.

Gambling

Enable Gambling in Modules, then enable individual games: Blackjack, Slots, Roulette, Poker, High-Low, Crash, Lottery, Daily, Bank, Rob.

Gambling channel

You can lock gambling to a specific channel. Set the channel in Gambling settings. Users will be told to use that channel.

Gambling XP

Users earn XP when they gamble. Higher level = higher daily bonus. Configure XP per points wagered and daily bonus % per level.

Games

• Blackjack — Classic 21. Configure min/max bet, blackjack payout, double down.
• Slots — Spin for matching symbols. Custom emojis, payouts.
• Roulette — Bet on red/black/numbers.
• Poker — Texas Hold'em vs bot or others.
• High-Low — Guess higher or lower.
• Crash — Multiplier game, cash out before crash.
• Lottery — Buy tickets, winner takes pot. Admins start rounds.
• Daily — Claim points every 24h. Role bonuses. Level multiplier.
• Bank — Deposit/withdraw. Optional fees.
• Rob — Attempt to rob another user. Cooldowns, immunity.

Games

Counting

Users count up from 1 in a designated channel. Set the channel in Games → Counting. Rules: no same user twice in a row, wrong number resets. Configure points per correct count, deductions, undo votes.

Trivia

Set a trivia channel. Use /trivia ask to ask questions. Add custom questions in the dashboard. Configure points, time limits, questions per session.

AI Chat

Enable AI Chat to let the bot reply to messages with AI-generated responses. Requires OPENAI_API_KEY.

Personalities

Choose a personality (friendly, sarcastic, etc.) or create a custom one. Tune sarcasm level and swearing.

Best Friends

Users can "best friend" the bot. The bot remembers context better for best friends.

GIF replies

Enable GIF replies for certain triggers. The bot can respond with GIFs.

Channels

Configure which channels the AI responds in. Use channel categories or specific channels.

Moderation

Enable Moderation to filter links and apply auto-mod rules.

Link filtering

Block or allow specific domains. Configure allowed domains list.

Auto-mod

Set up rules for automatic actions (warn, mute, kick, etc.) based on triggers.

Admin Commands

These commands require Administrator or the configured admin role.

Note: /channelaccess remove does not work on users/bots with Administrator permission. Remove that permission from their role first.