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

SSH 連線

烧錄完插卡通電,等個一兩分鐘讓樹莓派聯上網,然後從你的電腦上 SSH 連過去:

SSH 密鑰產生和首次登入
# 如果還沒有 SSH 密鑰,先產生一個

開機自啟動

樹莓派斷電重啟之後,你肯定希望 OpenClaw 自動跑起來,不用手動 SSH 上去再啟動一次。用 systemd 來管理:

建立 systemd 服務
# 建立服務檔案
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 設定
⚠️ 固定 IP 位址防止找不到:樹莓派預設用 DHCP 自動取得 IP,路由器重啟後 IP 可能會變,SSH 就連不上了。建議在路由器裡給樹莓派綁定固定 IP,或者在樹莓派上設定靜態 IP:編輯 /etc/dhcpcd.conf,加上 static ip_address=192.168.1.100/24

SSH 連上後快速部署

連上 SSH 之後,照著下面的指令一路走就行了:

一鍵部署流程
# 更新系統
這篇教程對你有幫助嗎?