CleanerBot is the essential tool for server owners and moderators looking to efficiently manage member activity, maintain a vibrant community, and ensure your server thrives.This intelligent bot automates the process of identifying, reporting on, reminding, and ultimately kicking inactive users, freeing up your time and keeping your member list fresh. It's designed to promote engagement and streamline server administration by gently nudging inactive members or, when necessary, automatically removing them.Clean up your server. Boost engagement. Automate moderation.Supported Languages: 🌍 English, Bulgarian, Chinese (Simplified Mandarin), Croatian, Czech, Danish, Dutch, Finnish, French, German, Greek, Hindi, Italian, Japanese, Norwegian, Polish, Portuguese, Romanian, Serbian, Slovak, Slovene, Swedish, Ukrainian

★★★★★
“Pretty useful to keep the group in check.” -- 19azrael90★★★★★
"Super useful bot for my server, lots of handy features to save some time!" -- idk9831

★★★★★
“Excellent server and bot!”
-- misterkermit★★★★★
“The bot made managing my server much easier and scaling much more feasible.”
-- Cobra808

Changelog

NEW : To see the latest release notes, please use the command /changelog. Thank you.This list will not be continued any longer.

________________________________________________________________________________

Release Notes - v2.0.2 - 28.07.2025🐛 Bug Fixes
+ fixed an issue with setting Chinese as language causing an error🚀 Improvements
+ the bot will leave guilds automatically starting in August, 1st, if setup is not complete after a month + 1 week grace period
+ minor improvements in the background

________________________________________________________________________________

Release Notes - v2.0.1 - 27.07.2025🐛 Bug Fixes
+ fixed an AttributeError in CleanerBot's on_message event handler
+ fixed an issue in the decay score calculation within the periodic scan

________________________________________________________________________________

Release Notes - v2.0.0 - 25.07.2025✨ New Features
CleanerBot revolutionizes community hygiene and retention through the introduction of an innovative Decay Scoring System. Unlike traditional leaderboard or XP bots, CleanerBot tracks member inactivity over time and links it directly to configurable moderation actions like warnings, role changes, or kick suggestions. This offers a unique blend of gamification and utility, filling a market gap in proactive inactivity management based on actual behavior, not just visibility.-> A re-configuration is required. -> /startWhat is the Decay Score?
Every member gets a score that increases with inactivity and resets with activity (sending messages, joining voice, etc.). When the score reaches certain thresholds you define, the bot can send warnings, assign roles or even kick inactive members automatically or after manual confirmation.Use /help for additional information.

________________________________________________________________________________

Release Notes - v1.2.4 - 17.07.2025🐛 Bug Fixes
+ fixed an issue with the activity cache not reloading for 24h, if the bot has been rebooted (due to a release)
+ fixed an issue within the onboarding wizard on exempt roles setting🚀 Improvements
* improved the formatting of the auto-reply to a DM sent to the bot

________________________________________________________________________________

