For the complete documentation index, see llms.txt. This page is also available as Markdown.

Nova Guardian

Nova Guardian is a passive community-protection shield. Once an admin turns it on, Nova silently screens every message in your Discord server or Telegram group for scam intent and social engineering β€” not just links β€” and takes graduated, configurable action.

The hard part of community safety isn't banning links (servers already do that) β€” it's the text-based lures that carry no link at all. Guardian reads intent with an LLM, so it catches paraphrases, typos, leetspeak and letter-spacing tricks that keyword blocklists miss.

Guardian is admin/moderator-only and group-only β€” it can't be set up in a DM, and only a server/group admin or moderator can enable or change it. Turning it on protects the whole server/group, not just one channel.


What It Catches

Pattern
Example

🎣 Fake hiring / recruiting

"We're onboarding mods/testers/ambassadors β€” DM me", fake remote web3 jobs, pay-per-task lures

πŸͺ‚ Fake airdrops / claims

"Claim your airdrop", "verify your eligible wallet", "check eligibility", fake free-mints

πŸ”‘ Seed / wallet harvesting

Asking for or "buying old/inactive wallets", "paying for seed phrases", "import/sync/restore your wallet"

🎭 Team / admin impersonation

"Official support here, DM me to resolve", or a name that mimics a real admin

πŸ“¨ DM-bait / off-platform lures

"Let's continue in DM", "message me on WhatsApp/Telegram/Signal"

πŸ’Έ Send-to-receive / advance-fee

"Send 0.1 get 0.2 back", "double your crypto", "first 50 only", guaranteed-return giveaways

πŸ”— Malicious / phishing links

Lookalike domains, wallet-drainer sites, fake claim/mint pages, hidden URL shorteners


How It Decides β€” the action ladder

Every message gets a verdict, and each tier has its own action:

Verdict
What Nova does

Clean

Nothing.

Suspicious

Silently posts a mod-review card to your review channel β€” author, age, reason, message link. No public action.

Scam (high-confidence)

Posts the review card and (only if you've turned on enforcement) auto-deletes the message and mutes/timeouts the author.

Sensitivity modes

Mode
Behavior

Lenient

Only the most blatant scams are flagged β€” fewest false positives.

Balanced (default)

Sensible middle ground.

Strict

Catches more, flags more for review β€” a few more false positives for mods to dismiss.

Trusted, established members are held to a lighter standard than brand-new accounts, so a long-time member and a fresh account posting the same line aren't treated the same.


Set It Up β€” just talk to Nova

There's no wizard β€” you configure Guardian conversationally. In your server/group (as an admin/mod), @mention Nova or reply to it:

  1. Turn it on:

    • "@Nova turn on Guardian / scam protection for this server"

    • Nova enables flag-only screening for the whole server/group and posts review cards to the channel where you enabled it.

  2. Point it at a mod channel (optional):

    • "send Guardian flags to #mod-review" (Discord) β€” defaults to the enable channel otherwise.

  3. Tell it who the real admins are (so it can catch impersonators):

    • "the real admins are @alice and @bob"

  4. Add allowlist phrases that are normal for your community:

    • "allowlist 'buying wallets' β€” this is an OTC channel"

  5. Turn on enforcement when ready:

    • "enable auto-delete and auto-mute for scams" Β· "mute scammers for 2 hours"

  6. Tune sensitivity / check status anytime:

    • "make Guardian stricter" Β· "is Guardian on?" Β· "how many scams did Guardian catch this week?"

    • "turn off Guardian"

Bot permissions for enforcement. To auto-delete and mute, the bot needs the right permissions β€” on Discord: Manage Messages + Moderate Members; on Telegram: make the bot an admin with the restrict members right. If a permission is missing, Guardian falls back to flag-only and tells you exactly what to grant.


Configuration Options

Option
What it does

Mode

strict / balanced / lenient detection sensitivity

Mod-review channel

Where flag cards are posted (defaults to where you enabled it)

Auto-delete

Auto-remove high-confidence scam messages (default off)

Auto-mute

Timeout/mute the author of a high-confidence scam (default off)

Mute duration

How long an auto-mute lasts (default 60 minutes)

Allowlist

Phrases that must never be flagged (normal-for-your-community talk)

Known admins

The real team identities, so Guardian can flag impersonators

Thresholds

Advanced numeric overrides for the suspicious / scam cut-offs


Weekly Recap

Every Monday at 12:00 UTC, Guardian posts a short recap to your mod-review channel: how many messages it flagged that week, how many were high-confidence scams, what actions it took, and the top patterns it saw. (It stays quiet on weeks with nothing to report.)


Privacy Note

Guardian classifies messages in real time to reach a verdict. It only writes a record to its audit log when it actually flags or acts on a message (suspicious or scam) β€” that record includes the verdict, category, reason, action taken, and a short snippet of the offending message for the mod-review card. Ordinary clean messages are never stored by Guardian.


Last updated