Habilitar Captain en autohospedado

Sojan

Sojan

Última actualización el Oct 21, 2026

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

  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 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 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 la API de OpenAI (opcional), para un modelo autoalojado compatible.

    • Modelo de embed (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 está en Premium o Enterprise ya tienen Captain activado. Para 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. Se incluyen Guardrails, directrices de respuesta y escenarios. Para herramientas personalizadas, activa también Custom Tools (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.

Obtén valor

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