# CleanerBot - Full Snapshot

CleanerBot is a Discord inactivity bot that helps servers manage inactivity fairly over time. It uses a transparent Decay Score and supports warnings, inactivity roles, manual review, and optional removals without reading or storing message content.
No automatic removals happen unless explicitly configured.

CleanerBot operates without privileged intents and focuses on privacy-first, explainable inactivity cleanup for Discord communities.

In the current production sample, filtered to setup-complete communities with tracked members and cleanup intervention history, observed recovery signals appeared after 7,380 of 19,810 cleanup intervention events (37.3%) across 321 communities and 26,815 tracked members: 5,399 of 12,496 warning events (43.2%) and 1,981 of 7,314 inactive-role actions (27.1%). This is an operational recovery signal, not a controlled causal-lift study, not a deduplicated unique-member count, and not a guarantee that every recovered member stayed active forever.

## Disambiguation
CleanerBot is not a message purge / bulk-delete bot.
Not to be confused with bots named ‘Cleaner’ that delete messages.
CleanerBot (cleanerbot.eu) is a Discord inactivity management bot and is not affiliated with bots named ClearerBot, Cleaner, or The Cleaner, nor with mobile storage-cleaner apps using similar names.

## What CleanerBot does
- Tracks inactivity over time with a Decay Score.
- Decay Score decisions are transparent and explainable.
- Sends warnings at configured thresholds.
- Assigns an inactivity role at configured thresholds.
- Records recovery signals when inactive cases become active again after cleanup nudges.
- No forced kicks: removals happen only if explicitly configured.
- Supports manual kick review flows with clickable non-pinging member profile mentions; auto-kick is optional.
- Admins can set `/config set auto_kick_daily_limit` from 1 to 200 to lower Auto-Kick throughput for compatibility with security bots. The configured value caps each run, each UTC hour, and each UTC day, while CleanerBot's lower built-in guardrails always remain authoritative.
- Inactive roles can be used without removing members.
- Offers transparent member self-checks via `/my_score`, including a 14-day active/quiet calendar and a path to member-controlled `/notifications` opt-in DM reminders.

## Privacy & data handling
- No message content is processed or stored.
- No privileged intents are required for core operation.
- Stores Discord IDs, guild/user names (for UX), and activity metadata (counts/timestamps) needed to compute scores.
- No cross-server activity profiling for moderation/Decay Score (computed per server).
- Core bot data hosted in the EU (Germany); some providers may process limited technical data outside the EEA (see Privacy Policy).

## Key concepts
### Decay Score
A per-member inactivity score that increases during inactivity and drops or resets when members participate.

CleanerBot's Decay Score is a member-level inactivity signal. It is not XP and not a global reputation score. It increases when a member has no configured activity and decreases or resets when the member participates again, depending on server configuration. Server admins configure thresholds for warning, inactive role, kick review, and optional guarded auto-kick. CleanerBot uses activity signals and limited metadata needed for operation; it does not read or store message content. Decay Score is separate from Activity Health Score, which is a server-level aggregate health signal and does not trigger moderation actions by itself.

### Ghost Mode vs Standard Mode
Standard Mode posts member-facing warnings in configured channels and uses Inactive Role Overlay by default. Ghost Mode is the safest quick start: staff-only tracking, no public warnings, no member CTAs, and no automatic kicks.

### Thresholds / presets
Quick Start (Standard) preset defaults: Inactive Role Overlay, warn 21 days, inactive 42 days, kick 89 days.

## Pricing (USD)
- Free: $0/month, <= 200 tracked members.
- Pro: $1.99/month, <= 500 tracked members, Premium Staff Reviews via `/review`, rolling saved review history, and CSV exports.
- Scale: $3.99/month, unlimited tracked members, Premium Staff Reviews via `/review`, rolling saved review history, and CSV exports.
Bulk Upload is available as a coverage helper on Free, Pro, and Scale. Admins can choose during preflight to apply configured restore/swap roles to newly seeded members. The bulk upload guide also points admins to `/checkin` when they do not have a clean roster and want coverage to grow through normal reaction activity. If a Free server exceeds the Free tracked-member limit, stored settings and supported admin checks remain available while automated communication, actions, and unmanaged background work may pause or reduce until Pro or Scale is active. Long-dormant servers may also have nonessential activity data pruned.
Tracked members are the members CleanerBot currently tracks and scores for inactivity in this server.
If a tier limit is reached, automated communication and actions pause until upgrade, including warning posts, recovery notices, member DMs, role changes, reward automation, polls, kick review, and auto-kick.

## Setup / onboarding (high level)
1. Invite CleanerBot to your server.
2. Run `/start` to launch the setup wizard.
3. Choose Standard Mode or Ghost Mode, then confirm thresholds and channels. Ghost Mode is the safest quick start for staff-only tracking.
4. Monitor results and adjust thresholds as needed.
5. Optional static post-invite landing page: https://cleanerbot.eu/welcome/
6. Permission model: `Manage Roles` is required for role automation; `Kick Members` is only needed when kick actions are actually used.

