Solución de problemas

La aplicación no se instala ni se abre.

Windows

Si SmartScreen bloquea el instalador, elija Más información → Ejecutar de todos modos. La compilación del escritorio está firmada con código, por lo que normalmente no aparece.

Si la aplicación se instala pero no se inicia, intente instalarla desde Microsoft Store en lugar del instalador directo: la compilación de la Tienda maneja sus propias dependencias.

macOS

Si macOS se niega a abrir la aplicación, abra Configuración del sistema → Privacidad y seguridad y permítala allí, luego iníciela nuevamente.

Asegúrese de arrastrar 9xchat a Aplicaciones en lugar de ejecutarlo desde la imagen del disco montado.

Linux

Compruebe que el archivo descargado esté marcado como ejecutable. Si no es así, configure el bit ejecutable y ejecútelo nuevamente.

Móvil

Instálalo a través de Google Play o App Store para que las actualizaciones lleguen automáticamente. Si la aplicación no se inicia, actualícela y luego reinicie su dispositivo.

Las respuestas fallan o se detienen parcialmente

Trabaje con estos en orden:

1. Comprueba tu conexión. Los modelos en la nube necesitan acceso a Internet. Los modelos locales lo hacen no: si las solicitudes de la nube fallan pero las locales funcionan, el problema es la red o el proveedor, no 9xchat.

2. Verifique su saldo de crédito. Si está utilizando créditos 9xchat y tienen se agotan, las solicitudes se detienen. Recarga o cambia a tu propia clave API.

3. Comprueba tu clave API. Si trajiste tu propia clave, confirma que todavía está válido y le queda cuota con ese proveedor.

4. Pruebe con un modelo diferente. Si un modelo falla y otro tiene éxito, el problema es con ese modelo o proveedor específico.

Falta un modelo o no se carga

• Los modelos en la nube necesitan créditos o una clave API configurada para eso proveedor. En Biblioteca → Modelos, un proveedor permanece marcado Inactivo hasta que agrega su clave; esa etiqueta es la forma más rápida de ver a qué no tiene ruta.

• Los modelos locales necesitan que su corredor local inicie antes de que 9xchat pueda comunicarse con ellos. Inícielo primero, luego vuelva a abrir la lista de modelos.

Su clave API es rechazada

La falla está en el proveedor, por lo que la solución también está ahí:

1. Pegue la clave nuevamente, sin espacios iniciales ni finales.
2. Confirme que la clave pertenece al proveedor bajo el cual la agregó.
3. Verifique que la clave aún exista y no haya sido revocada ni rotada.
4. Verifique que tenga la facturación configurada y la cuota restante con ese proveedor: un Una clave válida sin saldo falla de la misma manera que una mala.
5. Confirme que el modelo que eligió sea uno que su cuenta pueda usar. algunos Los modelos necesitan un nivel separado con el proveedor.

Las claves se almacenan cifradas en su máquina. Si una clave deja de funcionar en todas partes, reemplácela con el proveedor en lugar de reinstalar 9xchat.

Un modelo local no se conecta

1. Inicie su corredor local y confirme que responde fuera de 9xchat.
2. Confirme que esté escuchando en la dirección y el puerto que espera 9xchat.
3. Confirme que se tira y carga el modelo en sí, no solo el corredor en funcionamiento.
4. Vuelva a abrir Biblioteca → Modelos para que la lista se actualice.

Los modelos locales no necesitan clave ni créditos. Si un modelo local funciona y uno en la nube no, el problema es tu clave, tu saldo o la red.

Una herramienta o servidor MCP no funciona

1. Compruebe que la herramienta esté habilitada. Cada herramienta tiene un interruptor habilitado debajo Biblioteca → Herramientas.

2. Consulta el plan. Las herramientas Agentic y la búsqueda web en vivo necesitan Pro: consulta Créditos, Pro y uso.

3. Lea la línea de Seguridad. Indica qué permisos necesita la herramienta. una herramienta que no puede alcanzar lo que necesita, fracasa en lugar de pedirlo.

4. Para servidores MCP, confirme que se proporcionaron los secretos requeridos: una entrada todavía marcado Necesita configuración no se ha configurado. La vista previa de la configuración muestra el comando exacto que ejecuta, que vale la pena volver a leer si el servidor nunca se inicia.

