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 emparejamiento.
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. Revisa primero los registros del Agent en busca de un error de plataforma no compatible — en algunas plataformas faltan componentes, así que el emparejamiento sale bien pero la conexión nunca se levanta.
Por ahora, correr el Agent en Linux, macOS o un contenedor es la opción más estable.
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 registró pero nunca llega a estar en línea
Casi siempre es un problema con el código de emparejamiento. Los códigos son de un solo uso y caducan — no insistas con el mismo código. Genera uno nuevo, actívalo de nuevo y después reinicia el Agent.
Si se activó pero nunca llega el mensaje de saludo, 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.