Habilitar Captain en autohospedado

Sojan

Sojan

Última actualización el Oct 20, 2026

Descubre

Puedes ejecutar Captain en tu propia instalación de Chatwoot con tu propia clave de OpenAI.

Plan y acceso: incluido en los planes Premium y Enterprise autoalojados. Consulta Enterprise Edition. Necesitas acceso a la consola de Super Admin. La Community Edition no incluye Captain.

Premium y Enterprise obtienen las mismas funciones y configuraciones de Captain.

Configura y prueba

Antes de empezar

  • Una clave de API de OpenAI.

  • Opcional: un endpoint compatible con OpenAI si alojas tu propio modelo.

  • Opcional: una clave de API de Firecrawl para una mejor exploración de sitios web. Sin ella, Chatwoot utiliza un rastreador integrado más simple.

1. Configura Captain para la instalación

  1. Abre la consola de Super Admin y ve a Configuración.

  2. En la tarjeta de Captain, haz clic en el icono de configuración (engranaje).

  3. Completa:

    • Clave de API de OpenAI.

    • Modelo de OpenAI establece el modelo para las funciones de Copilot y el editor. Déjalo en blanco para usar gpt-4.1-mini. El asistente usa gpt-5.2 por defecto. Para cambiarlo, ve a Super Admin › Cuentas, edita la cuenta y abre la pestaña Modelos de Captain. Si usas un endpoint personalizado, asegúrate de que sirva los modelos que eliges aquí.

    • Endpoint de API de OpenAI (opcional), para un modelo autoalojado compatible.

    • Modelo de embedding (opcional).

    • Clave de API de FireCrawl (opcional).

  4. Haz clic en Enviar.

2. Activa Captain para una cuenta

Las cuentas creadas mientras tu instalación tiene Premium o Enterprise ya tienen Captain activado. Para las cuentas creadas antes de eso:

  1. En la consola de Super Admin, ve a Cuentas.

  2. Abre la cuenta y haz clic en Editar.

  3. En las funciones premium, activa Captain. Los guardarraíles, directrices de respuesta y escenarios vienen incluidos. Para herramientas personalizadas, activa también Herramientas Personalizadas (Configura herramientas personalizadas para Captain).

  4. Guarda.

Pruébalo

Inicia sesión en esa cuenta. Captain aparece en la barra lateral. Crea un asistente y envía un mensaje en el Playground. Consulta Configura un asistente de Captain y conecta tus bandejas de entrada.

Sácale provecho

Solución de problemas

Síntoma Causa probable Qué hacer
No aparece Captain en la barra lateral No está activado para la cuenta, o no tienes una licencia Premium o Enterprise Verifica ambos pasos; revisa tu licencia
No hay Herramientas Herramientas Personalizadas está desactivado para la cuenta Actívalas en Super Admin > Cuentas
El asistente no responde Clave de OpenAI inválida o inactiva, o nombre de modelo no compatible Revisa la clave. Verifica que tu endpoint sirva el modelo del asistente (gpt-5.2 por defecto o el que se indique en la pestaña Modelos de Captain de la cuenta).
Documentos web sin páginas Sin clave de Firecrawl, por lo que se usa el rastreador simple Agrega una clave de API de FireCrawl
Fallo al sincronizar documentos web Clave de API de Firecrawl inválida Verifica que la clave de Firecrawl sea válida. Si se establece una clave, Chatwoot siempre usa Firecrawl, por lo que una clave inválida hará que los documentos web fallen. Elimina la clave para usar el rastreador integrado.
Sigue fallando Un error en el servidor Revisa los logs web y de worker