Complete Documentation

Everything you need to know about LoFi Girl's features, commands, and setup

Getting Started Token Groups Private Groups Moderation Premium Features Analytics Crypto Commands Troubleshooting

🚀 Getting Started

Quick setup guide to get LoFi Girl running in your group

1

Add to Group

Add @LofiBNBGirl_Bot to your Telegram group with admin permissions (Delete Messages, Restrict Members, Invite Users, Pin Messages)

/start
2

Configure Settings

Send /config to the bot in a private message (DM) to access the full configuration dashboard

/config
3

Setup Wizard

Use /setup_wizard for guided setup based on your group type (Token Project or Private Trading Group)

/setup_wizard

🪙 Token Groups

Features designed for single-token project communities

/settoken [address]

Set your group's token contract address for crypto features

Example: /settoken 0xC20aAFb86A05df6DeffDF8DbF89983089B224331
/price

Get current token price (requires /settoken first)

/mcap

View market capitalization of your group token

/volume

Check trading volume for your token

/links

Display project links and social media

/summary

Get AI-generated group chat summaries

Example: /summary 7d for weekly summary
/guard Premium

Token-gated group access system

Requires holding $LOFIBNB tokens
/raider Premium

Twitter KOL monitoring and auto-raiding

🔐 Portal Verification Premium

Protect your token group from bots and spam. Configure via /config → Portal Settings. Automatically verifies users before they can join your group.

🛡️ Anti-Spam & Protection

/antispam

Smart spam detection with trust levels

/nsfwfilter

Block inappropriate content automatically

/nobots

Prevent unauthorized bot additions

/nolinks

Block links from non-admins

🔒 Private Trading Groups

Features for invite-only alpha groups tracking multiple tokens

/calls

View all your token calls in this group

/lb [timeframe]

Leaderboard of best performing calls

Examples: /lb 24h, /lb 3d, /lb 1w
/pnl [contract]

Check profit/loss since you shared a token

Example: /pnl 0x1234...
/analytics [timeframe]

Group performance dashboard

Examples: /analytics 24h, /analytics 7d
/mystats

Your personal trading analytics

/alphas [timeframe]

Alpha calls leaderboard

Examples: /alphas 1d, /alphas 7d
/myalphas

View your alpha calls and win rate

/groupperf

Group performance summary for sharing

/quality_report

Admin-only report on call quality (identifies poor performers)

📊 Automatic Token Detection

LoFi automatically detects when users share contract addresses in your group and tracks their performance. No commands needed - just share a contract address!

🛡️ Moderation & Protection

Keep your group safe and well-moderated

/kick @user

Kick a user from the group (Admin Only)

/unban @user

Unban a previously banned user (Admin Only)

/mute @user

Mute a user permanently (Admin Only)

/mute5 @user

Mute for 5 minutes (also: mute10, mute15, mute30, mute60)

/unmute @user

Remove mute from a user (Admin Only)

/warn @user

Warn a user (3 warnings = auto kick) (Admin Only)

/clearwarns @user

Clear all warnings for a user (Admin Only)

/pin

Pin message with AI commentary (Admin Only)

/report

Report spam (reply to message)

🔒 Advanced Protection

/antispam

Smart spam detection with trust levels

/nsfwfilter

Block inappropriate content automatically

/imagefilter

Filter inappropriate images/media

/nobots

Prevent unauthorized bot additions

/nolinks

Block all links from non-admins

/noforwards

Block forwarded messages

/novoice

Block voice messages

/antiflood

Prevent message flooding (>10/min)

/nocommands

Block bot commands from users

/nohashtags

Block hashtag usage

/nolocations

Block location sharing

/nocontacts

Block contact sharing

📝 Content Filtering

/blacklist

View current blacklisted words

/blacklist_add word1, word2

Add words to blacklist (bulk supported)

/blacklist_remove word

Remove specific word from blacklist

/blacklist_clear

Clear entire blacklist

/save keyword response

Create custom filter with text/media (Admin Only)

Can attach photos, videos, or stickers
/filterai keyword response

Create AI-powered personalized filter (Admin Only)

/filters

List all active filters (basic and AI)

/delfilter keyword

Delete a custom filter (Admin Only)

👥 Inactivity Management

/inactivity_check

Manual inactivity scan (Admin Only)

/inactivity_status

View current status & stats (Admin Only)

/inactivity_analytics

Comprehensive inactivity reports (Admin Only)

/protect_member @user

Protect VIP members from auto-removal (Admin Only)

/unprotect_member @user

Remove protection from member (Admin Only)

/bulk_protect @user1,@user2 reason

Protect multiple members at once (Admin Only)

💎 Premium Features

Token-gated features requiring $LOFIBNB holdings

🛡️ LoFi Guard Premium

Token-gated group access system. Configure via /guard or /config → Guard Settings.

