About This Site

This is an unofficial, community-maintained site. It is not affiliated with the XiaoZhi open-source project or its official services. For firmware and source code, refer to 78/xiaozhi-esp32 on GitHub (MIT License).

What You Will Find Here

XiaoZhi is open-source AI voice-robot firmware for the ESP32 family. This site follows the upstream source code, documentation, and releases, and turns them into developer guides:

Flash and use: Firmware download, Network setup, FAQ
Develop and adapt: ESP-IDF setup, Custom board guide
Protocols: WebSocket, MQTT + UDP, MCP
Articles: Blog

Content Principles

Facts follow the upstream source code and official releases, with the applicable version noted. The pages currently track firmware v2.5.x and ESP-IDF 6.
Code samples and commands come from the upstream repository and are not invented here.
Information about third-party services and hardware follows their own official documentation; this site makes no performance promises.

Contact and Feedback

If you spot an error or outdated content, email us: [email protected]