Esta es una traducción automática del documento original en inglés. En caso de cualquier discrepancia entre esta traducción y la versión original en inglés, prevalecerá la versión en inglés. Leer la versión original en inglés

Solución de problemas

¿Algo no funciona? Empieza por aquí.

Problemas con la extensión del navegador

La extensión no carga

  1. Asegúrate de haberla instalado desde la Chrome Web Store (no una versión de desarrollo)
  2. Ve a chrome://extensions y busca mensajes de error
  3. Intenta desactivar la extensión y volver a activarla
  4. Reinicia Chrome por completo si eso no funciona

El panel lateral no se abre

  1. Haz clic en el icono de Caiioo en tu barra de herramientas (arriba a la derecha)
  2. Asegúrate de estar en una página web normal (algunas páginas como los ajustes de Chrome no permiten extensiones)
  3. Ve a chrome://extensions, busca Caiioo y haz clic en "Recargar"
  4. Intenta hacer clic en el icono de nuevo

Barra lateral en blanco o rota después de una actualización

  • Borra la caché de tu navegador y recarga la extensión
  • Cierra y vuelve a abrir el panel lateral
  • Si nada ayuda, desactiva y vuelve a activar la extensión

Problemas de Inicio de Sesión

No puedo iniciar sesión con Google / Apple / Microsoft

  1. Asegúrate de que tu navegador no esté bloqueando las ventanas emergentes: OAuth requiere una ventana emergente
  2. En iOS, si el inicio de sesión de Google se queda atascado, prueba la opción "Iniciar sesión con Apple" en su lugar
  3. Borra las cookies de caiioo.ai e inténtalo de nuevo
  4. Si has cambiado de contraseña recientemente, cierra la sesión del proveedor en tu navegador primero y vuelve a intentarlo

Atascado en la pantalla de login tras iniciar sesión

  • Espera unos segundos: la aplicación está recuperando tu perfil
  • Si sigue atascado, cierra y vuelve a abrir la aplicación (o recarga la extensión)
  • Asegúrate de que el reloj de tu dispositivo sea correcto: la validación del token OAuth falla si el reloj está desfasado

Problemas con la clave de API

La clave de API no funciona

  1. Copia tu clave nuevamente desde el sitio web del proveedor y pégala con cuidado (sin espacios al principio ni al final)
  2. Comprueba que tu cuenta aún tenga créditos
  3. Prueba a generar una clave nueva y utiliza esa en su lugar
  4. Comprueba que el formato de la clave sea correcto; las claves de OpenRouter comienzan con sk-or-

No encuentro mi clave de API

  • OpenRouter: openrouter.ai/keys
  • Ollama: no se necesita clave; confirma que tu servidor local se esté ejecutando en http://localhost:11434

Consulta Proveedores de IA y claves de API para más detalles.

"Límite de tasa alcanzado" o "sobrecargado" en el modelo que elegí

Eso depende del proveedor, no de tu clave. Cuando un modelo que elegiste tiene el límite de tasa alcanzado, está sobrecargado o no está disponible, Caiioo menciona el modelo y te explica lo sucedido en lugar de cambiarte silenciosamente a otro. Espera un minuto y vuelve a enviar el mensaje, o elige otro modelo tú mismo. (Cuando Caiioo elige el modelo por ti, sigue cambiando de forma automática; esa es la diferencia).

Un modelo gratuito rechaza continuamente mis solicitudes

Algunos modelos gratuitos de OpenRouter rechazan solicitudes de aplicaciones que no figuran en su propia lista de permitidos. Caiioo recuerda el modelo que ha rechazado la solicitud, lo marca en el selector y lo omite al recurrir a otro modelo; luego vuelve a comprobarlo más adelante por si se retira el bloqueo. Mientras tanto, elige un modelo diferente.

Integración de Google (Nivel Pro)

No se puede conectar a Google

  1. Ve a Configuración > Cuenta > Autorizaciones y permisos de cuenta
  2. Haz clic en "Conectar cuenta de Google"
  3. Asegúrate de aprobar todos los permisos solicitados
  4. Comprueba que tu cuenta se muestra como conectada
  5. Si aún no funciona, desconéctate e inténtalo de nuevo

Las herramientas de Google no funcionan

  1. Verifica que Google esté conectado (Configuración > Cuenta > Autorizaciones y permisos de cuenta)
  2. Intenta actualizar tu conexión de Google (botón "Reconectar Google")
  3. Asegúrate de que la herramienta específica esté habilitada (Configuración > Herramientas, modos y aplicaciones > Configuración de herramientas)

Problemas con Private Sync

La sincronización no funciona

  1. Comprueba que Private Sync esté activado (Configuración > Conectividad > Private Sync)
  2. Verifica que tu cuenta de Google esté conectada
  3. Asegúrate de tener espacio de almacenamiento disponible en tu Google Drive
  4. Haz clic en "Reconectar Google" si tu token caducó
  5. Prueba a desactivar y volver a activar la sincronización

Los datos no se sincronizaron entre dispositivos

  • Private Sync funciona en segundo plano; espera unos segundos
  • Comprueba que estés utilizando la misma cuenta de Google en todos los dispositivos
  • Asegúrate de que Private Sync también esté activado en el otro dispositivo
  • Actualiza manualmente desactivando y volviendo a activar la sincronización

Problemas de acceso remoto al navegador

