Aktiviere Captain auf selbstgehosteten Systemen

Sojan

Sojan

Zuletzt aktualisiert am Oct 21, 2026

Entdecken

Sie können Captain auf Ihrer eigenen Chatwoot-Installation mit Ihrem eigenen OpenAI-Schlüssel ausführen.

Plan & Zugang: In den Premium- und Enterprise-Self-Hosted-Plänen enthalten. 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 starten

  • Einen OpenAI API-Schlüssel.

  • Optional: Eine OpenAI-kompatible Endpoint, wenn Sie Ihr eigenes Modell hosten.

  • Optional: Einen Firecrawl API-Schlüssel für besseres Website-Crawling. Ohne diesen wird der eingebaute, einfachere Crawler von Chatwoot verwendet.

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 Einstellungs-(Zahnrad-)Symbol.

  3. Füllen Sie aus:

    • OpenAI API-Schlüssel.

    • OpenAI Modell legt das Modell für Copilot- und Editor-Funktionen fest. Lassen Sie das Feld leer, um gpt-4.1-mini zu verwenden. Der Assistent verwendet standardmäßig gpt-5.2. Um das zu ändern, gehen Sie zu Super Admin › Accounts, bearbeiten Sie das Konto und öffnen Sie den Tab Captain-Modelle. Wenn Sie ein benutzerdefiniertes Endpoint verwenden, stellen Sie sicher, dass es die hier gewählten Modelle bereitstellt.

    • OpenAI API Endpoint (optional), für ein kompatibles selbst gehostetes Modell.

    • Embedding-Modell (optional).

    • FireCrawl API-Schlüssel (optional).

  4. Klicken Sie auf Absenden.

2. Captain für ein Konto aktivieren

Konten, die erstellt wurden, während Ihre Installation auf Premium oder Enterprise läuft, haben Captain bereits aktiviert. Für Konten, die davor erstellt wurden:

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

  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 Benutzerdefinierte Werkzeuge (Benutzerdefinierte Tools für Captain einrichten).

  4. Speichern.

Testen

Melden Sie sich mit diesem Konto an. Captain erscheint in der Seitenleiste. Erstellen Sie einen Assistenten und senden Sie eine Nachricht im Playground. Siehe Richten Sie einen Captain-Assistenten ein und verbinden Sie Ihre Postfächer.

Nutzen

  • OpenAI berechnet Ihnen die Nutzung Ihres eigenen Schlüssels. Chatwoot berücksichtigt keine Captain-Credits bei Self-Hosted-Installationen.

  • Sie aktualisieren von einer älteren Version, bei der Assistenten das Feld „Instructions“ benutzt haben? Anweisungen werden nicht mehr verwendet. Verschieben Sie diese vor dem Upgrade in Guardrails und Antwort-Richtlinien (Guardrails, Richtlinien und Szenarien für Captain festlegen).

  • Alles andere funktioniert wie in der Cloud. Fahren Sie fort mit Dokumente zum Captain-Wissen hinzufügen.

Fehlerbehebung

Symptom Wahrscheinliche Ursache Was ist zu tun
Kein Captain in der Seitenleiste Nicht für das Konto aktiviert, oder keine Premium-/Enterprise-Lizenz Beide Schritte prüfen; Lizenz prüfen
Keine Tools Benutzerdefinierte Werkzeuge sind für das Konto deaktiviert In Super Admin > Accounts aktivieren
Assistent antwortet nicht Ungültiger oder inaktiver OpenAI-Schlüssel oder ein nicht unterstützter Modellname Schlüssel prüfen. Prüfen, ob Ihr Endpoint das Assistentenmodell bereitstellt (gpt-5.2 standardmäßig oder das im Tab Captain-Modelle des Kontos gewählte).
Webseiten-Dokumente fehlen Seiten Kein Firecrawl-Schlüssel, daher wird der einfache Crawler verwendet FireCrawl API-Schlüssel hinzufügen
Webseiten-Dokumente können nicht synchronisiert werden Ungültiger Firecrawl API-Schlüssel Prüfen, ob der Firecrawl API-Schlüssel gültig ist. Falls ein Schlüssel gesetzt ist, verwendet Chatwoot immer Firecrawl; ein ungültiger Schlüssel führt zum Fehler. Schlüssel entfernen, um den eingebauten Crawler zu nutzen.
Immer noch Fehler Ein Fehler auf dem Server Web- und Worker-Logs prüfen