Captain ist ein KI-Assistent, der Ihnen dabei hilft, schneller und präziser zu antworten. Mit **Bring Your Own Key (BYOK)** können Sie Ihren eigenen API-Schlüssel von OpenAI oder einem kompatiblen KI-Dienst verwenden. Sie steuern die Daten, Kosten und welches Modell verwendet wird. In einer selbstgehosteten Umgebung sendet Captain Daten nur an das KI-Modell, das Sie auswählen. 

Diese Anleitung zeigt Ihnen, wie Sie Captain in Ihrer **selbstgehosteten Enterprise Edition** aktivieren, Ihren API-Schlüssel hinzufügen und ein benutzerdefiniertes Modell einrichten können, falls gewünscht.

## Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

* **Chatwoot Enterprise Edition** mit einem kostenpflichtigen Tarif.

* Admin-Zugriff auf die **Super Admin Console**.

* Einen gültigen **OpenAI API-Schlüssel**.

* (Optional) Einen selbstgehosteten **OpenAI-kompatiblen API-Endpunkt**.

* (Optional) Einen [**Firecrawl API-Schlüssel**](https://www.firecrawl.dev/) für ein besseres Durchsuchen von Dokumentationen.

## Captain in der Super Admin Console aktivieren

Um Captain auf Installationsebene zu aktivieren:

Loggen Sie sich in die **Super Admin Console** ein. Navigieren Sie zu **Einstellungen → Captain**.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCTmNKL1FFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a3ab35644fcf7dc2bd5efc131fbe219e1305ca31/Screenshot%202025-08-15%20at%2011.51.50%E2%80%AFAM.png)

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQ3NLL1FFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--8a4b8f28eaaa80f8fae85881aa9345ea1e8cb8c4/Screenshot%202025-08-15%20at%2011.50.26%E2%80%AFAM.png)

Füllen Sie die Konfigurationsfelder aus:

1. **OpenAI API-Schlüssel** *(Erforderlich)* – Der Schlüssel zur Authentifizierung von Anfragen bei OpenAI oder einem kompatiblen Dienst.

2. **OpenAI Modell** *(Erforderlich)* – Standard ist `gpt-4o-mini`. Sie können auch ein anderes unterstütztes Modell wie `gpt-5` wählen.

3. **OpenAI API-Endpunkt** *(Optional)* – Geben Sie Ihren benutzerdefinierten API-Endpunkt ein, wenn Sie ein selbstgehostetes Modell verwenden.

4. **Firecrawl API-Schlüssel** *(Optional)* – Empfohlen für besseres Crawlen von Webseiten und Dokumentationen.

   Klicken Sie auf **Absenden**, um Ihre Konfiguration zu speichern.

## Captain für ein Konto aktivieren

Nachdem Sie Captain global aktiviert haben, aktivieren Sie es für einzelne Konten:

1. Gehen Sie in der **Super Admin Console** zu **Konten**.

2. Wählen Sie das Konto aus, für das Sie Captain aktivieren möchten, und klicken Sie auf **Bearbeiten**.

3. Im Bereich **Premium-Funktionen** aktivieren Sie den Schalter **Captain**.

4. Speichern Sie die Änderungen.

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQjRLL1FFPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--df5095b551827cac323bd59ce90b30b932a5b50a/Screenshot%202025-08-15%20at%2011.52.31%E2%80%AFAM.png)

## Fehlerbehebung

Falls Captain nicht wie erwartet reagiert:

* Überprüfen Sie, ob der **OpenAI API-Schlüssel** korrekt und aktiv ist.

* Stellen Sie sicher, dass der **Modellname** mit einem unterstützten Modell übereinstimmt.

* Überprüfen Sie, ob Ihr **Firecrawl API-Schlüssel** gültig ist, falls Sie das Crawlen nutzen.

* Vergewissern Sie sich, dass Captain sowohl auf Installations- als auch auf Kontoebene aktiviert ist.

Wenn Captain weiterhin nicht reagiert, überprüfen Sie die Chatwoot-Serverprotokolle sowohl für die Web- als auch für die Worker-Prozesse, um Fehler zu identifizieren, und teilen Sie diese Fehlermeldungen dem Support-Team für weitere Unterstützung mit.