Moderation Rules
Configure rule templates, AI enforcement, whitelist exemptions, and spam learning
NebulaClaw's moderation system is built around natural-language rules. Instead of maintaining keyword lists, you describe the behavior to catch, the behavior to ignore, and the action NebulaClaw should take.
Rules apply across connected Telegram groups and Discord servers for the same Agent.
Open Moderation
Open Moderation from the console sidebar. The page has four tabs:
- Rules: create, import, edit, enable, disable, and delete moderation rules.
- Learning: add missed spam samples so similar variants can be fast-blocked.
- Audit: review automatic enforcement history.
- Whitelist: exempt trusted users from automatic moderation.
Add Rules from Templates
Click Add Rule to open the template picker.
NebulaClaw ships with templates for common Web3 and cross-border community risks:
| Template | Typical Action |
|---|---|
| Ad / Spam links | Mute |
| Scam / Phishing | Ban |
| Admin impersonation | Ban |
| Abusive language / Personal attacks | Mute |
| NSFW / Explicit content | Mute |
| Repetitive flooding / Spam | Mute |
| DM solicitation / Contact fishing | Mute |
| Forwarded channel ads / cross-promotion | Mute |
| Shilling / Copy-trading shouts | Mute |
| Gain-screenshot promo / external channel funneling | Mute |
Each template includes both:
- Flag criteria: what should be treated as a violation.
- Ignore criteria: normal conversation that should not be punished.
Use templates first, then edit them for your community's tone and tolerance. The ignore criteria are important because they reduce false positives.
One-Click Anti-Shilling Defaults
In the template picker, click Apply anti-shilling defaults to import the default anti-promotion bundle in one step.
This adds every preset marked default and skips rules already present on the Agent. The bundle is designed for the highest-frequency promotion patterns:
- Ad / spam links
- Scam / phishing
- Forwarded channel ads / cross-promotion
- Shilling / copy-trading shouts
- Gain-screenshot promo / external channel funneling
Use this when you want a fast baseline before fine-tuning individual rules.
Create a Custom Rule
In the same picker, click Create custom rule from scratch.
Configure:
- Description: write the behavior to catch, plus what to ignore.
- Action: choose mute, kick, or ban.
- Mute duration: for mute rules, set hours and minutes, or choose permanent.
- Enabled: turn the rule on immediately or save it disabled.
Write a precise description
Describe the violation and the safe exceptions.
Example: "Flag users posting unsolicited Telegram invite links, referral links, casino promotions, or copy-trading offers. Ignore official community links, docs links used to answer questions, and normal price discussion without promotion intent."
Add admin exemption text
Click Add exemption text when the rule could accidentally affect moderators, project team accounts, or Telegram anonymous-admin posts.
Choose the enforcement action
Use a short mute for uncertain behavior, kick for high-hostility behavior, and ban for confirmed scams, phishing, or private-key requests.
Save
Click Add Rule. Enabled rules take effect immediately.
Actions
| Action | Effect | Best For |
|---|---|---|
| Mute | Prevents the user from sending messages for the configured duration | Spam, flooding, NSFW, aggressive behavior, unclear but disruptive cases |
| Kick | Removes the user from the group or server; they may rejoin if allowed | Severe disruption where a reset is acceptable |
| Ban | Permanently removes the user until manually unbanned | Phishing, scams, private-key requests, impersonation |
Manage Existing Rules
On the Rules tab you can:
- Toggle a rule ON / OFF without deleting it.
- Edit the description, action, duration, and enabled state.
- Delete rules that are no longer relevant.
Review Audit Log after rollout and adjust rule descriptions using real examples.
Whitelist Trusted Users
Use Moderation โ Whitelist when a specific member should be permanently exempt from automatic moderation.
Whitelist entries can match by:
- Platform: all platforms, Telegram only, or Discord only.
- User ID: safest option when you know the numeric platform ID.
- Username: useful when the ID is not easy to find.
- Note: internal reason, such as "project admin", "market maker", or "support operator".
The whitelist bypasses automatic moderation. Only add trusted accounts, and prefer user ID matching for admins or team members.
Adaptive Spam Samples
Use Moderation โ Learning when a spam message slipped through.
Paste the missed message into Add missed spam sample, then mark whether it had:
- Media: image or video attached.
- Buttons: inline buttons or jump buttons.
NebulaClaw stores the sample and uses its signals to fast-block similar spam variants later. If a sample causes false positives, archive it from the sample list.
Recommended Workflow
- Apply the anti-shilling defaults.
- Add any extra templates your community needs.
- Add whitelist entries for admins, project accounts, and trusted operators.
- Add custom rules for community-specific policies.
- Watch the audit log for the first week.
- Add missed spam to Learning and archive noisy samples.