Ir al contenido

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.

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:

Ventana de terminal
remotxai status
remotxai service start

La app dice Ordenador inaccesible, Sin conexión o En reposo.

  1. Despierta el ordenador y revisa su red.
  2. Ejecuta remotxai status en el ordenador. Si el servicio no está en marcha, arráncalo.
  3. Mira su línea relay link. linked to wss://app.remotxai.com with organisation admission significa que la app llega al ordenador. refused: da el motivo, por ejemplo host-not-endorsed. off: dice por qué no se conecta. remotxai doctor muestra lo mismo en su fila relay config.
  4. Si ejecutaste remotxai down, ejecuta remotxai up.
  5. Si relay linked now dice no y relay last linked tiene minutos, ejecuta remotxai 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 responde try again in N s.
  6. En la app, pulsa Reconectar.
Ventana de terminal
remotxai status
remotxai service status
remotxai service start
remotxai up
remotxai reload --relay

Las 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:

Ventana de terminal
remotxai logs -n 100

Un ordenador en reposo no trabaja. Mantenlo despierto si tus agentes corren mucho tiempo.

No lo apruebes y no adivines. Puede haber un relé entre el móvil y el ordenador.

  1. Deniega la petición en el ordenador. remotxai pair requests la lista y remotxai pair deny <ref> la deniega.
  2. Ejecuta remotxai up en el ordenador e inicia sesión otra vez o, en un ordenador que funciona con REMX_LEGACY_PAIRING=1, abre una ventana de emparejamiento nueva.
  3. Vuelve a empezar en el móvil. Un emparejamiento heredado muestra un código nuevo.
Ventana de terminal
remotxai pair requests
remotxai pair deny <ref>
remotxai pair enable 5m
remotxai pair

Si 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.

Ventana de terminal
remotxai up

Para 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.

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.

Ventana de terminal
remotxai pair requests
remotxai 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:

Ventana de terminal
remotxai status
remotxai logs -n 100
remotxai doctor

La app dice que un agente no puede arrancar. En la terminal donde instalaste remotxai, comprueba que está instalado:

Ventana de terminal
command -v claude
command -v codex
command -v pi

Solo 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.

  • 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.
Ventana de terminal
remotxai upgrade

Después pulsa otra vez Avisar en este dispositivo. Más: Notificaciones.

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:

Ventana de terminal
remotxai upgrade

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.

Ventana de terminal
remotxai doctor
remotxai 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»
Ventana de terminal
remotxai service status
remotxai service start
remotxai logs -n 100

Si 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.

Vuelve a la versión anterior:

Ventana de terminal
remotxai service rollback

Despué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.

Reúne esto:

Ventana de terminal
remotxai doctor
remotxai logs -n 100
remotxai diagnostics

remotxai 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.