Siga los pasos de solución de problemas de acuerdo con su plataforma actual y método de conexión.
🌄 En la versión más reciente del plugin de la aplicación OneKey, ya no se requiere OneKey Bridge para conectar su billetera de hardware. El antiguo método de conexión OneKey Bridge ha sido retirado.
Windows
Solución de problemas de conexión USB
Falta el controlador USB para la billetera de hardware
Compruebe si su dispositivo ha sido actualizado a la última versión del firmware. Consulte "Actualización del firmware de la billetera de hardware OneKey" para obtener instrucciones de actualización.
Abra el "Administrador de dispositivos" de Windows y busque en "Controladoras de bus serie universal" los dispositivos que comienzan con "OneKey". Si un dispositivo muestra un signo de exclamación, actualice el controlador de Windows utilizando el método a continuación.
Solución
Visite https://zadig.akeo.ie/ y descargue el paquete de instalación "Zadig 2.9".
Después de abrir el instalador, seleccione "WinUSB" para instalar.
Reinicie su computadora después de la instalación para aplicar los cambios.
Solución de problemas de conexión Bluetooth
Comprobación de versión y permisos
Usando la aplicación OneKey (versión 5.12 o posterior), puede conectar su billetera de hardware a su computadora mediante Bluetooth. Asegúrese de que su billetera de hardware OneKey también tenga instalada la versión de firmware más reciente. Consulte "Actualización del firmware de la billetera de hardware OneKey" para obtener instrucciones de actualización.
Compruebe si el Bluetooth está desactivado en su billetera de hardware. Para OneKey Pro, también desactive el modo Air-Gap. Luego, bloquee y desbloquee su billetera de hardware e intente conectarse vía Bluetooth nuevamente.
En "Configuración" - "Preferencias", asegúrese de que la función Bluetooth para la aplicación OneKey esté habilitada.
Nota: La conexión Bluetooth no es compatible con la extensión del navegador. Por favor, utilice USB.
macOS
Solución de problemas de conexión USB
Falta autorización del sistema para la conexión de accesorios USB
Compruebe si su dispositivo ha sido actualizado a la última versión del firmware. Consulte "Actualización del firmware de la billetera de hardware OneKey" para obtener instrucciones de actualización.
Cuando utilice una conexión USB-C, haga clic en "Permitir" en el aviso de autorización.
Si previamente denegó la autorización y el aviso ya no aparece, vaya a "Ajustes del Sistema" - "Privacidad y seguridad" - "Seguridad" - "Accesorios" y cambie la configuración a "Preguntar siempre". Esta opción está disponible principalmente en MacBooks con Apple Silicon (M1/M2/M3, etc.).
Solución de problemas de conexión Bluetooth
Comprobación de versión y permisos
Usando la aplicación OneKey (versión 5.12 o posterior), puede conectar su billetera de hardware a su computadora mediante Bluetooth. Asegúrese de que su billetera de hardware OneKey también tenga instalada la versión de firmware más reciente. Consulte "Actualización del firmware de la billetera de hardware OneKey" para obtener instrucciones de actualización.
Compruebe si el Bluetooth está desactivado en su billetera de hardware. Para OneKey Pro, también desactive el modo Air-Gap. Luego, bloquee y desbloquee su billetera de hardware e intente conectarse vía Bluetooth nuevamente.
En "Configuración" - "Preferencias", asegúrese de que la función Bluetooth para la aplicación OneKey esté habilitada.
Nota: La conexión Bluetooth no es compatible con la extensión del navegador. Por favor, utilice USB.
Linux
Solución de problemas de conexión USB
Reglas udev no configuradas
Compruebe si su dispositivo ha sido actualizado a la última versión del firmware. Consulte "Actualización del firmware de la billetera de hardware OneKey" para obtener instrucciones de actualización.
Vaya a https://data.onekey.so/onekey.rules para copiar las reglas udev.
Cree un nuevo archivo en /etc/udev/rules.d/99-onekey.rules y pegue las reglas copiadas en él.
En la terminal, ingrese:
sudo udevadm control --reload-rules
Android
Solución de problemas de conexión Bluetooth
Permisos no habilitados
Compruebe si su dispositivo ha sido actualizado a la última versión del firmware. Consulte "Actualización del firmware de la billetera de hardware OneKey" para obtener instrucciones de actualización.
Reinicie la aplicación OneKey y el dispositivo de hardware OneKey, y habilite individualmente los permisos de GPS y Bluetooth para la aplicación OneKey en "Configuración del sistema".
Nota: Si su modelo de billetera es OneKey Pro y el modo AirGap está activado, el USB y Bluetooth del dispositivo de hardware no estarán disponibles. Estarán utilizables después de desactivar el modo AirGap.
iOS
Solución de problemas de conexión Bluetooth
Permisos no habilitados
Compruebe si su dispositivo ha sido actualizado a la última versión del firmware. Consulte "Actualización del firmware de la billetera de hardware OneKey" para obtener instrucciones de actualización.
Active y desactive el modo avión una vez. Esto restablecerá todos los módulos inalámbricos de su teléfono (Wi-Fi y Bluetooth).
Vaya a Configuración -> Privacidad y seguridad -> Bluetooth y asegúrese de que el interruptor para la aplicación OneKey esté Activado (verde).
Extensión de Chrome
Uso del método de conexión WebUSB
Cambio de Hardware Bridge a WebUSB
Compruebe si su dispositivo ha sido actualizado a la última versión del firmware. Consulte "Actualización del firmware de la billetera de hardware OneKey" para obtener instrucciones de actualización.
Abra la aplicación OneKey, vaya a Configuración > Red > Comunicación de hardware, y cambie el método de conexión a "WebUSB".
Nota: OneKey ha actualizado el Hardware Bridge a una conexión WebUSB directa, por lo que no se requiere instalación adicional.
¿Sigue teniendo problemas?
💁♀️ Si aún no puede conectar su billetera de hardware, haga clic en el botón circular de servicio al cliente en la esquina inferior derecha del sitio web para contactar a nuestro soporte en línea.







