XiaoZhi DocsYour first conversation. Your own AI device.

Build, flash, configure, and explore what your device can do.

Get started

Development guide

Getting started

Find a path from powering on your device to your first conversation.

Explore

Hardware & wiring

Choose a board and connect microphones, speakers, displays, and other components.

Explore

Firmware & flashing

Select firmware for your device, then flash, upgrade, or build it online.

Explore

Console guide

Configure agents, voices, knowledge bases, and devices in the XiaoZhi console.

Explore

MCP & integrations

Connect tools to agents for information lookup and device control.

Explore

Development

Set up a development environment, modify firmware, and support your own hardware.

Explore

Protocols & reference

Look up communication protocols, interfaces, and version compatibility.

Explore

Troubleshooting

Find troubleshooting steps by symptom and resolve problems that block everyday use.

Explore

Community

Explore community projects and help improve guides, translations, and hardware coverage.

Explore

Documentation is being rebuilt

Existing tutorials are being reviewed and rewritten. Section pages show their preparation status as verified guides become available in Chinese and English.