做第一台小智 / 入门指南发布 内容更新

ESP32 是什么?先看懂你要做的小智 AI

用一台会聊天的小装置认识开发板、固件与智能体,再选适合自己的成品或面包板路线。第一次做小智,可以从现成固件开始。

读完能做什么
分清板子、固件、智能体的作用,找到适合自己的第一步。
开始之前
不用先会编程;准备动手时,再按所选方案购买硬件。
版本组合
小智参考固件:v2.5.2;源码 49b4380b3faa0ceadd28a3e78aaf0f311c46c57e硬件范围:官方历史 S3 / N16R8 面包板参考方案;具体适用条件见正文
适用范围

以小智官方教程的 Wi-Fi 入门路线为例,先完成一次语音对话。

这篇验证到了哪一步

资料核对已通过
2026-10-18 对照文末官方资料与 v2.5.2 固定源码;复核范围和访问限制见 docs/esp32-evidence/originals-review.md。版本:小智 v2.5.2 / 49b4380验证日期:
构建 / 配置不适用
本文使用上游发布的现成固件或解释方案,未提供本站固件构建。
仿真不适用
无线和音频行为不以仿真代替实物测试。
本站实板待验证
尚未完成本站实板验证。

构建通过只说明指定环境中的代码或配置通过检查;实物功能、功耗和稳定性以对应的实板记录为准。

01 / 入门指南

先想象终点:按一下,就能聊一句

你说“讲一个关于月亮的小故事”,桌上的小装置听到声音,联网获取回答,再通过喇叭讲给你听。小智 AI 就是一个可以用来学习这种交互的开源项目。ESP32 开发板负责连接麦克风、扬声器等硬件,并运行设备程序。

本系列把第一次制作的目标定得很具体:让自己的设备完成一问一答。屏幕表情、摄像头、外壳和联网工具,可以在这个目标完成后再加。

参考:[1] 小智官方教程总入口:百科全书[2] 小智 AI 原仓库:支持板型与项目说明

02 / 入门指南

先分清三件东西,后面就不容易绕晕

从外观上看,你可能只看到一块板子;真正能聊天的系统,还包括写进板子的程序和网络上的服务。

名称你会在哪一步遇到它负责什么
开发板选硬件、连接电脑、接麦克风和功放运行设备程序,收集声音并控制外设。
固件下载、解压、刷入 .bin 文件告诉板子怎样使用它的屏幕、按键和音频电路。
智能体登录小智控制台、添加设备管理角色和对话配置;联网的物理设备需要关联到它。

参考:[2] 小智 AI 原仓库:支持板型与项目说明[3] 官方教程:Wi-Fi 配置与添加设备

03 / 入门指南

你可以从成品开始,也可以自己接线

如果你想先体验对话,选择官方已适配、带麦克风和扬声器的整机或开发板,按厂家说明使用。已经刷好小智固件的设备,通常可以从配网和激活开始。

如果你想弄清硬件怎么组成,再走面包板 DIY:把开发板、麦克风、功放和喇叭按指定图纸连接起来。后面的硬件清单会明确限定参考方案,避免把不同板子的教程混用。

做到这里,你应该看到
你能说清楚自己走“已有设备”还是“面包板组装”,并找到对应型号的说明。

参考:[1] 小智官方教程总入口:百科全书[2] 小智 AI 原仓库:支持板型与项目说明

04 / 入门指南

做第一台小智,按三个阶段走

官方入门资料提供了使用现成固件的做法。跟着这条路线操作时,可以先不搭建 ESP-IDF,也不用先完成 Arduino 编程练习。

  1. 准备:确认板型、存储配置和外设;自己组装时,按对应接线图逐根核对。
  2. 刷机:下载匹配的 Wi-Fi 固件,用烧录工具写入开发板,确认程序能够启动。
  3. 使用:给设备配置家中的 Wi-Fi,在小智控制台创建智能体、添加设备,再测试对话。
做到这里,你应该看到
每个阶段都找到一个能确认的结果:硬件对应、固件启动、设备完成对话。

参考:[1] 小智官方教程总入口:百科全书[3] 官方教程:Wi-Fi 配置与添加设备[4] 官方教程:Flash 工具与 Web 烧录

05 / 入门指南

会聊天之后,再看懂声音去了哪里

在常见的联网方案中,设备采集和播放声音,后端参与语音识别、语言模型和语音合成。项目也支持实时语音模型等处理方式,实际分工由固件和服务配置决定。

“支持离线唤醒”表示设备能在本地识别指定唤醒方式,不能据此推断整段对话也能离线运行。先用官方支持的方案完成第一次对话,再研究自己的扩展方向会更容易。

参考:[2] 小智 AI 原仓库:支持板型与项目说明

06 / 入门指南

想自己写程序,换到另一条起点

这篇保留现成小智固件的一问一答路线。如果你的目标是传感器、按键或自己的程序,先按任务选择芯片和开发路线,再安装对应环境。Arduino 练习采用的 N8R8 v1.1 板卡与这里的小智 N16R8 参考组合分别记录,不混用板级设置。

参考:[2] 小智 AI 原仓库:支持板型与项目说明

BACK TO THE SOURCE

资料来源与版本说明

本文属于小智现成固件路线,按文末官方资料与固定源码复核。历史 Q&A 与旧界面仅用于其所注明的版本情境,具体动作再按固定源码与板型核对;当前控制台的登录后界面和实物操作尚未验证。资料核对日期:。资料核对、程序构建与实板测试分别记录,不互相替代。

飞书原文请在浏览器打开;如跳转到登录页,按飞书提示访问。历史截图的原图出处与当前工具入口分别标明。

  1. 小智官方教程总入口:百科全书
  2. 小智 AI 原仓库:支持板型与项目说明
  3. 官方教程:Wi-Fi 配置与添加设备
  4. 官方教程:Flash 工具与 Web 烧录