alxxAI FAQ

Troubleshooting & FAQ

Having issues with alxxAI? This guide covers common problems, solutions, and frequently asked questions.

Bot Not Responding When Mentioned

Common Causes

Problem: You @ mention the bot, but it does not reply.

1. Bot is Offline

Check: Look at the bot status in the member list.

Solution: If offline, wait a few minutes. If it stays offline for more than 10 minutes, contact support at contact@alxx.dev or our support Discord server.

2. Insufficient Tokens

Check: Look for an "Insufficient tokens" error message.

Solution: Server owner needs to purchase more tokens at alxx.dev/alxxai/dashboard.

3. Bot Does Not Have Permissions in Channel

Check: Channel settings → Permissions → alxxAI role.

Solution: Ensure the bot has:

View Channel
Send Messages
Embed Links
Read Message History

4. You Did Not Actually @ Mention

Check: Make sure you used @ mention, not just the bot name.

Correct: @alxxAI what are the server rules?

Incorrect: alxxAI what are the server rules?

5. Role Mention Instead of Bot Mention

Check: If you mentioned the bot role instead of the bot itself.

Solution: Mention @alxxAI the bot, not the role.

6. Query Failed Silently

Check: Bot logs if you have access.

Solution: Contact support at contact@alxx.dev or our support Discord server and share:

Server ID
Channel ID
Timestamp of when you tried
What you asked

Slash Commands Not Showing Up

Solutions

Problem: When you type /, alxxAI commands do not appear.

1. Wait for Discord Sync (New Installation)

Commands may take 5 to 15 minutes to appear after adding the bot.

Solution: Wait 15 minutes, then restart Discord (Ctrl+R or Cmd+R).

2. Restart Discord Client

Solution: Reload Discord with Ctrl+R (Windows or Linux) or Cmd+R (Mac).

3. Check Permissions

Bot needs the "Use Application Commands" permission.

Solution: Server Settings → Roles → alxxAI → Enable "Use Application Commands".

4. Check Your Permissions

You need the required permission for the command.

Memory System Not Working

Diagnostics

Problem: The bot does not seem to remember past conversations.

1. Check if Channel is Enabled for Memory

/memorychannel list

If the channel is not listed, add it:

/memorychannel add channel:#your-channel

2. Check Backfill Status

/memorychannel status

Possible states:

Pending Backfill has not started yet
Running Backfill in progress (large channels can take 10 to 15 minutes)
Failed Backfill encountered an error
Completed Backfill finished successfully

If failed, remove and re-add the channel:

/memorychannel remove channel:#your-channel
/memorychannel add channel:#your-channel

3. Messages Are Recent

Backfill may not have processed new messages yet.

Solution: Wait 1 to 2 minutes, then try again.

4. Query Is Not Semantically Similar

Vector search finds semantically similar content, not exact keywords.

Solution: Rephrase your question.

Less effective: what did john say

More effective: what did john say about the project deadline

5. Create a Digest Entry

If critical info is missing, create a digest entry:

/digest add
  title: "Important Info"
  body: "[content you want remembered]"
  priority: high
  always_include: true

Permission Error When Running Command

Permissions Checklist

Problem: Command fails with a "Permission Error" message.

1. Check Your Discord Permissions

Server Settings → Roles → Your Role.

Command permission requirements:

/ban, /unban Ban Members
/kick Kick Members
/mute, /unmute, /warn Moderate Members
/clear Manage Messages
/warning clear, /memorychannel *, /digest *, /logchannel * Administrator

2. Check Bot Discord Permissions

Server Settings → Roles → alxxAI.

Bot permission requirements:

Same as user requirements above
Plus Send Messages and Embed Links in the channel

3. Check Channel Overrides

Channel-specific overrides may deny access.

Solution: Channel Settings → Permissions → Check alxxAI role.

Hierarchy Error When Moderating

Role Order

Problem: Cannot ban, kick, or mute a user. You get a "Hierarchy Error".

Cause: The target has the same or higher role than you or the bot.

1. Lower Target Role (if appropriate)

If they should not have that role, remove it first.

2. Raise Bot Role

Server Settings → Roles → drag alxxAI above the target role.

Recommended placement:

1. Owner (automatic)
2. Admin
3. Head Moderator
4. Moderator
5. alxxAI
6. VIP
7. Member
8. @everyone

3. Ask Higher Ranked Moderator

If the target should have that role, ask someone higher to act.

Backfill Stuck on Running

Possible Causes

Problem: /memorychannel status shows backfill running for 30+ minutes.

1. Very Large Channel

Channels with 50,000+ messages can take a long time.

Solution: Wait up to 60 minutes for very large channels.

