Aktivieren Sie Captain auf selbstgehosteten Systemen

Sojan

Sojan

Zuletzt aktualisiert am Oct 20, 2026

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

  1. Öffnen Sie die Super Admin-Konsole und gehen Sie zu Einstellungen.

  2. Klicken Sie auf der Captain-Karte auf das Einstellungen- (Zahnrad-) Symbol.

  3. 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-mini zu verwenden. Der Assistent verwendet standardmäßig gpt-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).

  4. 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:

  1. Gehen Sie in der Super Admin-Konsole zu Konten.

  2. Öffnen Sie das Konto und klicken Sie auf Bearbeiten.

  3. 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).

  4. 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