为什么配对不上啊，一直提示配对码错误或已失效？？？ · 问答 · Hamibot 安卓自动化工具

配对失败可能有以下原因及解决办法：

配对码时效性问题

配对码生成后需在30秒内完成输入，超时后会自动失效

解决方案：点击「添加设备」重新获取新配对码，立即输入

输入格式错误

配对码区分大小写（如a和A不同）

包含特殊字符时需完整输入（如空格、下划线等）

解决方案：仔细核对配对码显示，逐字输入

设备状态异常

确保设备已开启无障碍服务（设置→应用管理→Hamibot→权限管理）

确保设备处于联网状态

尝试重启设备后重新配对

客户端配置问题

若使用定制客户端：检查是否启用了「自动配对设备」功能（文档3）

若使用标准客户端：确保未开启「自动配对」功能干扰

如果仍无法解决，可通过以下步骤排查：

在控制台点击「重新获取配对码」

同时长按设备音量键+电源键10秒强制重启设备

在5秒内完成配对码输入操作

补充回答 1

配对问题排查指南：

配对码有效性验证

生成后30秒内输入（超时自动失效）

确认控制台显示的配对码与输入的一致（建议截图核对）

尝试重新生成配对码（点击「重新获取」按钮）

设备端操作规范

确保无障碍服务已开启（路径：设置→应用管理→Hamibot→权限管理）

检查是否启用前台服务权限（路径：设置→应用管理→Hamibot→电池）

安装时使用的是官方客户端还是定制客户端（定制版需开启自动配对功能）

网络环境检测

确认设备连接的是4G/5G而非仅WiFi（部分企业WiFi有限制）

尝试切换网络后重启Hamibot服务

空间客户端配置

如果是定制客户端：检查生成时是否勾选「自动配对设备」

如果是官方客户端：确认未开启「秒配对」功能（设置→高级选项）

控制台日志检查

在控制台执行以下代码获取诊断信息：

// 文档地址 https://docs.hamibot.com/

var ws = require('workspaces');

toast("设备状态：" + JSON.stringify(ws.getDeviceStatus()));

若仍无法解决，请提供以下信息：

客户端版本号（设置→关于）

设备型号及系统版本

控制台显示的完整错误提示截图