Solución de problemas
Ejecuta primero remotxai doctor en el ordenador. Todas las líneas deben decir PASS. Una línea FAIL nombra el problema.
La app se queda bloqueada
Sección titulada «La app se queda bloqueada»Ajustes → Apariencia → Recargar la app recarga la pantalla. Las sesiones siguen en marcha. Si sigue bloqueada, revisa el servicio en el ordenador y arráncalo si está caído:
remotxai statusremotxai service startLa app no llega a mi ordenador
Sección titulada «La app no llega a mi ordenador»La app dice Ordenador inaccesible, Sin conexión o En reposo.
- Despierta el ordenador y revisa su red.
- Ejecuta
remotxai statusen el ordenador. Si el servicio no está en marcha, arráncalo. - Mira su línea
relay link.linked to wss://app.remotxai.com with organisation admissionsignifica que la app llega al ordenador.refused:da el motivo, por ejemplohost-not-endorsed.off:dice por qué no se conecta.remotxai doctormuestra lo mismo en su filarelay config. - Si ejecutaste
remotxai down, ejecutaremotxai up. - Si
relay linked nowdicenoyrelay last linkedtiene minutos, ejecutaremotxai reload --relay. Corta la conexión con el relay y vuelve a conectarse sin reiniciar el servicio. Ejecútalo una vez; una segunda llamada antes de 2 segundos respondetry again in N s. - En la app, pulsa Reconectar.
remotxai statusremotxai service statusremotxai service startremotxai upremotxai reload --relayLas sesiones siguen en marcha mientras el enlace está caído. La app se pone al día cuando vuelve. No reenvíes un prompt mientras reconecta.
La conexión se cae tras el reposo o un cambio de red
Sección titulada «La conexión se cae tras el reposo o un cambio de red»La app muestra “Se cayó la conexión, reconectando (las sesiones siguen en marcha)”. Déjala abierta. El ordenador se reconecta solo y escribe relay linked: en el registro cuando lo hace:
remotxai logs -n 100Un ordenador en reposo no trabaja. Mantenlo despierto si tus agentes corren mucho tiempo.
El código de verificación no coincide
Sección titulada «El código de verificación no coincide»No lo apruebes y no adivines. Puede haber un relé entre el móvil y el ordenador.
- Deniega la petición en el ordenador.
remotxai pair requestsla lista yremotxai pair deny <ref>la deniega. - Ejecuta
remotxai upen el ordenador e inicia sesión otra vez o, en un ordenador que funciona conREMX_LEGACY_PAIRING=1, abre una ventana de emparejamiento nueva. - Vuelve a empezar en el móvil. Un emparejamiento heredado muestra un código nuevo.
remotxai pair requestsremotxai pair deny <ref>remotxai pair enable 5mremotxai pairSi el código sigue sin coincidir, para. Comprueba que el móvil y el ordenador usan el servicio de remotxai que esperas.
El móvil dice que el ordenador no está en una organización
Sección titulada «El móvil dice que el ordenador no está en una organización»El emparejamiento nuevo está desactivado por defecto, así que el móvil dice Este ordenador no está en una organización. En el ordenador, ejecuta remotxai up e inicia sesión, y luego pulsa Reintentar en el móvil.
remotxai upPara emparejar un móvil directamente, pon REMX_LEGACY_PAIRING=1 en el entorno del daemon, ejecuta remotxai pair y déjalo abierto (o remotxai pair enable 10m). remotxai pair enable también sigue abriendo la ventana que aprueba un cambio de alcance de un dispositivo ya emparejado.
La petición de emparejamiento caducó
Sección titulada «La petición de emparejamiento caducó»Nadie la aprobó en 3 minutos. Pulsa Iniciar una nueva petición en el móvil y ejecuta remotxai pair approve <ref> en el ordenador antes de que pasen 3 minutos. Un dispositivo nuevo solo llega al ordenador con remotxai up, o con una ventana de emparejamiento si el daemon funciona con REMX_LEGACY_PAIRING=1. Reiniciar el ordenador también cancela las peticiones pendientes.
remotxai pair requestsremotxai pair approve <ref>remotxai status o remotxai pair se queda colgado
Sección titulada «remotxai status o remotxai pair se queda colgado»Puede que el servicio esté reconectando. Espera un minuto y reintenta. Si sigue fallando, mira el registro y ejecuta remotxai doctor:
remotxai statusremotxai logs -n 100remotxai doctorEl agente no está disponible
Sección titulada «El agente no está disponible»La app dice que un agente no puede arrancar. En la terminal donde instalaste remotxai, comprueba que está instalado:
command -v claudecommand -v codexcommand -v piSolo necesitas el que uses. Instálalo e inicia sesión, y luego ejecuta remotxai service install para que el servicio lo encuentre. Esto reinicia el servicio y detiene las sesiones en curso, así que termina antes lo que tengas activo.
No recibo notificaciones
Sección titulada «No recibo notificaciones»- Las notificaciones están bloqueadas en este navegador. Permítelas en los ajustes del móvil.
- Este navegador no puede recibir notificaciones push. En iPhone, añade antes la app a la pantalla de inicio. Consulta Instala la app en tu móvil.
- Este ordenador aún no puede enviar notificaciones. Actualiza remotxai en él.
- No llegan mientras la app está abierta en pantalla.
remotxai upgradeDespués pulsa otra vez Avisar en este dispositivo. Más: Notificaciones.
Se rechaza un adjunto
Sección titulada «Se rechaza un adjunto»La app da el motivo. Lo habitual es un archivo de más de 32 MiB, un mensaje con más de 64 MiB de archivos en total, un archivo vacío o un agente que no lee ese tipo. Mira Archivos y adjuntos. Arregla o cambia el archivo y reenvíalo. Si tu remotxai es antiguo, actualízalo primero:
remotxai upgradeUn cambio de perfil no funcionó
Sección titulada «Un cambio de perfil no funcionó»La app dice El agente no arrancó con el perfil nuevo, así que la sesión volvió atrás. No se perdió nada. Comprueba que el inicio de sesión del perfil sigue funcionando en el ordenador, ejecuta remotxai doctor y reintenta. Si la app dice que un cambio anterior no terminó, comprueba qué cuenta está en marcha. Después quita la marca con Quitar la marca de recuperación en un móvil admin, o en el ordenador. Mira Perfiles y cuentas.
remotxai doctorremotxai sessions clear-switch-recovery <session-id>El servicio en segundo plano no está en marcha
Sección titulada «El servicio en segundo plano no está en marcha»remotxai service statusremotxai service startremotxai logs -n 100Si no está instalado, ejecuta remotxai service install. Si se detiene una y otra vez, remotxai doctor y el registro nombran la causa. En un ordenador nuevo suele ser que no hay ningún agente instalado (claude, codex o pi). El registro dice entonces no coding agent found. Mira El agente no está disponible.
Una actualización rompió algo
Sección titulada «Una actualización rompió algo»Vuelve a la versión anterior:
remotxai service rollbackDespués de volver atrás, una versión descargada para la actualización que deshiciste nunca se aplica sola, porque el ordenador solo aplica una versión más nueva que la que ejecuta. El daemon borra esa descarga sobrante al arrancar, y remotxai status también la borra y lo dice en una línea. Para volver a una versión anterior a propósito, usa remotxai service rollback o remotxai upgrade --allow-downgrade.
Sigo atascado
Sección titulada «Sigo atascado»Reúne esto:
remotxai doctorremotxai logs -n 100remotxai diagnosticsremotxai diagnostics escribe un remotxai-diagnostics-<timestamp>.tar.gz con datos ocultados en la carpeta actual. Quita cualquier token o nombre personal antes de compartirlo. Escribe a [email protected] solo para problemas de seguridad.