La página relay.caiioo.ai/app no se conecta

  • En tu dispositivo principal, asegúrate de que Retransmisión Privada esté activada (Configuración > Conectividad > Conexiones) y muestre "Conectado"
  • Inicia sesión en el navegador remoto con la misma cuenta que tu dispositivo principal; la retransmisión solo llega a tu propia instancia
  • La extensión o la aplicación de escritorio de tu dispositivo principal deben estar ejecutándose y en línea para que el navegador remoto pueda controlarlas
  • En un inicio en frío, la página puede mostrar un indicador de carga "conectando" durante unos segundos mientras establece la sesión cifrada; deja que termine antes de recargar

Sesión iniciada pero la página remota se queda en la pantalla de inicio de sesión

  • Dale unos segundos: inicia la aplicación solo una vez establecida la sesión cifrada
  • Si se queda atascada, confirma que tu dispositivo principal esté en línea y la Retransmisión Privada esté conectada, luego recarga la página

Problemas de rendimiento

Las respuestas son lentas

  1. Comprueba si el proveedor de IA tiene problemas (consulta su página de estado)
  2. Intenta usar un modelo más rápido y barato (como Gemini Flash o Mistral)
  3. Archiva conversaciones antiguas si tienes cientos de ellas
  4. Comprueba tu conexión a Internet

Las conversaciones tardan una eternidad

  • La IA está trabajando: busca el indicador de carga
  • Algunos modelos son más lentos que otros. Cambia a uno más rápido si tienes prisa
  • Si tarda más de unos minutos, la IA podría estar bloqueada. Haz clic en Detener y vuelve a intentarlo

Suscripción y facturación

No se puede ver "Administrar plan"

  • Asegúrate de haber iniciado sesión con la cuenta que tiene la suscripción
  • Si te suscribiste en iOS, el botón Administrar plan dirige a la configuración de suscripciones de Apple
  • Si te suscribiste en la web, dirige al portal de facturación de Stripe
  • Cierra sesión y vuelve a iniciarla para actualizar el estado de tu suscripción

"Administrar plan" abre el lugar incorrecto

  • Las compras dentro de la aplicación de iOS se gestionan en Configuración > ID de Apple > Suscripciones, no en caiioo.ai/account
  • Las suscripciones de Stripe se gestionan a través del enlace del portal en Configuración > Cuenta > Perfil de usuario o en caiioo.ai/account
  • Caiioo enruta automáticamente según dónde te hayas suscrito; esto es lo esperado

Se actualizó pero sigue en el nivel anterior

  • Las actualizaciones de Stripe tardan un minuto en propagarse; recarga la aplicación
  • Las compras dentro de la aplicación de Apple pueden tardar hasta 24 horas en verificarse. Toca "Restaurar compras" en Configuración > Cuenta > Perfil de usuario para acelerarlo
  • Si ya tienes una suscripción en otra plataforma, el botón Suscribirse te indicará que la gestiones allí

Otros problemas

Pantalla en blanco en la aplicación de escritorio o móvil

  • Reinicia la aplicación por completo
  • Comprueba que estás conectado a internet
  • Intenta borrar la caché de la aplicación (varía según la plataforma)
  • Actualiza a la última versión

Las herramientas no funcionan

  1. Ve a Configuración > Herramientas, modos y aplicaciones > Configuración de herramientas y comprueba que la herramienta esté habilitada
  2. Algunas herramientas requieren permisos o configuración (como una cuenta de Google conectada para las herramientas de Google)
  3. Si ves un error de "necesita permisos", vuelve a conectar el proveedor en Configuración > Cuenta > Autorizaciones y permisos de cuenta y vuelve a aprobar los ámbitos

La extensión no se puede conectar a la aplicación de escritorio

  • Primero, comprueba que Habilitar puente de Caiioo esté activado (Configuración > Conectividad > Conexiones); está desactivado de forma predeterminada, y mientras esté desactivado la extensión nunca se conecta a la aplicación de escritorio y los controles de reconexión/puerto aparecen en gris
  • Si estás utilizando tanto la extensión del navegador como la aplicación de escritorio, la extensión se conecta a la aplicación de escritorio a través de un WebSocket local (puente de capacidades, no sincronización de estado)
  • Reinicia la aplicación de escritorio y luego recarga la extensión
  • Asegúrate de que no se esté ejecutando ninguna otra copia de la aplicación de escritorio; las instancias múltiples entran en conflicto

Advertencia "Navegador no conectado" en macOS aunque haya un navegador abierto

  • Caiioo ahora reconoce Chrome, Safari, Edge y Firefox; la advertencia desaparece en el momento en que cualquiera de ellos se conecta
  • Safari se conecta a través de un canal diferente y puede entrar brevemente en suspensión cuando no es la aplicación en primer plano; permanece conectado y Caiioo lo reactiva automáticamente cuando un comando lo necesita
  • Si la advertencia persiste, pon tu navegador en primer plano una vez y vuelve a intentarlo

Los archivos adjuntos de los mensajes no se cargan

  • Comprueba que el formato de archivo sea compatible (PDF, imágenes, documentos de Word, hojas de cálculo, presentaciones)
  • Prueba con un archivo más pequeño
  • Asegúrate de tener conexión a internet

Obtener ayuda

  • Respuestas rápidas: Haz clic en el icono ? en la cabecera
  • Configuración y solución de problemas: Haz clic en el icono de engranaje
  • Esta guía: Configuración > Ayuda > Documentación y Legal
  • Permite que Caiioo envíe un informe de error por ti: Pídele que informe de un problema y abrirá el formulario de soporte integrado precargado con un informe detallado para que lo revises y envíes. Di "solo envíalo" y —con tu aprobación— enviará el ticket directamente, adjuntando los detalles técnicos de la conversación para que el equipo pueda reproducir lo que viste.

Ver también

This guide is maintained by the Caiioo team using Slate, our built-in editor.