> For the complete documentation index, see [llms.txt](https://docs.alphacloud.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alphacloud.pro/erste-schritte/bot-einladen.md).

# Bot einladen

Den AlphaCloud Bot auf deinen Server holen und ihm die richtigen Rechte geben.

## Voraussetzungen

Du brauchst auf dem Discord Server die Berechtigung **Server verwalten** (Manage Server). Ohne die zeigt dir Discord den Server beim Einladen gar nicht erst an, und auch das Webpanel lässt dich später nicht hinein.

## Schritt für Schritt

{% stepper %}
{% step %}

### Einladungslink öffnen

Öffne den [Einladungslink](https://discord.com/oauth2/authorize?client_id=1364273604300242944). Discord fragt dich, auf welchen Server der Bot soll.
{% endstep %}

{% step %}

### Server auswählen

Wähle deinen Server aus der Liste. Es erscheinen nur Server, auf denen du **Server verwalten** hast.
{% endstep %}

{% step %}

### Rechte bestätigen

Lass die vorgeschlagenen Rechte angehakt und bestätige. Warum der Bot Administrator empfohlen bekommt, steht weiter unten.
{% endstep %}

{% step %}

### Panel öffnen

Geh auf [panel.alphacloud.pro](https://panel.alphacloud.pro) und melde dich mit demselben Discord Konto an. Dein Server taucht jetzt in der Serverliste auf.
{% endstep %}

{% step %}

### Rolle nach oben ziehen

Zieh die Rolle des Bots in den Servereinstellungen unter **Rollen** möglichst weit nach oben. Das ist der häufigste Grund, warum später etwas nicht funktioniert.
{% endstep %}
{% endstepper %}

## Welche Rechte der Bot braucht

Discord erlaubt einem Bot nur das, was seine Rolle erlaubt. AlphaCloud deckt sehr unterschiedliche Aufgaben ab, deshalb ist **Administrator** die empfohlene Einstellung: damit funktioniert jedes Modul sofort und du musst nie raten, welches Recht gerade fehlt.

Wenn du lieber einzeln vergibst, sind das die Rechte, die Module tatsächlich brauchen:

| Recht                                  | Wofür                                                                                        |
| -------------------------------------- | -------------------------------------------------------------------------------------------- |
| Rollen verwalten                       | Autorolle, Reaktionsrollen, Verifizierung, Temporäre Rollen, Level Belohnungen, Team Updates |
| Kanäle verwalten                       | Tickets, Temp Voice, Server Stats, Supportsortierung                                         |
| Mitglieder kicken und bannen           | Moderation, AutoMod, Anti Nuke, Account Alter, Honeypot                                      |
| Mitglieder timeouten                   | Moderation, AutoMod                                                                          |
| Mitglieder verschieben                 | AFK Room, Support Call, Supportsortierung                                                    |
| Nachrichten verwalten                  | AutoMod, Sticky Message, Starboard, Anti Ghost Ping                                          |
| Nachrichten senden und Links einbetten | praktisch jedes Modul                                                                        |
| Nachrichtenverlauf lesen               | Tickets, Logging, Starboard, KI Chat                                                         |
| Nicknames verwalten                    | Rollen Namen, Team Updates                                                                   |
| Server verwalten                       | Logging, Server Backup, Anti Nuke                                                            |
| Ereignisprotokoll einsehen             | Logging, Anti Nuke                                                                           |
| Reaktionen hinzufügen                  | Reaktionsrollen, Starboard                                                                   |

{% hint style="warning" %}
**Die Rollenposition schlägt jedes Recht.** Ein Bot kann nur Rollen vergeben, die **unter** seiner eigenen höchsten Rolle stehen, und nur Mitglieder moderieren, deren höchste Rolle unter seiner steht. Selbst mit Administrator scheitert ein Rollen Grant, wenn die Zielrolle über der Bot Rolle liegt.
{% endhint %}

## Privilegierte Intents

Manche Module brauchen Informationen, die Discord nur gesondert herausgibt. Das ist beim offiziellen AlphaCloud Bot bereits eingerichtet, du musst nichts tun. Für dein Verständnis:

* **Server Members** wird für Beitritte, Austritte, Autorolle, Level System und Teamlisten gebraucht.
* **Message Content** wird für AutoMod, Auto Responder, KI Chat, Starboard und Minigames gebraucht.

## Es funktioniert nicht, was jetzt

{% hint style="info" %}
**Der Bot reagiert gar nicht.** Prüfe, ob er online ist und ob er im betroffenen Kanal überhaupt **Nachrichten senden** darf. Kanalrechte überschreiben Serverrechte.
{% endhint %}

{% hint style="info" %}
**Ein Slash Befehl taucht nicht auf.** Viele Befehle registriert der Bot erst, wenn das zugehörige Modul aktiv ist. Aktiviere das Modul im Panel und warte etwa eine Minute. Wenn Discord den Befehl dann noch nicht zeigt, hilft ein Neustart deines Discord Clients.
{% endhint %}

{% hint style="info" %}
**Der Server fehlt im Panel.** Melde dich einmal ab und wieder an. Das Panel liest deine Serverliste beim Login von Discord, ein frisch beigetretener Server ist erst nach dem nächsten Login dabei.
{% endhint %}

## Weiter

{% content-ref url="/pages/d6JWWmlXAyI1eJGf13bq" %}
[Das Webpanel](/erste-schritte/webpanel.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.alphacloud.pro/erste-schritte/bot-einladen.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.