Activer Captain en auto-hébergement

Sojan

Sojan

Dernière mise à jour le Oct 20, 2026

Découvrir

Vous pouvez exécuter Captain sur votre propre installation de Chatwoot avec votre propre clé OpenAI.

Plan & accès : inclus dans les forfaits Premium et Entreprise en auto-hébergement. Voir Enterprise Edition. Vous devez avoir accès à la console Super Admin. L'édition Communautaire n'inclut pas Captain.

Premium et Entreprise bénéficient des mêmes fonctionnalités et réglages pour Captain.

Configuration & essai

Avant de commencer

  • Une clé API OpenAI.

  • Optionnel : un point de terminaison compatible OpenAI si vous hébergez votre propre modèle.

  • Optionnel : une clé API Firecrawl pour un meilleur crawl des sites web. Sans cela, Chatwoot utilise un crawler intégré plus simple.

1. Configurer Captain pour l'installation

  1. Ouvrez la console Super Admin et allez dans Paramètres.

  2. Sur la carte Captain, cliquez sur l’icône des paramètres (roue dentée).

  3. Remplissez :

    • Clé API OpenAI.

    • OpenAI Model définit le modèle pour les fonctionnalités Copilot et éditeur. Laissez vide pour utiliser gpt-4.1-mini. L’assistant utilise gpt-5.2 par défaut. Pour le changer, allez dans Super Admin › Comptes, éditez le compte et ouvrez l’onglet Captain models. Si vous utilisez un point de terminaison personnalisé, assurez-vous qu’il fournit les modèles que vous choisissez ici.

    • Point de terminaison API OpenAI (optionnel), pour un modèle auto-hébergé compatible.

    • Modèle d'embedding (optionnel).

    • Clé API FireCrawl (optionnel).

  4. Cliquez sur Soumettre.

2. Activer Captain pour un compte

Les comptes créés lorsque votre installation est en Premium ou Entreprise ont déjà Captain activé. Pour les comptes créés avant cela :

  1. Dans la console Super Admin, allez dans Comptes.

  2. Ouvrez le compte et cliquez sur Modifier.

  3. Dans les fonctionnalités premium, activez Captain. Les garde-fous, consignes de réponse et scénarios sont inclus. Pour des outils personnalisés, activez aussi Outils Personnalisés (Configurer des outils personnalisés pour Captain).

  4. Sauvegardez.

Testez

Connectez-vous à ce compte. Captain apparaît dans la barre latérale. Créez un assistant et envoyez un message dans le Playground. Voir Configurer un assistant Captain et connecter vos boîtes de réception.

En tirer profit

Dépannage

Symptôme Cause probable Que faire
Pas de Captain dans la barre latérale Non activé pour le compte, ou licence Premium ou Entreprise absente Vérifiez les deux étapes ; vérifiez votre licence
Aucun outil Outils personnalisés désactivés pour le compte Activez-les dans Super Admin > Comptes
L’assistant ne répond pas Clé OpenAI invalide/inactive, ou nom de modèle non supporté Vérifiez la clé. Vérifiez que votre endpoint fournit le modèle de l’assistant (gpt-5.2 par défaut, ou celui défini dans l’onglet Captain models du compte).
Pages manquantes dans les documents de site web Pas de clé Firecrawl, donc le crawler simple est utilisé Ajoutez une clé API FireCrawl
Synchronisation des documents de site web échouée Clé API Firecrawl invalide Vérifiez que la clé API Firecrawl est valide. Si une clé est définie, Chatwoot utilise toujours Firecrawl, donc une clé invalide fait échouer la synchronisation de documents web. Retirez la clé pour utiliser le crawler intégré.
Toujours en échec Une erreur sur le serveur Vérifiez les logs web et worker