设备激活与管理后台配置
设备完成 Wi-Fi 配网后还不能直接对话：按官方教程的说法，设备在 WI-FI 或 4G 联网后，需要到小智 AI 控制面板添加设备验证通过，才能正常使用设备进行 AI 语音聊天。按官方 README 的口径，固件默认接入 xiaozhi.me 官方服务器，拥有设备的个人用户登录 xiaozhi.me 控制台即可完成激活与后续配置。
本页步骤按官方教程《配置设备 Wi-Fi 和添加设备》第 2 节整理，官方教程为早期固件口径，当前固件以 v2.5.2 发布包为准，按钮位置以 xiaozhi.me 控制台实际界面为准。
- 唤醒设备听取验证码。请先确保设备已连接到互联网，通过「你好，小智」唤醒，设备会播报或显示要求添加设备的提示语 6 位设备验证码，可以重复唤醒重听。预期结果：喇叭播报或屏幕显示 6 位验证码。若没有听到语音播报、喇叭没有发声，面包板方案用户请检查功放和喇叭接线是否正常，第三方开发板用户请检查固件是否匹配且正常运行。
- 无离线唤醒的设备改用按键唤醒。如使用不带离线唤醒的设备，例如 ESP32-C3 系列开发板或产品，请使用按键唤醒设备进行通信，同样根据语音播报或屏幕显示的 6 位验证码，到控制面板添加设备。预期结果：按键唤醒后获取 6 位验证码。
- 登录控制面板。电脑浏览器访问小智 AI 控制面板后台 https://xiaozhi.me，如未注册请先注册账号。预期结果：成功进入控制面板并登录自己的账号。
- 新建智能体。在页面左侧导航下方点击「+新建智能体」，确定提交。预期结果：新建智能体完成后，出现在智能体列表中。
- 首次添加设备。请在智能体模块上选择「添加设备」按钮，点击进入「添加新设备」入口，输入提示语中告知的 6 位数字设备 ID，然后点击「添加设备」按钮。预期结果：页面接受设备 ID，无格式或重复报错。输入设备 ID 时以本次播报或显示的 6 位数字为准；如果提示不匹配，重复唤醒重听一遍最新验证码后再输入。
- 已添加过设备再添加新设备。请点击对应智能体模块下方「设备管理」进入设备列表页面，再通过右侧「+添加设备」按钮添加新设备。预期结果：新设备出现在该智能体的设备管理列表中。
- 确认自动激活。设备添加后将自动激活，并显示在「设备管理」列表页面上，就可以正常使用了。预期结果：列表中出现该设备，可唤醒对话。官方教程当时标注测试服务器暂时免费，当前额度以控制台当前说明为准。
一个智能体可以在多个设备终端中连接使用，例如放在家里的小智 AI 设备和放在公司的小智 AI 设备共用一个智能体，对应相同的 AI 角色和配置以及记忆体。官方教程对智能体的说明：小智 AI 智能体是物理实体（设备终端及固件）加虚拟实体（后台服务端）的结合体，目前主要用于 AI 聊天机器人、IOT 物联网设备控制、学习教育、智能助手等领域。
等待播报验证码时可对照 sRGB 状态灯：
| 灯色 | 含义 |
|---|---|
| 语音唤醒后蓝色亮起 | 正在连接服务器 |
| 红色亮起 | 正在录音 |
| 绿色亮起 | 正在播放语音 |
| 通电后蓝色一直闪烁 | 设备还处于配网状态，需要先完成配网再谈激活 |
| 蓝色保持长亮 | 正在进行 OTA 固件更新，网络好的情况下通常一分钟内完成，等待即可 |
激活完成后，设备即可进入第一次对话验证，见「第一次对话与验证」一页。
登记设备之外，管理后台还提供以下配置项。这些条目均来自官方早期 Q&A 口径，当前以 xiaozhi.me 控制台实际界面为准。
- 切换角色大模型：官方早期 Q&A（Q14）列出已支持 Qwen 2.5（实时）、DeepSeek V3、DouBao 1.5 Pro、Qwen Max 2.5，操作为登录小智 AI 管理后台控制面板，在控制台/设备管理/配置角色页面切换 AI 角色大模型。
- 修改角色名称：按官方早期 Q&A（Q20），到管理后台控制面板的角色配置中修改 AI 角色的名字并保存，下次对话他就知道自己叫什么名字了。注意：角色名字与离线唤醒词是两回事——角色名字只是大模型配置的智能体角色的名字，和离线唤醒词不存在关联，改角色名不会改变唤醒词；「你好小智 / nihaoxiaozhi」离线唤醒词需要到乐鑫官方定制，设备唤醒词没有更换的话还是默认唤醒词（官方文档对默认唤醒词的口径存在冲突，以设备实机首次播报或屏幕提示为准，详见「第一次对话与验证」一页）。
- 更换音色：按官方早期 Q&A（Q21），到网站控制台的配置角色中切换角色声音，可以先试听一下，然后提交保存配置，下次对话就会切换配置好的音色。
- 声纹识别添加说话人：按官方早期 Q&A（Q22），到网站后台控制台的智能体中找到声纹识别弹层，在声纹向量下拉中选择一段语音记录（建议适当长一点、表述较为清楚的），填写名称和描述（对话人和角色的关系，例如我是 xx，是小智的主人、好朋友或英语老师），点击 OK 按钮添加说话人，在声纹识别页面列表就可以看到，可以添加多个。重新唤醒小智 AI 终端，下次对话中询问角色，他/她就知道你是谁。边界：受限技术框架和硬件实现效果，不能 100% 识别；另外说话人越多，分辨的准确率会下降。