网站导航
> 技术文档 > ESP32 s3 + 小智后台（Xiaozhi Server） 打造专属AI语音助手！

ESP32 s3 + 小智后台（Xiaozhi Server） 打造专属AI语音助手！

网友: 技术文档 2025-07-30 13:48:18

💡 你是否想过：
花不到百元的硬件成本 + 一台轻量化服务器，就能拥有媲美商业产品的全本地化智能语音助手？
告别会员费、拒绝隐私泄露！今天教你用 ESP32 + 小智后台（Xiaozhi Server） 打造专属AI语音助手！

🔥 为什么选择「小智后台」？

✅ 超低成本：ESP32开发板仅需几十元
✅ 完全开源：代码透明，无后门风险
✅ 隐私无忧：所有数据本地运行，不上传云端
✅ 功能强大：语音唤醒/智能家居控制/视觉模型 ✅ 模块化部署：Docker一键安装，小白也能搞定！

🚀 极速部署教程（Docker-全模块安装版-ubuntu22.04）

同时解决docker网络拉取镜像慢的问题！

步骤1：一键部署xiaozhi-esp32-server

curl -L -o docker-setup.sh https://raw.githubusercontent.com/xinnan-tech/xiaozhi-esp32-server/main/docker-setup.sh

步骤2：下载好上面的自动化脚本后，执行以下命令来运行它

chmod +x docker-setup.sh---./docker-setup.sh

此时需要对配置文件进行修改，不用害怕，我会给出完整的网盘链接来供大家打开整个包

xiaozhi-server链接：

  • 说明1：其中的test文件
    → 是用于还没有硬件的同学，可以先尝试使用本地的地址来测试是否可以进行对话

  • 问题2：关于api-key
    → 需要到智谱AI开放平台获取，新用户会送很多，下文会说明具体地址

  • 问题3：其中的tar文件是docker的镜像文件

    → 针对网络不通畅的问题，可以直接导入镜像，无需等待

步骤3:启动xiaozhi-server

依次导入文件夹中的docker镜像docker load < xiaozhi-esp32-server-web_latest.tardocker load < xiaozhi-esp32-server-server_latest.tardocker load < redis-latest.tardocker load < mysql-latest.tar-----------------------------启动容器docker compose -f docker-compose_all.yml up -d查看日志docker logs -f xiaozhi-esp32-server-web当你看到输出日志时，说明你的智控台启动成功了2025-xx-xx 22:11:12.445 [main] INFO  c.a.d.s.b.a.DruidDataSourceAutoConfigure - Init DruidDataSource2025-xx-xx 21:28:53.873 [main] INFO  xiaozhi.AdminApplication - Started AdminApplication in 16.057 seconds (process running for 17.941)http://localhost:8002/xiaozhi/doc.html

步骤4:登录智控台-打开界面配置api-key

平台 登录小智控制台地址 127.0.0.1:8002

智谱AI开放平台:智谱AI开放平台

步骤5:登录智控台-参数管理配置

在顶部菜单找到参数管理，找到列表中第一条数据，参数编码是server.secret，复制它到参数值。server.secret需要说明一下，这个参数值很重要，作用是让我们的Server端连接manager-api。server.secret是每次从零部署manager模块时，会自动随机生成的密钥。复制参数值后，打开xiaozhi-server下的config.yaml文件manager-api:  url: http://xiaozhi-esp32-server-web:8002/xiaozhi  secret: 12345678-xxxx-xxxx-xxxx-123456789000  ---------------------- 再次打开顶部菜单找到参数管理找到并配置  OTA接口：http://你电脑局域网的ip:8003/xiaozhi/ota/  Websocket接口：ws://你电脑局域网的ip:8000/xiaozhi/v1/  --------  最后，很重要的一点：重启容器docker restart xiaozhi-esp32-server

步骤6:开始测试

使用文件夹中的test目录下双击test_page.html

配置连接信息ota和ws后点击连接即可快速测试

连接成功后，可选择语音输入或者文字输入来测试

步骤7:使用桌面机器人来实际测试效果

📣 立即行动！开源项目地址：https://github.com/xinnan-tech/xiaozhi-esp32-server
网络标签：

相关问题