Anonymous Chat Bot

A Telegram bot for anonymous chatting with referral system and profile-based random chat.

Generate Convert Improve

Install / Use

npx skills add Sobhan-SRZA/Anonymous-Chat-Bot

Installs into whichever agent you are using.

About this skill

Quality Score

0/100

README

Anonymous Chat Bot 🤖

This project is a Telegram bot that enables users to chat anonymously. It features a referral system where each user can generate a unique referral link (without revealing their Telegram ID), profile creation (e.g., setting gender), and random anonymous chat options with filtering.

Note: The bot supports various message types (text, stickers, photos, files, voice messages, videos, etc.) by copying messages so that the sender’s identity remains hidden.

Features ✨

Anonymous Chat: Chat with random users without revealing your personal details.
Referral System: Generate a unique referral code and share your referral link without exposing your Telegram user ID.
Profile Management: Set up your profile (e.g., gender) for filtered random chats.
Multi-type Messaging: All message types (text, photo, sticker, video, etc.) are forwarded/copyed anonymously.
Database Integration: Uses quick.db with JsonDriver for storing non-sensitive data like profiles and referral codes.

Prerequisites ⚙️

Node.js (v14 or higher recommended)
Telegram Bot Token: Create a bot via BotFather and obtain your bot token.

Setup Instructions 🚀

1. Clone the Repository

git clone https://github.com/yourusername/anonymous-chat-bot.git
cd anonymous-chat-bot

2. Install Dependencies

npm install

3. Configure the `.env` File

Create a .env file in the root directory. Make sure to provide values for at least token and database_type.
Below is an example configuration:

# Bot token (required)
token="YOUR_TELEGRAM_BOT_TOKEN"

# Database type (required): options are "mysql" | "sql" | "mongodb" | "json"
database_type="json"

# (Optional) If using MongoDB:
database_mongoURL="your-mongo-url"

# (Optional) If using MySQL:
database_msql_host="your-mysql-host"
database_msql_user="your-mysql-user"
database_msql_password="your-mysql-password"
database_msql_database="your-mysql-database"

# Source owners (optional, comma-separated list of owner IDs)
owners='["123456789", "987654321"]'

# Anti crash controller (optional)
anti_crash="true"

4. Running the Bot

You can run the bot in development mode using ts-node:

npm start

Or compile the TypeScript code to JavaScript and run it:

npm run build
node dist/index.js

Available Commands 📜

| Command | Description | Emoji | | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ----- | | /help | Preview all bot avalible commands with description. | ⚒ | | /link | Send or create a referral link of your anonymous chat invite. | 🔗 | | /settings | Your settings in bot. (With using buttons you can customize your bot profile.) | ⚙ | | /start | Starts the bot. Without parameters, it shows usage instructions. With a referral parameter (<referralCode>), it connects you with a partner. | 🚀 | | /stop | Stops the current chat session and removes you from any waiting queues. | ✋ |

Packages & Versions 📦

| Package | Version | Description | Emoji | | --------------------- | ------- | ---------------------------------------------------------------------------------------------- | ----- | | telegraf | ^4.16.3 | Telegram bot framework for interacting with the Telegram Bot API. | 🤖 | | dotenv | ^16.4.7 | Loads environment variables from a .env file. | 🌱 | | quick.db | ^9.1.7 | A simple SQLite-based database using JsonDriver for storing bot data. | 🗄️ | | colors | ^1.4.0 | Adds color support to console messages, making debugging output more visually appealing. | 🎨 | | @types/node | ^22.5.0 | TypeScript definitions for Node.js, providing type checking and IntelliSense for Node.js APIs. | 📚 | | typescript | ^5.5.4 | A superset of JavaScript that compiles to plain JavaScript and provides static type checking. | 💻 |

License

This project is licensed under the BSD 3-Clause License.

Final Steps

Ensure your .env file is properly configured with at least the token and database_type values.
Run npm install to install all dependencies.
Start your bot using npm start (or build and run the compiled JavaScript => npm run start:build).

Enjoy using the Anonymous Chat Bot and feel free to extend its functionality as needed!

Contact

Related Skills

node-connect

385.5k

Diagnose OpenClaw Android, iOS, or macOS node pairing, QR/setup code, route, auth, and connection failures.

Writing Hookify Rules

140.7k

This skill should be used when the user asks to "create a hookify rule", "write a hook rule", "configure hookify", "add a hookify rule", or needs guidance on hookify rule syntax and patterns.

agent-tui

106.4k

Main Agents: Do NOT use this skill directly. If you need to test the TUI, invoke the `tui_tester` subagent. Drive terminal UI (TUI) applications programmatically for testing, automation, and inspection

review-duplication

106.4k

Use this skill during code reviews to proactively investigate the codebase for duplicated functionality, reinvented wheels, or failure to reuse existing project best practices and shared utilities.

Sobhan-SRZA

View profile

View on GitHub

GitHub Stars4

CategoryDevelopment

Updated6mo ago

Forks0

Sobhan-SRZA/Anonymous-Chat-Bot

Languages

TypeScript

Security Score

82/100

Audited on Feb 8, 2026

No findings