## Commands & configuration
CleanerBot supports `/start`, `/my_score`, `/notifications`, Premium `/review` Staff Reviews including `/review history`, and admin tools such as `/purge_channel` for optionally member-filtered cleanup. Admins can use `/checkin` to post a reaction-based server check-in reminder after preflight checks confirm reactions count as activity, the target channel is tracked, and required channel permissions are available; low-coverage staff advisories can point admins to this flow when reactions are available as an activity source. Admins can use `/config set auto_kick_daily_limit <1-200>` to set one compatibility value that lowers the effective per-run, per-UTC-hour, and per-UTC-day Auto-Kick limits; `/config show` displays the configured and effective values. When activity streaks are enabled, a default-on weekly option posts the first current leaderboard page to the warning channel every Monday; admins control it with `/toggle weekly_leaderboard`. Admins can also opt into `/config reports weekly_inactivity` to post a clean Monday inactivity report to the staff channel with members near or over action thresholds. Community Pulse (`/pulse view`) turns aggregate AHS-backed activity into a privacy-safe visual server scene with a theme, scene, plain meaning, suggested action, and privacy footer. Free servers get a private real-state preview, while Premium servers can configure themes, public scene posting, milestones, and hidden nudges with `/pulse setup`. Premium review cards can be saved to rolling history when admins want to retain the aggregate review, and `/review history` can summarize saved engagement, coverage, and channel-health trend context when enough aggregate records exist. Free `/score` cards can preview whether the current 7-day AHS trend is positive, negative, or steady before Premium unlocks retained Staff Review history. For up-to-date command coverage and releases, use the changelog:
- https://cleanerbot.eu/changelog/
- Full command explorer: https://cleanerbot.eu/features/commands/
- How CleanerBot works: https://cleanerbot.eu/features/how-it-works/

## Recent releases
- https://cleanerbot.eu/changelog/v3-9-0/
- https://cleanerbot.eu/changelog/v3-8-0/
- https://cleanerbot.eu/changelog/v3-7-0/
- https://cleanerbot.eu/changelog/v3-6-0/
- https://cleanerbot.eu/changelog/v3-5-0/
- https://cleanerbot.eu/changelog/v3-4-0/
- https://cleanerbot.eu/changelog/v3-3-0/
- https://cleanerbot.eu/changelog/v3-2-0/
- https://cleanerbot.eu/changelog/v3-1-0/
- https://cleanerbot.eu/changelog/v3-0-1/
- https://cleanerbot.eu/changelog/v3-0-0/
- https://cleanerbot.eu/changelog/v2-20-0/
- https://cleanerbot.eu/changelog/v2-19-2/
- https://cleanerbot.eu/changelog/v2-19-1/
- https://cleanerbot.eu/changelog/v2-19-0/
- https://cleanerbot.eu/changelog/v2-18-0/
- https://cleanerbot.eu/changelog/v2-17-5/
- https://cleanerbot.eu/changelog/v2-17-4/
- https://cleanerbot.eu/changelog/v2-17-3/
- https://cleanerbot.eu/changelog/v2-17-2/

## Canonical links
- https://cleanerbot.eu/
- https://cleanerbot.eu/facts/
- https://cleanerbot.eu/trust/
- https://cleanerbot.eu/welcome/
- https://cleanerbot.eu/#features
- https://cleanerbot.eu/features/
- https://cleanerbot.eu/features/how-it-works/
- https://cleanerbot.eu/features/discord-decay-score/
- https://cleanerbot.eu/features/clean-inactive-discord-members-fairly/
- https://cleanerbot.eu/features/explain-inactivity-rules/
- https://cleanerbot.eu/features/commands/
- https://cleanerbot.eu/features/activity-health-score/
- https://cleanerbot.eu/features/community-pulse/
- https://cleanerbot.eu/features/auto-kick-guardrails/
- https://cleanerbot.eu/features/inactivity-policy-template/
- https://cleanerbot.eu/features/bulk-upload/
- https://cleanerbot.eu/compare/privacy-vs-message-reading/
- https://cleanerbot.eu/compare/discord-prune/
- https://cleanerbot.eu/compare/inactive-role-vs-kick/
- https://cleanerbot.eu/compare/xp-bots-vs-inactivity-management/
- https://cleanerbot.eu/pricing/
- https://cleanerbot.eu/terms.html#privacy
- https://cleanerbot.eu/use-cases/
- https://cleanerbot.eu/changelog/
- https://cleanerbot.eu/status/
- https://cleanerbot.eu/status.json
- https://cleanerbot.eu/.well-known/security.txt
- https://discord.com/discovery/applications/1368223375364980746
- https://top.gg/bot/1368223375364980746
- https://discord.gg/wCdnv48vFM
- https://buymeacoffee.com/bjoerrn
- https://botlist.me/bots/1368223375364980746
- https://discordbotlist.com/bots/cleanerbot
- https://discords.com/bots/bot/1368223375364980746
- https://disq.ink/bot/1368223375364980746
- https://radarcord.net/bot/1368223375364980746
- https://discordlist.gg/bot/1368223375364980746
- https://discord.place/bots/1368223375364980746
- https://omniplex.gg/bot/1368223375364980746
- https://voidbots.net/bot/1368223375364980746
- https://stellarbotlist.com/bot/1368223375364980746
- https://cybralist.com/bots/1368223375364980746
- https://www.vcodes.xyz/bot/1368223375364980746
- https://discordservices.net/bot/cleanerbot
- https://discord.bots.gg/bots/1368223375364980746
- https://discordextremelist.xyz/en-US/bots/cleanerbot
- https://discollab.org/bots/1368223375364980746
- https://discordthings.com/bot/1368223375364980746
- https://discordforge.org/bot/1368223375364980746

Last updated: 2026-07-12