Release Notes - v1.2.3 - 16.07.2025🐛 Bug Fixes
+ fixed an issue with very long channel lists (with > 6,000 characters per result, which exceeds discord's limits) in /config check_permissions

________________________________________________________________________________

Release Notes - v1.2.2 - 15.07.2025🐛 Bug Fixes
+ fixed missing localization strings
+ fixed an issue with Spanish localization strings, whereof one was too long for discord's limits
+ fixed a CommandInvokeError for exempt roles🚀 Improvements
+ made the /start onboarding wizard much more stable and frictionless working with proper content validation and guidance

________________________________________________________________________________

Release Notes - v1.2.1 - 14.07.2025✨New Features
+ added a sparkling setup wizard. Just use /start and you’ll be fully guided
+ added a new command /terms in order to fullfil discord's requirements for bots active on 100+ servers🐛 Bug Fixes
+ fixed a NoneType error while inactivity scan is running and the bot has been removed from a guild🚀 Improvements
+ made commands clickable in /help and during /config setup guide
+ reactivated the welcome message on “bot joined guild” event to the guild’s system channel or, as a fallback, via DM to the guild owner
+ optimized hint on non-accessible channels and advised to whitelist channels, the bot should not be able to read⚠️ Known Issues
+ in the /start wizard, configurations are immediately stored, not waiting for confirmation. it's not a defect, it's just bad UX - I'll fix this with the next release

________________________________________________________________________________

Release Notes - v1.2.0 - 13.07.2025✨New Features
+ added a new premium feature called "time zone conversion"
+ added a new command /features which lists and explains all premium tools and features. here you can also find a detailed explanation of the time zone feature with /features feature:Time Zone Conversion🐛 Bug Fixes
+ with no effect to users: fixed error handling on bot reboot for not finding top.gg to ping guild count
+ fixed a critical TypeError in the main bot script
+ fixed an issue in the internal bot health script not reporting events
+ fixed issues with discord's "rate limited" while reading channel histories
+ fixed an issue for /help and some localizations (texts were too long, exceeding discord's limits)🚀 Improvements
+ dramatically reduced the bot's downtime on bot reboot (during releases) by 99%
+ dramatically reduced periodic inactivity scans by starting scans for all guilds in parallel, not sequentially

________________________________________________________________________________

Release Notes - v1.1.3 - 12.07.2025🐛 Bug Fixes
+ fixed the error handling and an unhandled exception, when a command failed
+ fixed the /reportinactivity command not working, if the member's list is too long and the messages to be send exceeds discord's 4096 character limit for embed descriptions.⚠️ Known Issues
* with no effect to users: already fixed error handling on bot reboot for not finding top.gg and ping guild count; will be released with next release

________________________________________________________________________________

Release Notes - v1.1.2 - 09.07.2025🐛 Bug Fixes
* fixed an issue which occurred in inactivity scanning🚀 Improvements
* added uptime monitoring capabilities

________________________________________________________________________________

Release Notes - v1.1.1 - 08.07.2025🐛 Bug Fixes
+ fixed an issue while logging🚀 Improvements
+ removed the welcome message sent to a public channel, as the bot reminds staff members on incomplete configuration during its lifetime automatically.
+ extended /help command and integrated a "howto setup" section.

________________________________________________________________________________

Release Notes - v1.1.0 - 06.07.2025✨New Features
+ added new commands /config clear_default_roles and /config clear_exempt_roles to enable users to clear a list of roles: if a role has been removed, it cannot be selected from a drop-down list, so the list needs to be reset and newly created with /config add_*🐛 Bug Fixes
+ fixed the missing deletion of a guild's entitlement cache when it removed the bot.🚀 Improvements
+ extended / rephrased text messages and notifications for better user experience
+ added a delay of 24h for entitlements (premium) checks on bot reboot. This avoids too frequently checks, which are foreseen to be done just once a day.
+ added additional system logging in order to verify, features are working well.
+ added cleanup logic for member activity and entitlement cache data on bot reboot, besides already existing guild configuration checks.

________________________________________________________________________________

Release Notes - v1.0.8 - 06.07.2025🐛 Bug Fixes
+ fixed an issue with automatic functions for freemium users
+ fixed in issue with localization strings during periodical license checks🚀 Improvements
+ removed command prefix "!" comletely
+ extended logging for license handling

________________________________________________________________________________

Release Notes - v1.0.7 - 05.07.2025🚀 Improvements
+ activated top.gg integration to push server count

________________________________________________________________________________

Release Notes - v1.0.6 - 04.07.2025🐛 Bug Fixes
+ fixed "incomplete setup" notification not initiated once per week
+ fixed guildtiers + checkpremium command issue leading to an NoneType error

________________________________________________________________________________

Release Notes - v1.0.5 - 02.07.2025🐛 Bug Fixes
+ fixed "incomplete setup" notification not initiated once per week (hopefully)🚀 Improvements
+ added top.gg libary and pushing server counts to them
+ disabled traditional prefix commands support (like !), as slash commands are used
+ reduced logging amount on backend side
+ completely refactored the /help command and removed /about and /list_commands; a list of commands can now be found in /help

________________________________________________________________________________

**Release Notes - v1.0.4 - 01.07.2025 **🐛 Bug Fixes
+ fixed an issue on wrong app commands sent to the bot, leading to TypeErrors🚀 Improvements
+ optimised the auto-reponse for direct messaging to the bot
+ if bot configuration becomes or stays incomplete: added a staff notification (limited to once per week), with a fallback message to the guild owner, if (and only if) staff channel is not specified or bot has no rights to post there

________________________________________________________________________________

Release Notes - v1.0.3 - 29.06.2025✨New Features
+ added config section for whitelisting channels, which are not being scanned for activities > if properly configured, this will avoid annoying "missing channel permission" warnings, if specific channels should not be scanned at all. start with /config add_whitelisted_channel⚠️ Known Issues
+ due to a larger database migration, guild settings got lost - which was not the case in the test environment. sorry for that! reconfigure the bot for your guild and it will work as expected again.

________________________________________________________________________________

Release Notes - v1.0.2 - 28.06.2025🐛 Bug Fixes
+ fixed the auto-default-role assignment on new member joins not working
+ fixed localization strings missing for several messages
+ fixed a TypeError in /checkpremium and other license related commands
+ fixed a TypeError with human member count🚀 Improvements
+ Increased the delay of the first inactivity-auto-check from 1h to 24h to not bother guilds with "setup incomplete" or "channel permission" warnings. Anyhow, the activity cache is filled in the background, which enables manual /reportinactivity reports.

💰 Freemium vs. Premium

  • 📈 Dynamic Inactivity Tracking: Metrics for engagement. Decay Scores grow with inactivity.

  • 🎯 Customizable Thresholds: Tailor trigger warnings, role changes, or kick suggestions.

  • ⚙️ Automated Actions: CleanerBot handles warnings, role assignments, and kicks.

  • 🛡️ Decay Boost Roles: Acknowledge contributors with slower decay.

  • 🔍 Transparency: Members can check Decay Score & understand what counts as activity.

  • 💬 Multi-Language Support: CleanerBot supports over 20 languages!

  • 📊 Detailed Reporting: Export decay data. Get comprehensive engagement trend analysis.

  • 🚫 No Bloat, No Spam: Focused purely on efficient community hygiene.

FeatureAll tiers
Manual inactivity report👍🏻
Fully automatic daily inactivity checks👍🏻
Auto role assignment + stripping👍🏻
Auto kicking after threshold, or manual kick after confirmation👍🏻
Custom inactivity & decay thresholds👍🏻
Whitelisting of channels (no activity scan)👍🏻
Export decay sore report👍🏻
Multi-language support (20+ languages)👍🏻

  • freemium : free (up to 100 guild members)

  • pro : $ 1.99 / month (up to 1,000 guild members)

  • scale : $ 3.99 / month (1,000+ guild members)

🙋🏻 Frequently Asked Questions (FAQ)

Getting Started

  1. Invite CleanerBot now.

  2. Click "Invite" and select your server.

  3. Review and grant required permissions: Manage Roles, Kick Members, View Channels, Read Messages, Read Message History, Send Messages, and Embed Links.

  4. In your Discord server, navigate to Server Settings -> Roles.

  5. Find the role named after your bot (e.g., "CleanerBot").

  6. Drag this role to a high position in the list, ideally just below your Administrator/Moderator roles. It must be above any roles it needs to manage (assign/strip) or members it might kick.

  7. Save Changes.

Configure Core Inactivity Settings

  1. Use /start to take advantage of a setup wizard, which will guide you through the process. You can also configure manually, if you want:

  2. Use the /config command or specific slash commands to tailor CleanerBot to your server. This is your main command to view and change most settings.

  3. CleanerBot revolutionizes community hygiene and retention through the introduction of an innovative Decay Scoring System. Unlike traditional leaderboard or XP bots, CleanerBot tracks member inactivity over time and links it directly to configurable moderation actions like warnings, role changes, or kick suggestions.

  4. Validate and, if complete, finalize the configuration with /config validate. View your configuration via /config show at every time.

Run Your First Report

See your current inactive members before the bot starts its autonomous work 24h after initial setup, by typing /report_decay.You can also check your own decay score at any time with /my_decay_score, or have a look on the leaderboard with /decay_top10.

Other Useful Commands

  • /help: Get help with CleanerBot or report an issue. This also lists all available commands.

  • /premium: Learn about CleanerBot's premium features and how to unlock them!

  • /checkpremium: Check the current premium status for your guild.

  • /exportactivity: Exports the activity cache as a CSV file.

  • /next_check: Shows the next scheduled run of the automatic inactivity check.

  • /guildtiers: View the member limits for each tier.

🫶🏻 Showcase : some real-life impressions

Some of the messages shown, like the inactivity warnings or kick notifications, are examples of what a guild member would typically see. These are standard, individualized communications from the bot to your members.