适用产品：全系 XGO（mini2S / lite3 / Rider2 / mini2SW，CM4 / CM5 全覆盖）
XGO 系列系统镜像可通过以下两种方式烧录：使用 Luwu Imager 自动下载并写入镜像，或从 GitHub Releases 下载镜像后使用 balenaEtcher 写入 SD 卡。
烧录前请注意：烧录会清空目标 SD 卡上的全部数据，请先备份需要保留的文件。选择目标设备时，务必核对 SD 卡的名称和容量，避免误选电脑硬盘或其他存储设备。
方式一：使用 Luwu Imager 烧录
Luwu Imager 版本：v1.2.0（与 latest 软链一致）
下载入口
Windows：LuwuImager-Setup-latest.exe
macOS：LuwuImager-Setup-latest.dmg
使用步骤
安装并打开 Luwu Imager → 选择机型 → 工具自动下载系统镜像 → 插入 SD 卡烧录。
方式二：使用 balenaEtcher 烧录
适合需要手动下载、保存系统镜像，或已下载好镜像的用户。balenaEtcher 提供 Windows、macOS 和 Linux 版本。
下载工具与系统镜像
- 烧录工具：balenaEtcher 官网，下载适合电脑操作系统的版本并安装。
- 系统镜像：Luwu-OS Releases 镜像下载，查看版本说明，在所需版本的 Assets 中下载
.img.gz系统镜像，并确认镜像适用于设备的硬件版本。
请选择系统镜像文件，不要选择 Source code (zip) 或 Source code (tar.gz) 源码包，也不要将 Luwu Imager 的 .exe / .dmg 安装包当作系统镜像。balenaEtcher 支持直接写入 .img.gz，无需提前解压；也可选择解压后的 .img 文件。
烧录步骤
- 连接 SD 卡：将机器人关机并断开电源，取出 SD 卡，通过读卡器连接电脑。确认已备份卡内数据。
- 选择镜像：打开 balenaEtcher，点击 Flash from file（从文件烧录），选择下载完成的
.img.gz或.img文件。 - 选择目标：点击 Select target（选择目标），根据名称和容量选中要烧录的 SD 卡并确认。SD 卡容量需能容纳完整镜像，不能仅按压缩包大小判断。
- 开始写入：再次核对镜像和目标 SD 卡，点击 Flash!（烧录），按系统提示授予写入权限。
- 等待校验：等待写入和校验（Validating）全部完成，期间不要拔出 SD 卡或关闭程序。确认显示烧录成功后，再安全移除 SD 卡。
- 装回并启动：在机器人断电状态下装回 SD 卡，再接通电源开机，等待系统启动。
常见问题排查
- 烧录卡顿或校验失败：确认镜像下载完整，检查 SD 卡是否写保护，并尝试更换读卡器、USB 接口或 SD 卡后重新烧录。
- 提示目标容量不足：使用能够容纳完整镜像的 SD 卡，压缩包大小不代表烧录所需容量。
- Windows 提示需要格式化磁盘：烧录后如出现此提示，请点击取消，不要格式化，以免破坏刚写入的系统分区。
- 需要单独下载镜像或历史版本：前往 Luwu-OS Releases，以各版本实际提供的附件和说明为准。