5. Aíslelo. Deshabilite la herramienta, haga la misma pregunta y vea si el cambios de comportamiento. Eso le indica si la herramienta está involucrada.

La búsqueda de conocimientos no encuentra nada.

Una colección debe indexarse antes de poder buscarse.

• Confirme que los archivos se agregaron a una colección, no solo se adjuntaron a un chat.
• Confirme que la herramienta Buscar conocimiento esté habilitada.
• Si no se podía acceder a su proveedor de incrustaciones cuando agregó los archivos, la búsqueda recurre a la concordancia de palabras clave y perderá todo lo que necesite el índice. Vuelva a agregar los archivos una vez que se pueda acceder al proveedor.

Ver Conocimientos y Memorias.

Un archivo adjunto no se procesará

• Confirme que el modelo que seleccionó acepta ese tipo de archivo. Un modelo de solo texto no puede leer una imagen y la lista de modelos marca las que manejan la visión.
• Los archivos muy grandes pueden exceder el contexto de un modelo. Pruebe con un extracto más pequeño o un modelo con una ventana de contexto más grande.
• Si el archivo se abre correctamente en otro lugar pero falla aquí, intente convertirlo a un formato común primero.

La generación de imágenes falla

• La generación de imágenes necesita Pro.
• Confirme que tiene un modelo de imagen seleccionado: se elige por separado de su modelo de chat.
• Consulta tu saldo de crédito si estás generando a través de créditos 9xchat.
• Algunas solicitudes son rechazadas por el proveedor y no por 9xchat; reformular es normalmente más rápido que volver a intentarlo.

El dictado o la lectura en voz alta fallan

Ambos necesitan un proveedor de audio que funcione y ninguno tiene una opción local.

• Confirme que su Proveedor de transcripciónesté configurado enConfiguración → Predeterminado Modelos.
• Otorgue permiso al micrófono 9xchat en la privacidad de su sistema operativo configuración: en macOS, Configuración del sistema → Privacidad y seguridad → Micrófono.
• Ambos necesitan una conexión incluso cuando su modelo de chat sea local.

La entrada de micrófono necesita Pro; leer en voz alta no.

Los créditos se agotan más rápido de lo esperado

Cada mensaje muestra su propio costo, latencia y desglose de tokens, y la sesión muestra un total acumulado. Si un total parece incorrecto, abra las cifras por mensaje para ver qué intercambio lo tiene en cuenta: el contexto largo, los tokens de razonamiento y los archivos adjuntos grandes aumentan el costo de un solo turno.

Puede limitar esto por chat reduciendo los tokens de finalización máximos y el límite de contexto en la configuración del modelo, y Context Shield reduce la cantidad de historial que se reenvía con cada mensaje.

Para dejar de gastar créditos por completo, agregue su propia clave API o utilice un modelo local.

Una función está atenuada o falta

Varias funciones necesitan Pro: múltiples pestañas, la ventana flotante, mini chat, el asistente rápido, herramientas de agencia, búsqueda web en vivo, el área de juegos de imágenes, entrada de micrófono y el sistema de memoria. Créditos, Pro y uso enumera la división completa.

Si ya paga, confirme que este dispositivo haya iniciado sesión con el UID que posee la suscripción y que no haya excedido el límite del dispositivo: un dispositivo gratis, tres en Pro. Siga UID en tres dispositivos para conectar, cambiar o eliminar un dispositivo.

Falta algo en otro dispositivo

Su espacio de trabajo se almacena localmente en cada dispositivo, por lo que una segunda máquina iniciada con el mismo UID no hereda sus chats, notas o recuerdos. Esto es algo que se espera más que un defecto.

• Las memorias son por dispositivo. Una nueva instalación comienza sin ninguna.
• Handoff empareja dos dispositivos para una conversación; no copia el resto de su espacio de trabajo.
• Para mover material usted mismo, use Configuración → Datos y exportaciones.

Su suscripción sigue el UID, por lo que un dispositivo que verifica con él elige Pro aunque el contenido no viaje.

Nada aquí ayudó

Comuníquese a través de support con:

• su sistema operativo y la versión 9xchat,
• el modelo y proveedor que estaba utilizando,
• ya sea que tuviera créditos, su propia clave o un modelo local,
• lo que hiciste y el error visible exacto.