2. Bot Restarted During Backfill

Backfill job may be stuck in limbo.

Solution: Remove and re-add the channel to restart backfill.

3. Forum Channel with Many Threads

Forums iterate through all threads, which takes longer.

Solution: Be patient, or remove and re-add if stuck for more than 30 minutes.

AI Giving Incorrect or Irrelevant Answers

Causes and Fixes

Problem: Responses are wrong, outdated, or do not make sense.

1. Using Outdated Memory

Old messages may rank higher than recent updates.

Solution: Create a digest entry with current info and set priority: canonical.

Delete outdated messages to purge them from memory
Edit messages to update them

2. Not Enough Context

AI only sees recent messages and search results.

Solution: Provide more context or enable more memory channels.

3. Model Tier Too Low

Lite model is less accurate than standard or advanced.

Solution: Server owner can change model tier in the dashboard.

4. AI Hallucinating

AI may invent details not in memory.

Ask follow-up: "Where did you get that information?"
Report hallucinations in support server so we can improve prompts
Create digest entries with accurate info

5. Query Not Relevant to Memory

If question is outside your server discussions, the AI has no context.

Solution: Ask general questions differently, or create digest entries with background context.

Frequently Asked Questions

General Questions

How much does alxxAI cost?

Current Pricing (MVP):

Usage-based tokens, 4.99 USD for 1,000 tokens, 9.99 for 2,000 tokens and 19.99 for 5,000 tokens
Different model tiers: lite (cheap), standard (balanced), advanced (highest quality)
No monthly subscription fees

Pricing details: alxx.dev/alxxai/dashboard

Future: We may introduce tiered subscriptions with token bundles.

How do I delete my data?

Delete specific channel data:

/memorychannel remove channel:#channel-name

This permanently deletes all messages from that channel.

Delete all server data:

Remove the bot from your server
Email contact@alxx.dev with your server ID
All data will be deleted within 30 days

See: Privacy Policy

Can alxxAI work in DMs (Direct Messages)?

Current: No, alxxAI only works in servers.

Reason:

Memory system is designed for server-wide context
Token costs are tied to server owner accounts
Moderation features do not apply to DMs

Future: We may support DMs.

How many servers can I add alxxAI to?

Unlimited. You can add the bot to as many servers as you want.

Does alxxAI support other languages besides English?

Current: alxxAI works best in English. Other languages are supported but may have lower accuracy.

Future: We plan to improve multi-language support based on demand.

Memory & AI

Memory Deep Dive

How far back can alxxAI remember?

Short answer: As far back as Discord allows backfill plus all future messages.

Details:

Backfill retrieves up to about 10,000 to 50,000 historical messages depending on channel age
Discord API limits prevent retrieving very old messages efficiently
After backfill, all new messages are stored indefinitely until you remove the channel

Recommendation: Enable memory channels early to build a knowledge base.

Can I control what the AI remembers?

Yes, several ways:

Memory Channels, only enable specific channels
Digest Entries, manually curate important info
Priority Levels, set priority: canonical for authoritative info
Always Include, use always_include: true for critical context
Delete Memory, use /memorychannel remove to purge channel data

See: Memory System Guide

Does alxxAI train on my data?

No. Your messages are:

Stored for search and context in your server's isolated database
Not used to train AI models
Not shared with other servers
Not sold to third parties

See: Privacy Policy

How do I restrict who can use AI replies?

Use /aiconfig. Moderators or admins can set a required role for mention-triggered AI replies.

/aiconfig set_role to require a role
/aiconfig view to check the current gate
/aiconfig remove_role to allow everyone

Blocked users see an AI Access Denied embed that auto-deletes after about 5 seconds.

Moderation

Moderation Questions

Can alxxAI automatically moderate my server?

Current: No, all moderation is manual via commands.

Future: Phase 2 of our roadmap includes auto moderation features.

See: Vision and Roadmap

Can I see who banned, kicked, or muted someone?

Yes, via mod logs.

Set up a mod log channel:

/logchannel set type:moderation channel:#mod-logs

All actions are logged with moderator name, target, reason, and timestamp.

Also: Discord Audit Log (Server Settings → Audit Log).

Technical

Technical Questions

What happens if the bot goes down?

Data: All data is safely stored in databases
Downtime: Bot will be back online as soon as possible
Tokens: No tokens are deducted during downtime
Memory: Ingestion pauses during downtime and resumes automatically

How do I report a bug?

Methods:

Support Server: Post in our Discord support server
Email: contact@alxx.dev for sensitive issues

Include:

Description of the bug
Steps to reproduce
Expected behavior vs actual behavior
Server ID if applicable
Screenshots or error messages