零代码快速上手：小智ESP32智能语音设备固件配置指南

副标题：适用于小智ESP32系列设备（固件版本1.6.1及以上）

准备工作（15%）

在开始配置前，请确保您已完成以下准备：

硬件兼容性检测

设备型号	最低固件版本	支持特性
小智ESP32标准版	1.6.1	基础语音交互、OTA升级
小智ESP32 Pro版	1.7.0	多麦克风阵列、本地唤醒
小智ESP32 Mini版	1.8.0	低功耗模式、离线指令

🔧 检查设备固件版本：开机后观察设备指示灯，蓝色闪烁3次表示版本1.6.x，绿色闪烁3次表示版本1.7.x及以上。

软件环境准备

• 已安装管理员权限的智控台（main/manager-web/）
• 可用的OTA服务器地址
• 稳定的2.4GHz Wi-Fi网络（不支持5GHz）
• 电脑或手机（用于配置操作）

⚠️ 重要提示：确保服务器满足最低配置要求：2核CPU、4GB内存、10GB可用存储空间。

💡 专家提示：建议使用有线网络连接服务器，以确保设备通信稳定性。

核心配置（40%）

OTA地址配置

OTA（Over-The-Air，空中下载技术）地址是设备与服务器通信的关键配置项。

新旧地址格式对比

格式类型	示例地址	适用版本	特点
旧格式	http://ip:port/ota	1.6.1-1.7.0	仅支持基础升级功能
新格式	wss://domain.com/xiaozhi/v1/	1.7.1+	支持双向通信、实时指令

🔧 配置步骤：

1. 进入设备配网模式（长按设备按键5秒，指示灯变为橙色闪烁）
2. 手机连接设备热点（名称以"Xiaozhi-"开头）
3. 在配网页面点击"高级选项"
4. 输入OTA地址（新格式推荐）
5. 保存并重启设备

图1：设备高级选项配置界面，红框标注为关键操作区域

服务器环境配置

下图展示了小智服务器的两种部署架构，根据您的需求选择合适的方案：

图2：简化部署架构 - 适用于个人用户和小型场景

图3：完整部署架构 - 适用于多设备和高级功能场景

🔧 服务器配置步骤：

1. 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/xia/xiaozhi-esp32-server
2. 进入项目目录：cd xiaozhi-esp32-server
3. 运行部署脚本：bash docker-setup.sh
4. 等待部署完成（约5-10分钟）
5. 验证服务状态：访问http://服务器IP:8000，显示"服务运行正常"

配置备份与恢复

为防止配置丢失，建议定期备份系统配置：

🔧 备份配置：

1. 登录智控台
2. 进入"系统设置" → "配置管理"
3. 点击"导出配置"按钮
4. 保存生成的config_backup.json文件

🔧 恢复配置：

1. 在相同页面点击"导入配置"
2. 选择之前保存的config_backup.json文件
3. 点击"恢复"并重启服务

💡 专家提示：建议每周备份一次配置文件，重大变更前额外备份。

功能验证（15%）

完成配置后，请按以下步骤验证设备功能：

基础功能测试

1. 唤醒设备：说出唤醒词"小智小智"，设备应回应"我在"
2. 基础指令测试：
   • 说"现在时间"，设备应播报当前时间
   • 说"讲个笑话"，设备应播放一则笑话
   • 说"天气怎么样"，设备应播报当地天气

高级功能测试

功能	测试指令	预期结果
语音识别	"明天会下雨吗"	正确识别并回答天气问题
智能家居控制	"打开客厅灯"	如已配置，对应设备应响应
语音克隆	"使用我的声音回复"	切换为用户自定义语音

⚠️ 橙色警告：如果设备无响应，请检查服务器是否正常运行及网络连接是否通畅。

💡 专家提示：测试时尽量在安静环境下进行，背景噪音会影响语音识别准确率。

问题解决（20%）

故障排查树

设备连接问题
├── 无法进入配网模式
│   ├── 按键故障 → 联系售后
│   ├── 固件损坏 → 手动烧录固件
│   └── 电量不足 → 充电后重试
├── 配网成功但无法连接服务器
│   ├── OTA地址错误 → 检查格式和端口
│   ├── 网络防火墙 → 开放8000/8002端口
│   └── 服务器未启动 → 重启服务器
└── 连接不稳定
    ├── Wi-Fi信号弱 → 靠近路由器
    ├── 信道干扰 → 更换路由器信道
    └── 服务器负载高 → 优化服务器配置

常见配置错误对比表

错误类型	错误配置	正确配置	症状
地址格式错误	http://192.168.1.100	wss://192.168.1.100:8002/xiaozhi/v1/	设备在线但无响应
端口错误	wss://domain.com:8080/	wss://domain.com:8002/	连接超时
协议错误	http://domain.com/	wss://domain.com/	设备反复连接断开

服务器环境检测工具

推荐使用以下工具检查服务器状态：

1. 服务状态检查：docker-compose ps
2. 端口占用检查：netstat -tuln | grep 8000
3. 日志查看：docker-compose logs -f xiaozhi-server

💡 专家提示：大部分连接问题可通过重启服务器解决：docker-compose restart

高级玩法（10%）

用户案例分析

案例1：家庭智能控制中心

配置要点：

• 使用完整部署架构
• 集成智能家居控制插件
• 配置场景模式（如"回家模式"自动开灯、开空调）

效果：通过语音指令控制家中所有智能设备，响应时间<1秒。

案例2：企业客服助手

配置要点：

• 部署多服务器负载均衡
• 自定义唤醒词和回复语
• 集成知识库插件

效果：7x24小时自动应答常见问题，准确率达92%。

案例3：离线语音助手

配置要点：

• 启用本地ASR/TTS引擎
• 配置离线指令集
• 关闭云同步功能

效果：无网络环境下仍可响应基础指令，保护隐私。

功能扩展建议

1. 自定义唤醒词：在智控台"语音设置"中可修改唤醒词
2. 语音克隆：上传5句以上语音样本训练个人语音模型
3. 定时任务：设置设备在特定时间执行指定指令

💡 专家提示：高级功能可能需要更高配置的服务器支持，建议至少4核CPU和8GB内存。