ModerAIdor Docs

Introduction

ModerAIdor is a Telegram bot for crypto communities that need more than a basic anti-spam shield. It combines AI-powered moderation, project knowledge answers, wallet-aware holder mechanics, game flows, and referral rewards.

All group configuration is done from the personal cabinet at moderaidor.com/cabinet — no bot commands needed for setup. The bot itself handles player-side actions: wallet login, game participation, and referrals.

Getting Started

There are two separate paths: group owner and player. Pick the one that applies to you.

Admin rights and requirements

ModerAIdor needs Telegram admin rights to moderate properly. Without them, the bot cannot delete spam, mute or ban users, or manage game and cleanup flows.

Personal Cabinet

The cabinet at moderaidor.com/cabinet is where all owner configuration lives. You authenticate with Telegram once and manage all your groups from one place.

What you can configure in the cabinet

• General settings — project name, description, moderation level, language, allowed links, banned words
• Knowledge base — paste a full document or upload a .txt file; the bot splits it into searchable chunks automatically
• Inactive cleanup — set threshold in days; members who have not posted in X days will be removed without permanent ban
• Billing — subscribe via Xaman; payment is verified on-chain automatically
• Games / LBS — configure Last Buyer Standing: asset mode (XRP or token), entry fee, prize pool, schedule, and manual launch
• Holder ranks — connect your token issuer, define rank titles and balance thresholds

Connecting your XRPL wallet

Click Connect Xaman in the cabinet header to link your XRPL wallet. Once linked, payments and top-ups from the cabinet will send push notifications to your Xaman app when possible, and always show a QR code as fallback.

Group setup

The full setup is now done from the cabinet. There are no more bot setup commands required for configuration.

Recommended first-time setup sequence

1. Add the bot to the group and grant admin rights.
2. Open the cabinet → your group should appear automatically.
3. Fill in General settings: project name, description, moderation level.
4. Upload your Knowledge base as one text document.
5. Activate a Billing plan to unlock full token limits.
6. Configure Games, Holder ranks, and Inactive cleanup as needed.

Knowledge Base

The knowledge base is what makes ModerAIdor useful beyond moderation. It is the source for AI answers in group chats, so weak source material means weak answers.

What to put into the knowledge base

• Project summary
• Utility and token facts
• FAQs
• Rules and moderation expectations
• Common confusion points or scam warnings

What good entries look like

• Short
• Factual
• Specific
• Updated when the project changes

Moderation

ModerAIdor is built to reduce admin busywork in active Telegram groups. It can handle spam, shilling, repetitive abuse and direct moderation commands.

Manual moderation commands

These commands are typically used by replying to a user message in group.

Automated moderation behavior

• Spam and shill filtering
• Duplicate and flood detection
• Media duplicate handling for repeated GIFs, stickers, photos and videos
• AI-assisted handling where project-specific knowledge matters

Holder ranks

Holder-rank logic is useful for communities that want wallet-aware status systems, access layers or title mechanics tied to holdings.

Telegram still imposes title limitations: custom admin titles are for administrators only. If your design requires visible rank labels for non-admins, you need a different UX pattern than Telegram custom titles.

Games and LBS

ModerAIdor can support game flows and wallet-linked participation. For XRP-native communities, native XRP mode is relevant because it avoids forcing a token-style issuer and currency flow where native XRP is the correct asset.

Typical flow

1. Owner configures the group and game settings.
2. Player opens bot DM and links wallet if required.
3. Player returns to group and taps Play when a round is live.

Player mode

Players do not need to own a group or configure anything. They only need a Xaman wallet to participate in game flows and earn referral rewards.

Player setup

1. Open the bot in Telegram DM and tap Start.
2. Tap Log In and sign the request in Xaman to link your XRPL wallet.
3. Once linked, go to the group where LBS is running.
4. Tap Play when a round is announced in the group.
5. Approve the entry payment in Xaman — you are now in the round.

Referral rewards

Each player gets a unique referral link. When someone pays for a subscription using your link, you automatically earn a percentage of the payment in XRP — paid out on-chain.

Find your referral link in the bot DM under My referral link.

Inactive cleanup

Inactive cleanup is designed for communities that want to prune silent members without permanently banning them.

How it works

• Uses group activity, not Telegram-wide last seen
• Tracks whether a user has written in the group within X days
• Sends a preview of users who are on track to be removed next
• Removes users by kick without permanent ban

Commands

Most owner configuration is done in the cabinet. The commands below are for moderation actions and player-side flows that happen directly in Telegram.

FAQ

Where do I configure the bot?

Everything is in the personal cabinet at moderaidor.com/cabinet. Sign in with Telegram, select your group, and manage all settings from there.

My group does not appear in the cabinet

Make sure you added the bot to the group while logged in to the Telegram account you are using in the cabinet. The account that added the bot becomes the group owner. If someone else added it, sign in with their account.

Why does the bot need admin rights?

Telegram limits what bots can do without them. Delete messages and restrict members are the minimum required for moderation to work.

Why are my AI answers weak?

The knowledge base is the source. Vague, thin, or outdated content produces weak answers. Upload a clean, factual document and re-test.

Xaman push notifications stopped working

Xaman user tokens expire when users reinstall the app or switch devices. The cabinet will still show a QR code and deeplink for manual signing. The token refreshes automatically on the next Xaman interaction.

Payment was signed but subscription did not activate

The system checks all pending payments every 30 seconds and activates them automatically once the on-chain transaction is confirmed. If it still does not activate after a few minutes, contact support with your transaction hash.

Can the bot assign titles to non-admins?

No. Telegram only allows custom admin titles for users who have admin rights. That is a Telegram platform limitation.

Can the bot remove inactive users without banning them permanently?

Yes. Inactive cleanup uses a kick without permanent ban, so removed members can rejoin later.

Troubleshooting

The bot does not moderate anything

Check that it is an administrator in the group and has the required permissions.

The bot answers questions badly

Review the knowledge base first. Weak source data usually causes weak answers.

Players get sent into setup

That means the player flow and owner flow are not being cleanly separated. Player DM UX should expose login and help, not owner setup.

Inactive cleanup is not removing some people

Telegram admins and group creators cannot be treated like normal members by a bot. Some skips are expected because of Telegram permission rules.