智 - ESP32 是当前发展最快的 AI 项目之一支持通过硬件终端与大语言模型LLM交互可实现语音指令控制硬件等功能自推出以来在物联网领域收获了极高的关注度与普及度。MicroPython 是嵌入式领域广为人知的开发语言允许开发者使用 Python 开展嵌入式系统开发。新手开发者无需跨越传统 C 的学习门槛就能借助网络上丰富的 MicroPython 库与社区支持快速开启裸机开发实践。该项目团队认为将这些成熟技术整合到一起让普通开发者拥有定制化 AI 助手将不再是遥不可及的设想。项目概述下图为 W55MH32L_EVB MCP 聊天机器人的硬件连接示意图2.jpegimage.png如示意图所示扬声器与麦克风共用同一组 I2S 连接。开发板默认处于扬声器播放模式当用户按住录音按钮时设备会切换为麦克风采集模式。用户需为开发板接入互联网并运行对应脚本方可连接至 AI 服务器。操作时需将路由器的以太网线缆接入开发板网口同时通过 USB 端口将开发板与电脑相连。脚本启动后程序会提示用户按下开始按钮发起连接。按键后设备将启动与服务器的通信链路用户即可与小智 AI 进行交互当终端进入消息输入状态时用户也可切换至麦克风模式通过语音与智能体对话。3.gifimage.png硬件组件与连接本节将讨论聊天机器人所需的组件以及如何将它们连接在一起。主板及外设搭建这套聊天机器人需要准备以下物料W55MH32Q_EVB购买链接/ W55MH32L_EVB购买链接I2S 接口 MAX98357A 放大器及配套扬声器INMP441 麦克风模块1 枚 10K 电阻两枚按键开关后续官方网站将上线完整的组件套装方便用户一站式采购。布线指南接线先从 I2S 音频组件开始image.pngimage.pngimage.png完成芯片端接线后将扬声器接入 I2S 放大器的输出image.png按键与 MCU 的连接可选用任意可用的 GPIO 引脚两个按键分别承担两个功能启动网络连接开启录音采集在该项目的官方实现中开发团队选用 PB9 引脚作为开始按键PB8 引脚作为录音按键。image.png最后将开发板与电脑相连同时把开发板直连至路由器。image.png若使用 W55MH32L_EVB 型号需将板卡右侧的端口连接至电脑。image.png软件配置与定制安装部署用户首先需前往 W55MH32 MicroPython 文档站点为开发板刷入最新版本固件并准备好 Thonny IDE 开发环境。随后访问项目的 GitHub 仓库将代码克隆至本地电脑git clone https://github.com/wiznethk-git/w55mh32_xiaozhi_mcp_chat_bot.gitimage.png打开项目文件所在文件夹通过 Thonny IDE 或任意兼容 MicroPython 的开发工具将除 default_config.py 外的全部文件上传至开发板 MCU。image.png参数配置用户可参考 default_config.py 中的模板修改配置项编辑完成后将文件另存为 config.py 并上传至 MCU。import uuidclient_id uuid.uuid4()secret {‘Client-Id’:client_id}config {# General‘is_secure’: False,‘async_timeout’: 10,# I2S I2S_ENABLED: True, # Websocket Specific ws_delay_ms: 0, # MCP mcp_enabled: True, # OTA Specific board_type:YOUR_BOARD_TYPE, # MQTT MQTT_USERNAME: MQTT_USERNAME, MQTT_PASSWORD: MQTT_PASSWORD, MQTT_IP:MQTT_HOST, MQTT_ENABLED:True, # Button Pins START_BUTTON:PB9, RECORD_BUTTON:PB8,}用户可根据自身设备需求将 I2S、MCP 与 MQTT 开关设置为开启或关闭项目开发团队建议保持 MCP 与 MQTT 开启以获得完整的功能体验若需要收听服务器返回的语音内容则需启用 I2S 功能。以太网连接设备默认采用 DHCP 动态寻址方案将开发板接入路由器后即可自动联网。若网络连接失败用户可查询当前网络的详细参数在 setup.py 文件头部修改配置切换为静态 IP 模式。静态 IP 的具体配置方法可参考官方提供的参考脚本页面。MCP 工具扩展若要为板卡添加或移除 MCP 工具需完成两步操作为对应的 MCP 工具创建带参数的功能函数格式如下def func_name(self, device, args): …在 mcp.py 的初始化逻辑中注册 MCPTool 对象。用户可参考官方文档了解 MCP 协议的运行机制。image.pngMQTT 功能配置若要在对应服务器上使用 MQTT 功能需完成以下配置在官方 AIOT 平台注册一个数据源对应的 MQTT 主题路径为「账户名称 / 数据源标题」。打开 mqttHandler 文件将对应主题路径添加至装饰器中并编写回调函数实现接收主题更新后的业务逻辑。image.png其他说明若要为 W55MH32EVB 开发板添加自定义功能可在 config.py 中关闭 MQTT 或 MCP 功能避免板载内存不足引发运行错误。如果用户想了解 MCU 与服务器之间的通信原理可查阅 xiaozhi-esp32 项目的文档目录或访问小智 AI 聊天机器人百科了解服务器与终端机器人的完整运行机制。网站端配置image.png正式使用 AI 助手前用户需要在官方网站完成设备注册。首先准备好开发板终端登录项目官方网站。image.png
W55MH32 开发板 + 小智 AI实现以太网版本的小智机器人
发布时间：2026/7/10 21:11:19
智 - ESP32 是当前发展最快的 AI 项目之一支持通过硬件终端与大语言模型LLM交互可实现语音指令控制硬件等功能自推出以来在物联网领域收获了极高的关注度与普及度。MicroPython 是嵌入式领域广为人知的开发语言允许开发者使用 Python 开展嵌入式系统开发。新手开发者无需跨越传统 C 的学习门槛就能借助网络上丰富的 MicroPython 库与社区支持快速开启裸机开发实践。该项目团队认为将这些成熟技术整合到一起让普通开发者拥有定制化 AI 助手将不再是遥不可及的设想。项目概述下图为 W55MH32L_EVB MCP 聊天机器人的硬件连接示意图2.jpegimage.png如示意图所示扬声器与麦克风共用同一组 I2S 连接。开发板默认处于扬声器播放模式当用户按住录音按钮时设备会切换为麦克风采集模式。用户需为开发板接入互联网并运行对应脚本方可连接至 AI 服务器。操作时需将路由器的以太网线缆接入开发板网口同时通过 USB 端口将开发板与电脑相连。脚本启动后程序会提示用户按下开始按钮发起连接。按键后设备将启动与服务器的通信链路用户即可与小智 AI 进行交互当终端进入消息输入状态时用户也可切换至麦克风模式通过语音与智能体对话。3.gifimage.png硬件组件与连接本节将讨论聊天机器人所需的组件以及如何将它们连接在一起。主板及外设搭建这套聊天机器人需要准备以下物料W55MH32Q_EVB购买链接/ W55MH32L_EVB购买链接I2S 接口 MAX98357A 放大器及配套扬声器INMP441 麦克风模块1 枚 10K 电阻两枚按键开关后续官方网站将上线完整的组件套装方便用户一站式采购。布线指南接线先从 I2S 音频组件开始image.pngimage.pngimage.png完成芯片端接线后将扬声器接入 I2S 放大器的输出image.png按键与 MCU 的连接可选用任意可用的 GPIO 引脚两个按键分别承担两个功能启动网络连接开启录音采集在该项目的官方实现中开发团队选用 PB9 引脚作为开始按键PB8 引脚作为录音按键。image.png最后将开发板与电脑相连同时把开发板直连至路由器。image.png若使用 W55MH32L_EVB 型号需将板卡右侧的端口连接至电脑。image.png软件配置与定制安装部署用户首先需前往 W55MH32 MicroPython 文档站点为开发板刷入最新版本固件并准备好 Thonny IDE 开发环境。随后访问项目的 GitHub 仓库将代码克隆至本地电脑git clone https://github.com/wiznethk-git/w55mh32_xiaozhi_mcp_chat_bot.gitimage.png打开项目文件所在文件夹通过 Thonny IDE 或任意兼容 MicroPython 的开发工具将除 default_config.py 外的全部文件上传至开发板 MCU。image.png参数配置用户可参考 default_config.py 中的模板修改配置项编辑完成后将文件另存为 config.py 并上传至 MCU。import uuidclient_id uuid.uuid4()secret {‘Client-Id’:client_id}config {# General‘is_secure’: False,‘async_timeout’: 10,# I2S I2S_ENABLED: True, # Websocket Specific ws_delay_ms: 0, # MCP mcp_enabled: True, # OTA Specific board_type:YOUR_BOARD_TYPE, # MQTT MQTT_USERNAME: MQTT_USERNAME, MQTT_PASSWORD: MQTT_PASSWORD, MQTT_IP:MQTT_HOST, MQTT_ENABLED:True, # Button Pins START_BUTTON:PB9, RECORD_BUTTON:PB8,}用户可根据自身设备需求将 I2S、MCP 与 MQTT 开关设置为开启或关闭项目开发团队建议保持 MCP 与 MQTT 开启以获得完整的功能体验若需要收听服务器返回的语音内容则需启用 I2S 功能。以太网连接设备默认采用 DHCP 动态寻址方案将开发板接入路由器后即可自动联网。若网络连接失败用户可查询当前网络的详细参数在 setup.py 文件头部修改配置切换为静态 IP 模式。静态 IP 的具体配置方法可参考官方提供的参考脚本页面。MCP 工具扩展若要为板卡添加或移除 MCP 工具需完成两步操作为对应的 MCP 工具创建带参数的功能函数格式如下def func_name(self, device, args): …在 mcp.py 的初始化逻辑中注册 MCPTool 对象。用户可参考官方文档了解 MCP 协议的运行机制。image.pngMQTT 功能配置若要在对应服务器上使用 MQTT 功能需完成以下配置在官方 AIOT 平台注册一个数据源对应的 MQTT 主题路径为「账户名称 / 数据源标题」。打开 mqttHandler 文件将对应主题路径添加至装饰器中并编写回调函数实现接收主题更新后的业务逻辑。image.png其他说明若要为 W55MH32EVB 开发板添加自定义功能可在 config.py 中关闭 MQTT 或 MCP 功能避免板载内存不足引发运行错误。如果用户想了解 MCU 与服务器之间的通信原理可查阅 xiaozhi-esp32 项目的文档目录或访问小智 AI 聊天机器人百科了解服务器与终端机器人的完整运行机制。网站端配置image.png正式使用 AI 助手前用户需要在官方网站完成设备注册。首先准备好开发板终端登录项目官方网站。image.png
）、include伪协议利用（data://、php:/）、请求和返回的base64编码绕过)