/guard

Access Guard configuration and status

Tiers: Free (CAS protection), Silver (1M $LOFIBNB), Gold (5M $LOFIBNB)

🚀 LoFi Raider Premium

Twitter KOL monitoring and auto-raiding system. Configure via /raider or /config → Raider Settings.

/raider

Complete Raider guide & setup (DM only)

/raid [twitter_url]

Launch a raid mission (Admin Only)

Example: /raid https://twitter.com/user/status/123
/raidconfig

View Raider settings (Admin Only)

/raidleaderboard

Top LoFi Raiders in your group

/addkol @username

Add KOL to monitor (Admin Only)

/removekol @username

Remove KOL from monitoring (Admin Only)

/listkols

List all monitored KOLs

/budgetstatus

Check Twitter API budget usage

Tiers: Free (5 raids/day), 0.5% Tier (5M $LOFIBNB), 1% Tier (10M $LOFIBNB)

🎵 Music Premium Premium

Voice chat music streaming. Configure via /music or /config → Music Settings.

/music

Access Music Premium configuration

/play [url]

Start music in voice chat

Supports YouTube and Spotify URLs
/stop

Stop music playback

/musicstatus

Show current music status

Tiers: Free (1 playlist, 20 songs), Gold (2M $LOFIBNB - unlimited)

📊 Analytics & Gamification

Track engagement, rank users, and reward activity

/leaderboard

View top active members by composite rank score

/myrank

Check your ranking and detailed metrics

/info

Get detailed user statistics

/achievements

View earned achievement badges

/mentionall

Mention all active group members

/mentionall_config

Configure @all mention settings (Admin Only)

/mentionall_stats

View mention statistics and success rates

📈 Rank Score System

LoFi uses a composite score to rank users, combining:

  • Activity (30d): Total messages over last 30 days (normalized by group size)
  • Recent Activity (7d): Weighted 7-day activity for current momentum
  • Engagement (30d): Replies, mentions, reactions given/received
  • Achievements: Bronze/Silver/Gold badges award points
  • Consistency Streak: Consecutive active days bonus

💰 Crypto Commands

Token price, market data, and blockchain information

/settoken [address]

Set group's token contract address (Admin Only)

Example: /settoken 0xC20aAFb86A05df6DeffDF8DbF89983089B224331
/price

Get current token price (requires /settoken first)

/mcap

View market capitalization

/marketcap

Alternative to /mcap

/volume

Get trading volume data

/links

Display project links and socials

/socials

Alternative to /links

/summary [timeframe]

AI-generated chat summaries

Examples: /summary 7d, /summary 30d

🔍 Automatic Token Detection

LoFi automatically detects contract addresses shared in your group and fetches token data from DexScreener. No commands needed - just share a contract address!

⚙️ Group Management

Configure and customize your group experience

/config

Access full configuration dashboard (DM only)

Configure AI behavior, moderation, analytics, and more
/setup_wizard

Guided setup based on group type

/welcome

Set custom welcome message for new members (Admin Only)

/stickers

Manage sticker reaction settings

/help

Show all available commands

🤖 AI Features

LoFi responds naturally to messages in your group. Configure response frequency, personality mode, and engagement settings via /config.

  • Dead Chat Revival: Automatically revives inactive groups
  • Being Ghosted Detection: Detects when chat is active but LoFi isn't mentioned
  • AI Filters: Create personalized responses with /filterai
  • Smart Moderation: AI-powered content filtering and spam detection

🔧 Troubleshooting

Common issues and solutions

🤐 Bot Not Responding

Solution:

  • Check if bot has proper admin permissions
  • Verify bot is added to the group
  • Try mentioning the bot directly: @LofiBNBGirl_Bot
  • Use /start command to reinitialize

⚠️ Moderation Not Working

Solution:

  • Ensure bot has "Delete Messages" permission
  • Check if moderation is enabled in /config
  • Verify warning thresholds are properly set
  • Admin users are exempt from moderation

💰 Crypto Commands Failing

Solution:

  • Set group token first with /settoken [address]
  • Check if the token address is valid
  • Ensure token is listed on DexScreener
  • Try using the full contract address

💎 Premium Features Not Working

Solution:

  • Verify you hold the required $LOFIBNB tokens
  • Check your wallet is connected via /config
  • Ensure token balance meets tier requirements
  • Try disconnecting and reconnecting wallet

📊 Stats Not Updating

Solution:

  • Statistics update in real-time but may have slight delays
  • Private messages aren't counted in group stats
  • Bot needs to be active for at least 24 hours for full stats
  • Ensure analytics tracking is enabled in /config

🔐 Portal Verification Issues

Solution:

  • Configure portal channel via /config → Portal Settings
  • Ensure bot is admin in the portal channel
  • Check invite links are being generated correctly
  • Verify risk detection settings