A full-packed Telegram moderation bot built with TypeScript .

WatchWomenBot is a lightweight Telegram moderation bot built TypeScript .
It helps group admins protect their communities by automatically detecting and removing scams, spam, and unwanted content.

Easy to deploy, extend, and maintain — perfect for beginners who know Node.js and want to dive into Telegram bot development!

• Auto-remove scam messages 🚫
• Detect spam patterns 🕵️‍♂️
• Basic moderation commands (warn, ban, mute) 🛠️
• Logging of moderation actions 📜
• Simple setup and deployment 🚀
• Built with TypeScript for better developer experience 💻

WatchWomenBot is designed for:

• Group admins who want automated protection without overcomplicated setups
• Developers looking for an open-source base to build their own moderation bots
• Node.js beginners learning how to build and deploy Telegram bots

Instead of spending hours fighting spam manually, just add WatchWomenBot to your group and let it handle the mess!

1. Clone the repository

   git clone https://github.com/nuhmanpk/watchwomen.git
   cd watchwomen

2. Install dependencies

   npm install

3. Create a .env file

   Get your Bot Token from @BotFather

   BOT_TOKEN='your-telegram-bot-token-here'

4. Run the bot locally (development mode)

   npm run dev

5. Build for production

   npm run build

6. Start production server

   npm start

1. /start - Start bot.
2. /help - Get Help.
3. /report - Report a user message in groups.
4. /purgue - Delete Messages from group.

1. Service Message cleaning.
2. On Boarding Messages.
3. Greetings for join and left group.

• Nuhman PK

This project is licensed under the GNU GPLv3 License.

• Inspired by moderation bots like Marie and Ross, but built for Node.js developers.
• Focused on simplicity and learning.
• Contributions welcome! Feel free to open issues or submit PRs 🚀

Made with Python ❤️ By Nuhman