Zum Hauptinhalt springen

​
Raspberry Pi

Führen Sie ein persistentes, dauerhaft laufendes OpenClaw Gateway auf einem Raspberry Pi aus. Da der Pi nur das Gateway ist (Modelle laufen per API in der Cloud), bewältigt selbst ein bescheidener Pi die Arbeitslast gut.

​
Voraussetzungen

  • Raspberry Pi 4 oder 5 mit 2 GB+ RAM (4 GB empfohlen)
  • MicroSD-Karte (16 GB+) oder USB-SSD (bessere Leistung)
  • Offizielles Pi-Netzteil
  • Netzwerkverbindung (Ethernet oder WiFi)
  • 64-Bit Raspberry Pi OS (erforderlich — kein 32-Bit verwenden)
  • Etwa 30 Minuten

​
Einrichtung

1

Das Betriebssystem flashen

Verwenden Sie Raspberry Pi OS Lite (64-bit) — keine Desktop-Umgebung für einen Headless-Server erforderlich.
  1. Laden Sie Raspberry Pi Imager herunter.
  2. Wählen Sie als Betriebssystem: Raspberry Pi OS Lite (64-bit).
  3. Konfigurieren Sie im Einstellungsdialog vorab:
    • Hostname: gateway-host
    • SSH aktivieren
    • Benutzername und Passwort festlegen
    • WiFi konfigurieren (wenn Sie kein Ethernet verwenden)
  4. Auf Ihre SD-Karte oder Ihr USB-Laufwerk flashen, einlegen und den Pi starten.
2

Per SSH verbinden

ssh user@gateway-host
3

Das System aktualisieren

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential

# Zeitzone setzen (wichtig für Cron und Erinnerungen)
sudo timedatectl set-timezone America/Chicago
4

Node.js 24 installieren

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node --version
5

Swap hinzufügen (wichtig bei 2 GB oder weniger)

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Swappiness für Geräte mit wenig RAM reduzieren
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
6

OpenClaw installieren

curl -fsSL https://openclaw.ai/install.sh | bash
7

Onboarding ausführen

openclaw onboard --install-daemon
Folgen Sie dem Assistenten. Für Headless-Geräte werden API-Schlüssel gegenüber OAuth empfohlen. Telegram ist der einfachste Channel für den Einstieg.
8

Prüfen

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f
9

Auf die Control UI zugreifen

Holen Sie auf Ihrem Computer eine Dashboard-URL vom Pi:
ssh user@gateway-host 'openclaw dashboard --no-open'
Erstellen Sie dann in einem anderen Terminal einen SSH-Tunnel:
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
Öffnen Sie die ausgegebene URL in Ihrem lokalen Browser. Für dauerhaft verfügbaren Remote-Zugriff siehe Tailscale integration.

​
Leistungstipps

Eine USB-SSD verwenden — SD-Karten sind langsam und verschleißen. Eine USB-SSD verbessert die Leistung deutlich. Siehe den Pi USB boot guide. Module-Compile-Cache aktivieren — Beschleunigt wiederholte CLI-Aufrufe auf Pi-Hosts mit geringerer Leistung: 
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secret
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
Speichernutzung reduzieren — Für Headless-Setups GPU-Speicher freigeben und ungenutzte Dienste deaktivieren: 
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth

​
Fehlerbehebung

Zu wenig Speicher — Prüfen Sie mit free -h, ob Swap aktiv ist. Deaktivieren Sie ungenutzte Dienste (sudo systemctl disable cups bluetooth avahi-daemon). Verwenden Sie nur API-basierte Modelle. Langsame Leistung — Verwenden Sie eine USB-SSD statt einer SD-Karte. Prüfen Sie mit vcgencmd get_throttled auf CPU-Drosselung (sollte 0x0 zurückgeben). Dienst startet nicht — Prüfen Sie die Logs mit journalctl --user -u openclaw-gateway.service --no-pager -n 100 und führen Sie openclaw doctor --non-interactive aus. Wenn dies ein Headless-Pi ist, prüfen Sie außerdem, ob lingering aktiviert ist: sudo loginctl enable-linger "$(whoami)". ARM-Binary-Probleme — Wenn ein Skill mit „exec format error“ fehlschlägt, prüfen Sie, ob das Binary einen ARM64-Build hat. Prüfen Sie die Architektur mit uname -m (sollte aarch64 anzeigen). WiFi-Verbindungsabbrüche — Deaktivieren Sie das WiFi-Energiemanagement: sudo iwconfig wlan0 power off.

​
Nächste Schritte