Entdecken
Sie können Captain auf Ihrer eigenen Chatwoot-Installation mit Ihrem eigenen OpenAI-Schlüssel ausführen.
Plan & Zugriff: enthalten in den selbst gehosteten Premium- und Enterprise-Plänen. Siehe Enterprise Edition. Sie benötigen Zugriff auf die Super Admin-Konsole. Die Community Edition enthält Captain nicht.
Premium und Enterprise erhalten die gleichen Captain-Funktionen und -Einstellungen.
Einrichten & ausprobieren
Bevor Sie beginnen
-
Einen OpenAI API-Schlüssel.
-
Optional: ein OpenAI-kompatibler Endpoint, wenn Sie Ihr eigenes Modell hosten.
-
Optional: ein Firecrawl API-Schlüssel für besseres Crawlen von Websites. Ohne diesen verwendet Chatwoot einen einfacheren integrierten Crawler.
1. Captain für die Installation konfigurieren
-
Öffnen Sie die Super Admin-Konsole und gehen Sie zu Einstellungen.
-
Klicken Sie auf der Captain-Karte auf das Einstellungen- (Zahnrad-) Symbol.

-
Ausfüllen:
-
OpenAI API-Schlüssel.
-
OpenAI Modell stellt das Modell für Copilot- und Editor-Funktionen ein. Lassen Sie das Feld leer, um
gpt-4.1-minizu verwenden. Der Assistent verwendet standardmäßiggpt-5.2. Um dies zu ändern, gehen Sie zu Super Admin › Konten, bearbeiten Sie das Konto und öffnen Sie die Registerkarte Captain-Modelle. Wenn Sie einen eigenen Endpoint verwenden, stellen Sie sicher, dass er die hier ausgewählten Modelle bereitstellt.
-
OpenAI API Endpoint (optional), für ein kompatibles selbst gehostetes Modell.
-
Embedding Modell (optional).
-
FireCrawl API-Schlüssel (optional).

-
-
Auf Senden klicken.
2. Captain für ein Konto aktivieren
Konten, die erstellt werden, während Ihre Installation auf Premium oder Enterprise läuft, haben Captain bereits aktiviert. Für zuvor erstellte Konten:
-
Gehen Sie in der Super Admin-Konsole zu Konten.
-
Öffnen Sie das Konto und klicken Sie auf Bearbeiten.
-
Aktivieren Sie in den Premium-Funktionen Captain. Guardrails, Antwort-Richtlinien und Szenarien sind enthalten. Für benutzerdefinierte Tools aktivieren Sie auch Custom Tools (Benutzerdefinierte Tools für Captain einrichten).

-
Speichern.
Testen Sie es
Melden Sie sich bei diesem Konto an. Captain erscheint in der Seitenleiste. Erstellen Sie einen Assistenten und senden Sie eine Nachricht im Playground. Siehe Einen Captain-Assistenten einrichten und Ihre Posteingänge verbinden.
Wert schöpfen
-
OpenAI rechnet die Nutzung mit Ihrem eigenen Schlüssel ab. Chatwoot wertet Captain Credits auf selbst gehosteten Installationen nicht an.
-
Sie upgraden von einer älteren Version, bei der Assistenten das Anweisungsfeld verwendeten? Anweisungen werden nicht mehr verwendet. Übertragen Sie sie vor dem Upgrade in Guardrails und Antwort-Richtlinien (Captain's Guardrails, Richtlinien und Szenarien festlegen).
-
Alles andere funktioniert wie in der Cloud. Machen Sie weiter mit Dokumente zum Captain-Wissen hinzufügen.
Fehlerbehebung
| Symptom | Wahrscheinliche Ursache | Was tun |
|---|---|---|
| Kein Captain in der Seitenleiste | Nicht für das Konto aktiviert oder keine Premium- oder Enterprise-Lizenz | Beide Schritte prüfen; Lizenz prüfen |
| Keine Tools | Custom Tools ist für das Konto deaktiviert | In Super Admin > Konten einschalten |
| Assistent antwortet nicht | Ungültiger oder inaktiver OpenAI-Schlüssel oder ein nicht unterstütztes Modell | Schlüssel prüfen. Prüfen, ob Ihr Endpoint das Modell des Assistenten bereitstellt (gpt-5.2 standardmäßig oder das im Tab Captain-Modelle eingestellte). |
| Webseiten-Dokumente fehlen Seiten | Kein Firecrawl-Schlüssel, daher wird der einfache Crawler verwendet | FireCrawl API-Schlüssel hinzufügen |
| Webseiten-Dokumente werden nicht synchronisiert | Ungültiger Firecrawl API-Schlüssel | Überprüfen Sie, ob der Firecrawl API-Schlüssel gültig ist. Wenn ein Schlüssel gesetzt ist, verwendet Chatwoot immer Firecrawl, ein ungültiger Schlüssel führt daher zu Fehlern. Entfernen Sie den Schlüssel, um den integrierten Crawler zu verwenden. |
| Immer noch Fehler | Ein Fehler auf dem Server | Web- und Worker-Logs prüfen |