跳转到主要内容

硬件钱包无法连接 OneKey App 解决方法

95% 遇到硬件钱包连接问题的用户都能通过以下方式顺利解决。

更新于昨天

请您按照当前使用平台、连接方式，按照指示步骤进行问题排查。

🌄 OneKey App 插件最新版本中，不再需要安装 OneKey Bridge 即可顺利完成硬件钱包连接，以往的 OneKey Bridge 连接方式已下线。

Windows

USB 连接排查

缺少硬件钱包的 USB 驱动程序

  1. 检查您的设备是否已经升级到最新的固件，升级流程参考「更新 OneKey 硬件钱包的固件」。

  2. 打开 Windows 系统的「设备管理器」，查看「通用串行总线控制器」中是否有 OneKey 名称开头的设备，如果出现有感叹号的情况按照下述方法升级 Windows 驱动。
    ​

解决方法

  1. 打开 https://zadig.akeo.ie/ 后点击「Zadig 2.9」下载安装包。
    ​

  2. 打开安装包后选择「WinUSB」安装。
    ​

    安装完成后重启电脑使其生效。

蓝牙连接排查

版本与权限检查

  1. 使用 OneKey App（5.12 或更高版本），您可以通过蓝牙连接硬件钱包与电脑。使用时，请确保 OneKey 硬件钱包也是最新的固件版本。升级流程参考「更新 OneKey 硬件钱包的固件」。

  2. 检查您的硬件钱包是否禁用了蓝牙。对于 OneKey Pro，请同时关闭 隔空签名（Air-Gap） 模式。 随后锁定您的硬件钱包并解锁 - 再次尝试蓝牙连接。

  3. 在「Settings」-「Preferences」确保 OneKey App 的蓝牙功能处于打开状态。
    ​

Note: 浏览器插件端未支持蓝牙连接，请使用 USB 的方式。

macOS

USB 连接排查

缺少 USB 配件连接的系统授权

检查您的设备是否已经升级到最新的固件，升级流程参考「更新 OneKey 硬件钱包的固件」。

  1. 在使用 USB-C 连接时，弹出的授权窗口点击「Allow」。
    ​

  2. 如果之前拒绝过导致连接时不弹出授权窗口的话，打开「System settings」-「Privacy & Security」-「Security」-「Accessories」更改为「Always ask」。此功能主要存在于使用 Apple 芯片（M1/M2/M3 等）的 MacBook 上。
    ​

蓝牙连接排查

版本与权限检查

  1. 使用 OneKey App（5.12 或更高版本），您可以通过蓝牙连接硬件钱包与电脑。使用时，请确保 OneKey 硬件钱包也是最新的固件版本。升级流程参考「更新 OneKey 硬件钱包的固件」。

  2. 检查您的硬件钱包是否禁用了蓝牙。对于 OneKey Pro，请同时关闭 隔空签名（Air-Gap） 模式。 随后锁定您的硬件钱包并解锁 - 再次尝试蓝牙连接。

  3. 在「Settings」-「Preferences」确保 OneKey App 的蓝牙功能处于打开状态。

Note: 浏览器插件端未支持蓝牙连接，请使用 USB 的方式。

Linux

USB 连接排查

未设置 udev 规则

  1. 检查您的设备是否已经升级到最新的固件，升级流程参考「更新 OneKey 硬件钱包的固件」。

  2. 前往 https://data.onekey.so/onekey.rules 复制 udev 规则。

  3. 在 /etc/udev/rules.d/99-onekey.rules 新建文件，并且将上述规则复制进去。

  4. 终端中输入：

    sudo udevadm control --reload-rules

Android

蓝牙连接排查

未开启权限

检查您的设备是否已经升级到最新的固件，升级流程参考「更新 OneKey 硬件钱包的固件」。

  1. 重启 OneKey App 和 OneKey 硬件设备并在「系统设置」处单独打开OneKey App的 GPS & 蓝牙权限。

Note: 如果钱包型号是 OneKey Pro 并开启了 AirGap 模式会导致硬件设备 USB 和蓝牙不可用，关闭后即可正常连接。

iOS

蓝牙连接排查

未开启权限

  1. 检查您的设备是否已经升级到最新的固件，升级流程参考「更新 OneKey 硬件钱包的固件」。

  2. 开关一次飞行模式，这会重置手机所有的无线电模块（Wi-Fi 和蓝牙）。

  3. 进入 「设置」 -> 「隐私与安全性」 -> 「蓝牙」，确保 OneKey App 开关是 开启 (绿色) 状态。

Chrome 插件版

正确使用 WebUSB 方式连接

从硬件通讯桥（Bridge）连接切换为 WebUSB

  1. 请确保 OneKey 硬件钱包是最新的固件版本。升级流程参考「更新 OneKey 硬件钱包的固件」。

  2. 打开 OneKey App 「Settings」-「Network」-「Hardware communication」将连接方式切换为「WebUSB」。

Note: 目前 OneKey 已将硬件通讯桥（Bridge）升级为了 WebUSB 直连的方式，无需额外安装。

问题未解决？

💁‍♀️ 如果依然无法连接硬件钱包，请点击网站右下角圆形客服按钮，联系我们的在线客服。

相关文章
在 OKX Web3 钱包上使用 OneKey 硬件钱包
固件升级页面无法识别硬件钱包的解决办法
验证 OneKey 硬件钱包的固件（防伪校验）
OneKey 硬件钱包设备固件的开源代码验证
OneKey App 桌面端支持蓝牙连接
这是否解答了您的问题？