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
-
Abre la consola de Super Admin y ve a Configuración.
-
En la tarjeta de Captain, haz clic en el icono de configuración (engranaje).

-
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 usagpt-5.2por 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).

-
-
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:
-
En la consola de Super Admin, ve a Cuentas.
-
Abre la cuenta y haz clic en Editar.
-
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).

-
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
-
OpenAI te cobra por el uso en tu propia clave. Chatwoot no cuenta créditos de Captain en instalaciones autoalojadas.
-
¿Actualizaste desde una versión anterior donde los asistentes usaban el campo de Instrucciones? Ya no se usan instrucciones. Transfiérelas a guardarraíles y directrices de respuesta antes de actualizar (Configura los guardarraíles, directrices y escenarios de Captain).
-
Todo lo demás funciona igual que en Cloud. Continúa con Agrega documentos al conocimiento de Captain.
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 |