Headless 无界面部署
不接显示器，SSH远程搞定一切
谁需要 Headless 部署
所谓 Headless 就是不接显示器、不接键盘鼠标，全程用 SSH 远程操作。大多数人的树莓派最终都是塞在角落里吃灰式运行的，根本不需要桌面环境。
这篇教你从烧录系统开始，到 SSH 连接、部署 OpenClaw、设置开机自启，全程不需要任何外设。省一台显示器和一根 HDMI 线的钱。
五步搞定
1
烧录系统
用 Raspberry Pi Imager 把系统烧录到 SD 卡，选 Raspberry Pi OS Lite (64-bit)，不需要桌面环境。
2
开启 SSH
在 Imager 的高级设置里直接勾选 "Enable SSH"，设好用户名和密码，省得再手动建文件。
3
配 WiFi
同样在 Imager 高级设置里填好 WiFi 名称和密码。有网线的话直接插上更省事。
4
首次连接
把 SD 卡插到树莓派通电开机，等 1-2 分钟让它联网，然后用 SSH 连上去。
5
部署 OpenClaw
连上 SSH 之后就和普通 Linux 一样操作了，装 Docker、跑 compose，搞定。
Raspberry Pi Imager 设置
Imager 工具现在很好用了，烧录的时候直接把 SSH、WiFi、用户名全配好：
Raspberry Pi Imager 高级设置
# 1. 下载安装 Raspberry Pi Imager
# https://www.raspberrypi.com/software/
# 2. 选择操作系统
# Raspberry Pi OS (other) → Raspberry Pi OS Lite (64-bit)
# Lite 版没有桌面，省资源
# 3. 点击齿轮图标进入高级设置
# ☑ Set hostname: openclaw
# ☑ Enable SSH → Use password authentication
# ☑ Set username and password
# Username: pi
# Password: （设个强密码）
# ☑ Configure wireless LAN
# SSID: 你的WiFi名
# Password: WiFi密码
# Country: CN
# ☑ Set locale settings
# Time zone: Asia/Shanghai
# 4. 选好 SD 卡，点 Write 开始烧录SSH 连接
烧录完插卡通电，等个一两分钟让树莓派联上网，然后从你的电脑上 SSH 连过去：
SSH 密钥生成和首次登录
# 如果还没有 SSH 密钥，先生成一个
ssh-keygen -t ed25519 -C "openclaw@rpi"
# 一路回车就行
# 首次连接（用设置里的用户名和密码）
ssh pi@openclaw.local
# 或者用 IP 地址
ssh pi@192.168.1.xxx
# 找不到树莓派的 IP？试试这个
ping openclaw.local
# 或者去路由器后台看 DHCP 客户端列表
# 连上之后把 SSH 公钥复制过去，以后免密登录
ssh-copy-id pi@openclaw.local开机自启动
树莓派断电重启之后，你肯定希望 OpenClaw 自动跑起来，不用手动 SSH 上去再启动一次。用 systemd 来管理：
创建 systemd 服务
# 创建服务文件
sudo nano /etc/systemd/system/openclaw.service
# 把下面的配置粘贴进去
openclaw.service systemd 服务文件
[Unit]
Description=OpenClaw Docker Compose Service
Requires=docker.service
After=docker.service network-online.target
Wants=network-online.target
[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/home/pi/openclaw
ExecStart=/usr/bin/docker compose up -d
ExecStop=/usr/bin/docker compose down
ExecReload=/usr/bin/docker compose restart
TimeoutStartSec=120
[Install]
WantedBy=multi-user.target
启用开机自启
# 重新加载 systemd 配置
sudo systemctl daemon-reload
# 启用开机自启
sudo systemctl enable openclaw.service
# 手动启动测试一下
sudo systemctl start openclaw.service
# 查看状态
sudo systemctl status openclaw.service
# 以后重启树莓派就自动拉起来了
sudo reboot
固定 IP 地址防止找不到：树莓派默认用 DHCP 自动获取 IP，路由器重启后 IP 可能会变，SSH 就连不上了。建议在路由器里给树莓派绑定固定 IP，或者在树莓派上配静态 IP：编辑
/etc/dhcpcd.conf，加上 static ip_address=192.168.1.100/24。
SSH 连上后快速部署
连上 SSH 之后，照着下面的命令一路走就行了：
一键部署流程
# 更新系统
sudo apt update && sudo apt upgrade -y
# 装 Docker
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker
# 创建目录和配置文件
mkdir -p ~/openclaw && cd ~/openclaw
# 创建 docker-compose.yml（参考 Pi 5 或 Pi 4 教程里的配置）
# 拉镜像启动
docker compose pull
docker compose up -d
# 搞定！浏览器打开 http://树莓派IP:3000