discord-message-cleaner

DiscordMessageCleaner

Cleans messages from a discord channel older than a set time in days

Setup

pip install discord-message-cleaner

🚀 Setting Up & Inviting DeleteBot

• Create a Discord Application

  • Go to the Discord Developer Portal.
  • Click New Application, give it a name (e.g. “DeleteBot”), and save.

• Add a Bot User

  • In your application sidebar, select Bot → Add Bot → Yes, do it.
  • Under Privileged Gateway Intents, enable Message Content Intent.

• Generate an Invite Link

  • In the sidebar, go to OAuth2 → URL Generator.
  • Under Scopes, check: bot
  • Under Bot Permissions, check at minimum:
    • Read Message History
    • Manage Messages
  • Copy the generated URL at the bottom.

• Invite to Your Server

  • Paste the URL into your browser, select your server, and authorize.

Run

discord_message_cleaner
  --token=<your_discord_bot_token>
  --channel_id=<your_discord_channel_id>
  --days=<number_of_days>

Docker

docker run -d \
  --name="DiscordMessageCleaner" \
  -e 'TOKEN=<your_discord_bot_token>'
  -e 'CHANNEL_ID=<your_discord_channel_id>'
  -e 'DAYS=<number_of_days>'
  rix1337/docker-discord-message-cleaner:latest