设备显示“未识别”本质是Gateway未完成配对，需逐层验证：确认设备进入pairing态、Gateway允许配对、网络协议一致，并清空残留记录后重配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
设备在 Aionclaw 中显示“未识别”，本质是 Gateway 没有完成对该设备的身份确认（pairing），不是设备没开机、没联网这种基础层问题，而是配对流程卡在了中间环节。直接重装或重启通常无效，得按 pairing 状态逐层验证。
确认设备是否已进入 pairing 等待态
Aionclaw 的设备识别依赖显式配对动作，不是即插即用。原生节点（Android/iOS/macOS App）必须主动触发一次配对请求，浏览器 Control UI 则需先打开 http://127.0.0.1:18789 并点击「Connect Device」或扫码；若只是后台运行 App 或开着旧标签页，Gateway 根本收不到 pairing 请求。
- Android/iOS：打开 Aionclaw App → 点击右上角「+」→ 选「Scan QR Code」或「Enter Setup Code」，确保弹出扫描界面或输入框
- macOS 原生节点：检查菜单栏图标是否为蓝色（已连接态）还是灰色（未连接/未配对）；灰色时右键点图标 → 「Pair with Gateway」
- Control UI 浏览器：不要复用旧 tab，新开无痕窗口访问
http://127.0.0.1:18789，页面加载完成后手动点「Connect」按钮 - 配对过程中，Gateway 日志应立刻出现类似
pairing required或client=node, mode=pairing的日志行；没有则说明设备根本没发请求
检查 Gateway 是否接受 pairing 请求
Gateway 默认只允许一次有效 pairing，且受配置项 gateway.pairing.enabled 和 gateway.pairing.timeout 控制。如果之前失败过、超时过，或配置被关掉，新设备就永远卡在“未识别”。
- 运行
openclaw gateway status --json，检查输出中"pairing": {"enabled": true, "timeout": 300}是否存在且值合理 - 若
enabled为false，需编辑配置文件（通常是~/.aionclaw/config.yaml），将gateway.pairing.enabled: true设为 true，再执行openclaw gateway restart - 若刚试过配对但失败，等待满
timeout秒（默认 5 分钟）再重试；提前重试会因 nonce 失效被拒 - 配对成功后，
openclaw devices list应返回非空列表，含设备 ID、role、status 字段；空列表 = pairing 未完成
验证设备与 Gateway 的网络和协议一致性
设备“未识别”常因底层通信被拦截或错配。Aionclaw 要求设备与 Gateway 必须走同一网络平面，且协议版本匹配——HTTP 不能连要求 HTTPS 的 Gateway，反之亦然。
- 设备端查看连接地址：App 设置里填的 Gateway URL 必须和
openclaw gateway status输出的dashboard_url完全一致（包括http://或https://、端口、末尾斜杠） - 若 Gateway 配置了
gateway.tls.enabled: true，设备必须用https://地址，且证书需被系统信任；自签名证书会导致连接静默失败，设备端无提示但 Gateway 日志有tls handshake error - macOS/Windows 上用
curl -v http://127.0.0.1:18789/api/v1/ping测试通路；若返回 401 或空响应，说明认证或路由异常，不是设备问题 - 手机连 Wi-Fi 时，确认和 Gateway 主机在同一局域网；手机用蜂窝网络 + 4G 共享热点给电脑，再让电脑跑 Gateway —— 这种链路多数被设备防火墙或 NAT 阻断，无法 pairing
真正卡住的地方往往在 pairing timeout 之后的状态残留：Gateway 认为“已拒绝该设备”，但设备端还留着旧的 setup code 缓存，双方都以为对方在等自己。此时最稳的做法是先 openclaw devices remove --all 清空所有设备记录，再重启 Gateway，最后从设备端重新发起完整配对流程——跳过任何“继续上次”的快捷入口。
