新物先分清设备码与手机短信码
控制台登录时发到手机的短信验证码，用来验证账号。设备联网后通过语音或屏幕给出的六位码，用来关联这台硬件。两者可能都叫验证码，来源和填写位置却不同。
先问自己正在做什么：如果停在登录页，就按该页面完成账号登录；如果已经进入智能体的设备管理，再去读取设备给出的码。把短信码填进设备框，并不能完成设备关联。
| 要完成的动作 | 验证码来自哪里 | 填在哪里 |
|---|---|---|
| 登录自己的控制台账号 | 账号登录流程，例如手机短信 | 当前控制台登录页。 |
| 把尚未关联的硬件加入智能体 | 设备屏幕或语音提示 | 目标智能体的添加设备入口。 |
第 1 步：确认设备已经联网
手机能打开控制台，并不能证明桌上的设备也已联网。先确认设备完成了 Wi-Fi 配置，并给出对应联网结果。若它仍在提示配网，先回到热点配置，不要靠换一个账号来解决网络失败。
还要确认运行的是使用官方服务的固件。自建后端、改过服务地址或第三方定制产品，可能有自己的激活过程，不能保证把码填到官方控制台就能使用。
- 做到这里，你应该看到
- 有依据确认设备已完成联网，并知道它连接哪套服务。
第 2 步：按设备支持的方式读取提示
官方教程描述：尚未关联的设备联网后，通过支持的语音或按键方式唤醒，读取屏幕或听取提示中的六位码。不同固件的唤醒方式不同，不支持离线唤醒的方案不能只靠喊一句话测试。
没有听到码时，先判断是完全没有提示音，还是已有屏幕提示但声音缺失。前者还需检查联网与状态，后者可以先读取屏幕，同时单独排查功放和喇叭。没有屏幕时，音频输出是否正常就更关键。
- 做到这里，你应该看到
- 拿到这台设备当前明确给出的设备码，或知道还卡在哪个前置环节。
- 如果卡住了
- 不要给没有实际显示或播报的设备猜一个码；完全无声时先检查音频输出。
第 3 步：确认目标智能体，再添加设备
打开官方控制台并登录，确认当前账号与目标智能体。按官方历史流程，先有智能体，再从它的添加设备或设备管理入口提交设备码。图中是旧版空白对话框，用于解释填写对象，不代表当前界面的按钮位置。
提交后先核对列表和设备反馈，再进行一句简短对话。某个按钮点击后没有立即报错，不能单独作为完成关联的证明；要确认这台设备确实出现在正确智能体下。
- 做到这里，你应该看到
- 目标智能体里出现这台设备，并能继续进行使用验证。
码无效或设备已存在，按提示分开处理
提示码无效时，重新读取设备当前提示，核对数字、目标账号和服务；不要直接假定所有版本的码都有相同有效期。若提示已绑定、已存在或属于其他账号，先查当前设备管理与官方账号帮助，不要反复创建智能体碰运气。
向支持方说明问题时，可以提供板型、固件版本和错误文字。设备码与账号信息不必公开贴进求助截图。完成关联后，再单独验收麦克风输入和扬声器回答。
资料来源与版本说明
本文属于小智现成固件路线，按文末官方资料与固定源码复核。历史 Q&A 与旧界面仅用于其所注明的版本情境，具体动作再按固定源码与板型核对；当前控制台的登录后界面和实物操作尚未验证。资料核对日期：。资料核对、程序构建与实板测试分别记录，不互相替代。
飞书原文请在浏览器打开；如跳转到登录页，按飞书提示访问。历史截图的原图出处与当前工具入口分别标明。
