KI-Companion – Einrichtung

Diese Seite führt dich durch das Aktivieren des KI-Companions für deinen Server. Was der Companion ist und wie er sich verhält, liest du am besten zuerst im KI-Companion – Konzept.

Es gibt drei Schritte:

1. Einen API-Schlüssel bei einem KI-Anbieter erstellen (du bringst deinen eigenen mit).
2. Diesen Schlüssel in dzbot unter Einstellungen eintragen.
3. Den richtigen Personen das Zugriffsrecht geben.

Schritt 1 – API-Schlüssel beim Anbieter holen

Der Companion arbeitet nach dem Prinzip Bring deinen eigenen Schlüssel mit: Du wählst einen Anbieter, erstellst dort ein Konto, richtest die Zahlung ein und generierst einen API-Schlüssel. Der Anbieter rechnet die Nutzung direkt über dein Konto ab – dzbot berechnet dir die KI selbst nie.

Du brauchst nur einen Anbieter. Nimm den, bei dem du schon ein Konto hast, oder den du bevorzugst. dzbot unterstützt drei:

Anbieter	Modell, das dzbot nutzt
OpenAI	GPT-5 mini
Anthropic	Claude Haiku 4.5
Google	Gemini 2.5 Flash

Das sind schnelle, günstige Modelle, die für die Arbeit des Companions mehr als ausreichen. Das Modell wählst du nicht selbst – dzbot nutzt automatisch das passende für den von dir gewählten Anbieter.

Kosten

Die Aufgaben des Companions sind klein (ein paar Abfragen, dann etwas Text entwerfen), und es sind günstige Modelle, daher sind die laufenden Kosten in der Regel sehr niedrig. Die Ausgaben steuerst du vollständig über dein Anbieterkonto – lege dort bei Bedarf ein Budget oder Ausgabenlimit fest.

OpenAI

1. Erstelle ein Konto auf platform.openai.com.
2. Öffne die Billing-Einstellungen, hinterlege eine Zahlungsart und lade Guthaben auf (OpenAI arbeitet mit Prepaid-Guthaben – starte mit einem kleinen Betrag).
3. Gehe zum Bereich API keys und erstelle einen neuen Secret Key.
4. Kopiere den Schlüssel sofort – er wird nur einmal angezeigt. Er beginnt mit sk-.

Anthropic

1. Erstelle ein Konto auf console.anthropic.com.
2. Öffne Billing (Plans & Billing) und kaufe Guthaben (auch Anthropic arbeitet mit Prepaid-Guthaben – ein kleiner Betrag genügt zum Start).
3. Gehe zu API keys und erstelle einen neuen Schlüssel.
4. Kopiere den Schlüssel sofort – er wird nur einmal angezeigt. Er beginnt mit sk-ant-.

Google (Gemini)

1. Melde dich mit einem Google-Konto bei Google AI Studio (aistudio.google.com) an.
2. Erstelle über Get API key einen Schlüssel. Der Schlüssel wird in einem Google-Cloud-Projekt angelegt (AI Studio richtet bei Bedarf eines für dich ein).
3. Für mehr als leichtes Ausprobieren aktiviere die Abrechnung für dieses Google-Cloud-Projekt, damit du im kostenpflichtigen Tarif mit vernünftigen Limits bist. Google bietet eine kostenlose Stufe, sie hat aber enge Limits und eignet sich eher zum Testen.
4. Kopiere den erzeugten Schlüssel.

Halte deinen Schlüssel geheim

Ein API-Schlüssel ist ein Geheimnis, das an deine Abrechnung gebunden ist. Teile ihn nicht, poste ihn nicht in Discord und checke ihn nirgends ein. Ist ein Schlüssel durchgesickert, widerrufe ihn im Dashboard des Anbieters und erstelle einen neuen.

Schritt 2 – Schlüssel in dzbot eintragen

Navigationspfad:

• Server Admin → Einstellungen → Integrationen

Suche das Anmeldedaten-Feld KI-Companion und:

1. Wähle deinen Anbieter aus der Liste (OpenAI, Anthropic oder Google).
2. Füge deinen API-Schlüssel in das Schlüsselfeld ein.
3. Klicke auf Speichern.

Nach dem Speichern wird der Schlüssel maskiert – du siehst nur noch wenige Zeichen am Anfang und Ende (zum Beispiel sk-••••abcd), nie wieder den vollständigen Wert. Um ihn später zu ändern, nutze Schlüssel ersetzen, füge einen neuen ein und speichere. Der Anbieterwechsel erfordert kein erneutes Einfügen des Schlüssels, es sei denn, du möchtest ihn wirklich ersetzen.

Das Eintragen des Schlüssels erfordert das Zugriffsrecht admin.settings.edit.

Schritt 3 – Zugriffsrecht aktivieren

Der Companion erscheint nur bei Benutzern mit dem Zugriffsrecht KI-Companion (es liegt in der Tickets-Gruppe der Admin-Rechte, als tickets.ai_companion). Gib es den Gruppen, deren Mitglieder den Companion nutzen sollen:

• Server Admin → Gruppen → Gruppe auswählen → KI-Companion aktivieren.

Wer in einer Gruppe mit diesem Recht ist, sieht den KI-Companion-Button im Admin-Header (das Funkel-Symbol oben rechts), sobald ein Schlüssel hinterlegt ist. Benutzer ohne das Recht sehen ihn nie.

Wie Zugriffsrechte und Gruppen allgemein funktionieren, steht in Zugriffssteuerung.

Funktioniert es?

Sobald ein Schlüssel gespeichert ist und du das Zugriffsrecht hast:

1. Lade das Admin-Panel neu.
2. Suche den KI-Companion-Button (Funkel-Symbol) oben rechts im Header.
3. Öffne ihn, starte eine Neue Sitzung und frage etwas Einfaches wie „suche Spieler <Name>".

Bekommst du eine sinnvolle Antwort, ist alles bereit. Weiter geht es mit KI-Companion – Nutzung.

Fehlerbehebung

Schlägt eine Sitzung fehl, zeigt der Chat eine kurze Meldung mit dem Grund:

Meldung	Bedeutung	Was tun
Nicht konfiguriert	Für diesen Server ist kein Anbieter/Schlüssel hinterlegt	Schlüssel eintragen (Schritt 2)
API-Schlüssel abgelehnt	Der gespeicherte Schlüssel ist ungültig oder widerrufen	Ein Admin sollte ihn in den Einstellungen ersetzen
Nutzungs- oder Abrechnungslimit	Der Anbieter meldet ein Kontingent- oder Abrechnungslimit	Guthaben aufladen oder Limit im Anbieter-Dashboard erhöhen
Anbieter nicht erreichbar	Eine vorübergehende Störung beim Anbieter	Kurz warten und erneut versuchen
Maximale Schrittzahl erreicht	Die Aufgabe lief lange, ohne fertig zu werden	Neue Sitzung starten und die Aufgabe in kleinere Anfragen aufteilen

Verwandte Dokumentation

• KI-Companion – Konzept
• KI-Companion – Nutzung
• Einstellungen
• Zugriffssteuerung