Descubrir
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 Edición Community no incluye Captain.
Premium y Enterprise obtienen las mismas funciones y configuraciones de Captain.
Configurar y probar
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 usa 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 lo siguiente:
-
Clave de API de OpenAI.
-
Modelo de OpenAI establece el modelo para Copilot y las funciones de 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 la API de OpenAI (opcional), para un modelo autoalojado compatible.
-
Modelo de embed (opcional).
-
Clave de API de FireCrawl (opcional).

-
-
Haz clic en Enviar.
2. Activa Captain para una cuenta
Las cuentas creadas mientras tu instalación está en Premium o Enterprise ya tienen Captain activado. Para 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. Se incluyen Guardrails, directrices de respuesta y escenarios. Para herramientas personalizadas, activa también Custom Tools (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.
Obtén valor
-
OpenAI te cobra por el uso con tu propia clave. Chatwoot no cuenta créditos de Captain en instalaciones autoalojadas.
-
¿Actualizando desde una versión anterior donde los asistentes usaban el campo Instrucciones? Ya no se usan instrucciones. Muévelas a guardrails y directrices de respuesta antes de actualizar (Configura los guardrails, 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 | Revisa ambos pasos; revisa tu licencia |
| No hay herramientas | Custom Tools 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 soportado | Revisa la clave. Asegúrate de que tu endpoint sirva el modelo del asistente (gpt-5.2 por defecto, o el que se establezca en la pestaña Modelos de Captain de la cuenta). |
| Los documentos de sitios web omiten páginas | No hay clave de Firecrawl, así que se usa el rastreador simple | Agrega una clave de API de FireCrawl |
| Los documentos de sitios web fallan al sincronizar | Clave de API de Firecrawl inválida | Revisa que la clave de Firecrawl sea válida. Si se establece una clave, Chatwoot siempre usa Firecrawl, así que una clave inválida hará que fallen los documentos de sitios web. Elimina la clave para usar el rastreador integrado. |
| Sigue fallando | Un error en el servidor | Revisa los registros web y worker |