Habilitar Captain en autoalojado

Sojan

Sojan

Última actualización el Oct 15, 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 autohospedados Premium y Enterprise. Consulta [Link: Editions & licensing]. Necesitas acceso a la consola de Super Admin. La edición Community no incluye Captain.

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

Configurar y probar

Antes de comenzar

  • Una clave API de OpenAI.

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

  • Opcional: una clave API de Firecrawl para un mejor rastreo de sitios web. Sin ella, Chatwoot utiliza un rastreador incorporado 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 ícono de ajustes (engranaje).

  3. Rellena:

    • Clave API de OpenAI.

    • Modelo de OpenAI establece el modelo para las funciones de Copilot y editor. Déjalo en blanco para usar gpt-4.1-mini. El asistente utiliza 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 selecciones aquí.

      [Screenshot: captain-11-c3-captain-models.png]

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

    • Modelo de Embedding (opcional).

    • Clave 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 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. Las reglas, directrices de respuesta y escenarios vienen incluidos. Para herramientas personalizadas, activa también Herramientas Personalizadas (Custom tools).

  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 Crear y conectar un asistente.

Obtén valor

  • OpenAI te cobra por el uso en tu propia clave. Chatwoot no cuenta créditos de Captain en instalaciones autohospedadas.

  • ¿Actualizando desde una versión anterior donde los asistentes usaban el campo de Instrucciones? Ya no se utilizan Instrucciones. Muévelas a reglas y directrices de respuesta antes de actualizar (Guardrails, guidelines and scenarios).

  • Todo lo demás funciona igual que en la nube. Continúa con Agregar conocimiento: documentos.

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 hay 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 un nombre de modelo no compatible Verifica la clave. Revisa que tu endpoint sirva el modelo del asistente (gpt-5.2 por defecto, o el configurado en la pestaña Modelos de Captain de la cuenta).
Faltan páginas en documentos web No hay clave de Firecrawl, por lo que se usa el rastreador simple Agrega una clave API de FireCrawl
Los documentos web no se sincronizan Clave API de Firecrawl inválida Verifica que la clave API de Firecrawl sea válida. Si hay clave, Chatwoot siempre usa Firecrawl, así que una clave inválida hace que fallen los documentos web. Elimina la clave para usar el rastreador incorporado.
Sigue fallando Un error en el servidor Consulta los registros web y de los workers