Pi 5 一键装机工作区

空白卡入口

如果你的 Pi 5 还没装完系统，现在仓库里已经有可执行的 bootfs 种子脚本：

cp host_tools/pi5_zero_touch.env.example .pi5_zero_touch.env
$EDITOR .pi5_zero_touch.env
set -a
source ./.pi5_zero_touch.env
set +a
./host_tools/pi5_zero_touch_seed.sh --bootfs "$BOOTFS_PATH" --password "$BOOTSTRAP_PASSWORD"

它会把 `userconf.txt`、`ssh`、`firstrun.sh` 和 `lelamp-bootstrap.service` 的首启自举链直接种进 boot 分区。

Pi 上一句话入口

如果系统已经起来，或者你要手工重跑 bring-up，入口还是这一条：

cd ~/lelamp_runtime
chmod +x scripts/pi5_all_in_one.sh
./scripts/pi5_all_in_one.sh

这个入口会负责环境变量、LeLamp runtime、ReSpeaker 路径选择、可选 OpenClaw、可选 systemd 服务，以及重启后的收尾检查。

自动检测缺了什么、装了什么

仓库内置了一个 doctor 脚本，专门用来审计当前机器状态：

cd ~/lelamp_runtime
./scripts/lelamp_doctor.sh

它会检查命令依赖、`.env` 关键项、音频设备、串口设备、systemd 服务和 OpenClaw skill 是否就位。

当前默认模型配置已经切到 `GLM Realtime`，仓库标准键是 `MODEL_PROVIDER / MODEL_API_KEY / MODEL_BASE_URL / MODEL_NAME / MODEL_VOICE`。

仓库里有什么

安装后的预期结果

1. 系统依赖装齐
2. LeLamp runtime 环境准备完成
3. `.env` 写好基础参数
4. ReSpeaker 走安全路径配置
5. 可选安装 OpenClaw 和 skill
6. 重启后生成 `POST_BOOT_REPORT.md`

如果 Pi 还没装系统

不能让一台完全没有系统的 Pi 自己运行仓库脚本，但现在已经可以把“刷卡后到首启自动装好” 这段压进 bootfs 种子流程里。

• Pre-OS: 官方 Raspberry Pi Imager 或 Pi 5 Network Install
• Bootfs seed: `host_tools/pi5_zero_touch_seed.sh`
• Post-OS: `pi5_all_in_one.sh` 和 `lelamp_doctor.sh`

预装机说明见 PRE_OS_BOOTSTRAP_CN.md。

重启后看什么

仓库会在重启后收集并输出一份 post-boot 报告，帮助定位最常见的 bring-up 风险：

• `aplay -l`
• `arecord -l`
• `/dev/ttyACM*`
• `download-files` 结果
• `openclaw status` 结果