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: AI Chatbot, Economy, Games, Moderation, Shops, and Twitch Integration.

Dashboard

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

Tabs

• Games — Counting, Trivia. Set channels and rules.
• AI Chatbot — Natural PG-13 conversations through Discord mentions/replies and Twitch chat commands.
• Moderation — Link filtering, auto-mod rules.
• Economy — Points, ranks, tiers, currency name.
• Shops — Create shops and items.
• Twitch Integration — Channel setup, VIPs, Mods, Twitch commands, Watchtime, Loyalty, Stream Analytics, Predictions, Account Links, Chat list excluded. See the Twitch Integration section below.
• Activity — Audit log of config changes and commands.
• Commands — Enable/disable slash commands, rename them.
• Public Server Page — Each server has a public page at /guild/:guildId showing available public leaderboards. 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 slash commands and selected prefix commands. Type / in Discord to see the current command list.

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).

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 configured server activity, trivia, counting, and other enabled economy sources.

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.

Twitch Integration

Link your Discord server to a Twitch channel to show chat, stream activity, watchtime, loyalty points, and Twitch-only commands. Enable Twitch Integration in the dashboard Modules, then use the Twitch Integration sidebar to configure everything.

How to connect your Twitch channel

You only need to use the dashboard — no bot token or server config required. Follow these steps:

1. Enable Twitch Integration in the dashboard under Modules (toggle it on if it isn’t already).
2. Open Dashboard → Twitch Integration → Twitch Channel Setup in the left sidebar.
3. Click the button to Connect or Link your Twitch channel. You’ll be sent to Twitch to log in (if you aren’t already) and to authorize the bot.
4. On Twitch, review the permissions and click Authorize. You’ll be redirected back to the ClovaX dashboard.
5. Once linked, your channel will show as “Linked” and the bot can join your chat, track watchtime, run loyalty, and use all Twitch features. You can unlink or re-link anytime from the same page.

We do not store your Twitch password or login credentials. Linking uses Twitch’s official OAuth; you sign in on Twitch’s site and grant access. For more on data we do and don’t store, see the Privacy Policy.

Other options on Channel Setup

• Allow account linking — When enabled, viewers can link their Twitch account to their Discord account for this server (used for VIP sync and !info / !link).

Twitch Dashboard

Under Twitch Integration → Twitch Dashboard you get a live view of your linked channel: chat messages, stream activity (when live), and quick stats. Use it to monitor chat and see who’s talking. Chat list can be filtered; users can be removed from the list (they’re added to the “Chat list excluded” list).

VIPs & Mods

VIPs and Mods tabs show Twitch VIPs and moderators for your channel. You can sync them to Discord roles: assign a Discord role to “VIP” and/or “Mod” so linked users get the role when they have that status on Twitch. Re-link your channel if the lists don’t update.

Twitch Commands

These commands work in your Twitch chat when the bot is in the channel. Enable or disable each in Twitch Integration → Twitch Commands.

Watchtime

Under Twitch Integration → Watchtime you can:

• Track watchtime & offline time — When enabled, the bot records how long each user is in the chatters list (live and offline). View leaderboards on the same tab or on your public Twitch page.
• Watchtime points — Optionally award points over time for watching (separate from Loyalty). Enable “Watchtime points” and set the rate; points are stored per user and can be shown with !points.
• Points events — Create time-limited events (e.g. subathon, bitathon) with their own leaderboard. Add an event with name and start time; points during the event are tracked separately.

Leaderboards (live watchtime, offline time, points) are shown on the Watchtime tab and can be embedded on your public page.

Loyalty

Twitch Integration → Loyalty rewards both lurkers and chatters with configurable points. All settings are saved to the database and take effect without restart.

• Master toggle — Turn the whole loyalty system on or off.
• Watch rewards — Award points every N minutes to users in the chatters list. Set interval, points per interval, presence poll rate, grace period, and exclude broadcaster/mods/bots by name.
• Chat rewards — Award points per valid message (with cooldown, min length, ignore commands and emote-only). Optional announcement in chat when someone earns.
• Lurker bonus — Random bonus for “lurkers” (users present for a while with few messages). Set interval, number of winners, bonus points, eligibility window, and per-user cooldown.
• Announcements — Choose whether to announce watch/chat/lurker rewards in chat and set max announcements per hour. Edit message templates (use {user} and {points}).

The bot account is automatically excluded from earning loyalty points. Changes save automatically; use the Debug summary (when a channel is linked) to see present count and top earners.

Stream Analytics

Twitch Integration → Stream Analytics shows per-stream stats: when you went live, duration, average viewers, bits, subs, gifted subs. Pick a date range to view past streams. Data is recorded when you go live and finalized when you go offline.

Predictions

If you’ve linked your channel with prediction scopes, Twitch Integration → Predictions explains how to run Channel Points predictions. The !cf / !coinflip command starts a Heads or Tails prediction (mods and broadcaster only).

Account Links

Under Twitch Integration → Account Links you can see and manage Discord–Twitch links for your server: add a link (Discord user + Twitch username) or remove one. Linked users can use !info and !link in chat and, when VIP sync is enabled, receive the VIP role on Discord when they’re VIP on Twitch.

Chat list excluded

Twitch Integration → Chat list excluded lists users and bots that are hidden from the Twitch Dashboard chat list. You can add usernames manually or add them by using “Remove from list” on the Twitch Dashboard. Excluded users are not shown in the live chat list but can still chat; for loyalty, add them to the “Excluded usernames” list in the Loyalty settings.

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.