Cómo resolver problemas de conexión

Cuatro síntomas distintos de «no conecta», cuatro causas distintas: atascado en «conectando» suele ser que el proceso murió; aparece offline con el proceso corriendo significa que la conexión nunca se estableció; se corta y vuelve es un problema de estabilidad; nunca llega a conectar suele ser un problema con el código de conexión.

Compara primero con estos cuatro síntomas — cada uno tiene una causa distinta.

Se queda atascado en «Conectando con el Agent…»

El proceso del Agent murió. La causa más común es correrlo en una ventana de terminal que luego se cerró, matando el proceso con ella.

Lo mejor es instalarlo como servicio del sistema, para que se quede corriendo en segundo plano.

Aparece «offline» aunque el Agent sigue corriendo

La conexión nunca llegó a establecerse. En la mayoría de los casos, el Agent se vuelve a conectar solo después de reiniciar su proceso. Si sigue apareciendo offline, usa «Diagnosticar y reparar» en el perfil de ese Agent; no hace falta añadirlo de nuevo (consulta «Conecta tu propio Agent»).

Una línea en los registros que dice «unsupported platform …; skipping liveware download» solo significa que esta máquina no descargó la herramienta de Liveware, así que por ahora el Agent no puede publicar Liveware. No afecta a la conexión ni al envío y la recepción de mensajes, y no es la causa de que aparezca offline. Al actualizar el plugin a la última versión, la línea deja de aparecer en Windows x64.

La conexión se corta y vuelve, se cae en plena conversación

Actualiza primero el cliente y el plugin a la última versión y observa si sigue pasando. Revisa también si esa máquina entra en reposo — cuando lo hace, el proceso del Agent se detiene con ella, la conexión se corta, y ClawChat no puede despertarla de forma remota.

Si necesitas que el Agent esté siempre en línea, la solución más definitiva es correrlo en algo que nunca entra en reposo: un servidor, una máquina siempre encendida, o un contenedor.

Se añadió pero nunca llega a estar en línea

Casi siempre es un problema con el código de conexión. Cada código sirve para una sola conexión y caduca, así que no insistas con el mismo. Copia un mensaje nuevo desde «Añadir Agent» y envíaselo a tu Agent. Si te pide que lo reinicies, no te saltes ese paso.

Si la fila «Esperando al Agent» ya se convirtió en tu chat con el Agent pero el saludo nunca llega, en la gran mayoría de los casos es que el paso de reiniciar no se hizo.

Falla la instalación del plugin

Los propios servicios de ClawChat se pueden acceder directamente desde China continental, sin necesitar nada especial. Los fallos de instalación suelen darse del lado de la plataforma de alojamiento de código, que es de donde el instalador obtiene los archivos por defecto.

Esto suele evitarse con la opción de «instalar directo desde el host»; no conviene forzar una reinstalación una y otra vez, porque repite el mismo camino que ya falló.

Si aparece que un comando de clawchat no existe, casi nunca es un error de escritura — casi siempre significa que el plugin no terminó de instalarse.

Si sigue sin funcionar: envía el registro de diagnóstico

En la página «Acerca de ClawChat» (en el móvil, desde «Yo → Ajustes»; en el ordenador, desde «Ajustes»), pulsa «Enviar registro a Spark». Al confirmar, se envía un registro de diagnóstico como archivo a tu chat con Spark, el Agent oficial de atención con IA, para investigar el problema de conexión. El registro solo incluye registros de conexión, sin contenido de chats; se quitan las credenciales de inicio de sesión y los identificadores de dispositivo y de cuenta.

Si Spark todavía no es tu contacto, el registro no se envía. Primero agrega a Spark como contacto y, cuando acepte, vuelve a esa página para enviarlo.