Skip to main content
Documentation

Module · FREE

AI Moderator + Chat

Astero embeds three AI capabilities : automatic message moderation with cross-server reputation, an AI chatbot channel, and image moderation. AI usage is metered per Discord server and capped per plan.

AI Moderator with cross-server reputation

Unique to Astero : a user's reputation is shared across all your Discord servers. A troll banned on your main server arrives on your VIP server already flagged as low-reputation — AI Moderator catches their first borderline message instead of waiting for a pattern.

Tracked per (botId, guildId, userId) with cross-guild lookup scoped to the bot's owner. No leak between owners — pinned by the tests/ai-moderator-cross-guild.test.js sentinel.

Reputation factors

  • + Constructive messages, helpful replies, accepted suggestions
  • + Time on server, level, ticket resolution participation
  • − Past warnings, kicks, infractions (from any of your servers)
  • − AutoMod hits, deleted messages, mute history

AI Chatbot channel

Designate a single channel as an AI chat zone. Astero replies to messages there with a configurable personality, keeping the last 20 messages of per-channel context (not per-user). Useful for FAQ, social engagement and community vibe.

Configure via /aichat setup (channel + personality), /aichat prompt (custom system prompt) and /aichat mention (toggle response on @mention). One-shot questions outside the AI channel : run /ask.

Image moderation

Image attachments go through a 3-tier pipeline (perceptual-hash known-scam DB → OCR + keyword match → Astero AI semantic classification) and are tagged safe / scam / nsfw. Detected content can be auto-deleted. Implementation in apps/bot-engine/src/services/imageModeration.js.

AI Token quotas

Every AI action (moderation classification, chat reply, image scan) consumes tokens. The per-month quota is displayed live in the dashboard at /dashboard/[guildId]/ai.

PlanAI tokens / mo+ Annual bonus
Free10 000—
Stream Hub100 000120 000
Creator Edition500 000600 000
Multi-Creator Network2 000 0002 400 000
Studio Edition10 000 00012 000 000

Soft cap escalation

  • ● 80 % — email + dashboard banner warning
  • ● 90 % — inline modal proposes upgrade
  • ● 100 % — AI endpoints return 403 AI_QUOTA_EXCEEDED until reset (1st of next month)

Slash commands

/ask—Ask the AI assistant a question (one-shot, no conversation memory).
/aichat setup—Set the AI chatbot channel + personality.
/aichat prompt—Set a custom system prompt for the AI.
/aichat mention—Toggle whether the AI responds when @mentioned.
/aichat reset—Clear conversation history in this channel.
/aichat status—Show the current AI chat configuration.
/aichat disable—Disable the AI chatbot.

Want to plug Claude or another LLM into your bot ? See the MCP Server guide.

Beta