Skip to content
alxx.dev logoalxxAI Getting Started

Getting Started with alxxAI

Get your Discord server up and running with alxxAI in just a few minutes. This guide will walk you through installation, setup, and your first AI interaction.

Prerequisites

Palm

Owner Checklist

1. Server Owner Access

Make sure you are the server owner because alxxAI is managed through your alxx.dev account.

2. Account on alxx.dev

Create a free account at alxx.dev/alxxai/auth. You will use this to manage tokens and link your Discord server.

Step 1: Add alxxAI to Your Server

Discord

Installation

  1. Visit the Installation Page - Go to alxx.dev/alxxai or use the "Add to Discord" button on our website.
  2. Select Your Server - Discord will ask you to choose which server to add the bot to.
  3. Grant Permissions - Review the requested permissions in Permissions, then click "Authorize".
  4. Verify the Bot is Online - Check your server member list. You should see alxxAI with a green "Online" status.

Step 2: Configure Memory Channels

Memory Channels

Memory Setup

Memory channels are where alxxAI learns from your server's conversations. Messages in these channels will be stored and used to answer questions.

  1. Add a Memory Channel/memorychannel add channel:#general

    Replace #general with the channel you want to enable.

  2. Verify Configuration/memorychannel list

    Shows all channels configured for memory ingestion.

  3. Understanding Backfill
    • alxxAI automatically ingests past messages (up to Discord limits).
    • Backfill can take a few minutes depending on channel size.
    • Check progress with /memorychannel status.

Which Channels Should You Enable?

Good Candidates:

  • General discussion channels
  • Support channels
  • FAQ channels
  • Project discussion channels

Avoid:

  • Private or sensitive channels
  • Channels with personal information
  • Off-topic or spam channels
  • Channels with lots of bot commands

Privacy note: Only enable memory ingestion for channels where you are comfortable with message content being stored and processed by AI. See our Privacy Policy.

Step 3: Set Up Log Channels

Log Channels

Logging

Log channels receive notifications about moderation actions and bot activity.

/logchannel set type:moderation channel:#mod-logs
/logchannel set type:message channel:#message-logs
  • Moderation logs: Ban, kick, mute, warn actions
  • Message logs: Deleted and edited message notifications

Step 4: Your First AI Interaction

AI Interaction

Talk to the Agent

  1. Mention the Bot@alxxAI what is this server about?
  2. Wait for Response
    • The bot will process your question.
    • It searches memory for relevant context.
    • You get a response within a few seconds.
  3. Ask Follow-Up Questions
    • The bot remembers recent context.
    • You can have natural back-and-forth conversations.
    • Ask about topics discussed in memory channels.

Step 5: Add Important Information

Digest Entries

Digest Entries

Digest entries are curated pieces of knowledge that the AI should always remember. Think of them as your server's permanent memory.

When to Create Digest Entries

  • Server rules and guidelines
  • Frequently asked questions
  • Important links and resources
  • Project information and goals
  • Community culture and norms

How to Create a Digest Entry

/digest add
  title: Server Rules
  content: 1. Be respectful to all members
        2. No spam or self-promotion
        3. Stay on topic in channels
        4. Use content warnings for sensitive topics
  priority: high
  always_include: true

Parameters

  • title: Short, descriptive name
  • content: The information you want the AI to remember
  • priority: high, medium, or low
  • always_include: true to include in every response
  • scope_channels: Optional channel scope

Managing Digest Entries

  • List all entries: /digest list
  • Update an entry: /digest update
  • Remove an entry: /digest remove

Next Steps

Next Steps

You Are All Set

Here is what you can do next:

Set Up Moderation

  • Learn about moderation commands in Commands.
  • Commands: /ban, /kick, /mute, /warn, /clear
  • Full statistics with /modstats

Optimize Memory System

  • Read the Memory System Guide.
  • Add more memory channels for better context
  • Create strategic digest entries for critical information

Control AI Access

  • Require a role for AI replies with /aiconfig set_role
  • Check the current gate with /aiconfig view
  • Remove restrictions with /aiconfig remove_role

Manage Tokens

  • Visit your dashboard to view token usage.
  • Purchase additional tokens if needed

You Are All Set to Get Started

Your alxxAI interactions await you. Add the bot and start asking questions right away.

Add to Discord↗Contact Support↗