Raspberry Pi

Betreiben Sie einen persistenten, dauerhaft aktiven OpenClaw Gateway auf einem Raspberry Pi. Da der Pi nur der Gateway ist (Modelle laufen per API in der Cloud), bewältigt selbst ein einfacher Pi die Arbeitslast gut — typische Hardwarekosten liegen bei 35–80 US-Dollar einmalig, ohne monatliche Gebühren.

Hardwarekompatibilität

Minimum: 1 GB RAM, 1 Kern, 500 MB freier Speicherplatz, 64-Bit-OS. Empfohlen: 2 GB+ RAM, 16 GB+ SD-Karte (oder USB-SSD), Ethernet.

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 WLAN)
• 64-Bit Raspberry Pi OS (erforderlich -- verwenden Sie kein 32-Bit)
• Etwa 30 Minuten

Einrichtung

ssh user@gateway-host

sudo apt update && sudo apt upgrade -ysudo apt install -y git curl build-essential # Set timezone (important for cron and reminders)sudo timedatectl set-timezone America/Chicago

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

sudo fallocate -l 2G /swapfilesudo chmod 600 /swapfilesudo mkswap /swapfilesudo swapon /swapfileecho '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab # Reduce swappiness for low-RAM devicesecho 'vm.swappiness=10' | sudo tee -a /etc/sysctl.confsudo sysctl -p

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

openclaw onboard --install-daemon

openclaw statussystemctl --user status openclaw-gateway.servicejournalctl --user -u openclaw-gateway.service -f

ssh user@gateway-host 'openclaw dashboard --no-open'

ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

Leistungstipps

Verwenden Sie eine USB-SSD -- SD-Karten sind langsam und verschleißen. Eine USB-SSD verbessert die Leistung deutlich. Siehe den Pi-USB-Boot-Leitfaden.

Modul-Compile-Cache aktivieren -- Beschleunigt wiederholte CLI-Aufrufe auf leistungsschwächeren Pi-Hosts:

grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secretexport NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cachemkdir -p /var/tmp/openclaw-compile-cacheexport OPENCLAW_NO_RESPAWN=1EOFsource ~/.bashrc

OPENCLAW_NO_RESPAWN=1 hält routinemäßige Gateway-Neustarts im Prozess. Dadurch werden zusätzliche Prozessübergaben vermieden und die PID-Verfolgung bleibt auf kleinen Hosts einfach.

Speichernutzung reduzieren -- Geben Sie bei headless Setups GPU-Speicher frei und deaktivieren Sie ungenutzte Dienste:

echo 'gpu_mem=16' | sudo tee -a /boot/config.txtsudo systemctl disable bluetooth

systemd-Drop-in für stabile Neustarts -- Wenn dieser Pi hauptsächlich OpenClaw ausführt, fügen Sie ein Service-Drop-in hinzu:

systemctl --user edit openclaw-gateway.service

[Service]Environment=OPENCLAW_NO_RESPAWN=1Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cacheRestart=alwaysRestartSec=2TimeoutStartSec=90

Führen Sie dann systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service aus. Aktivieren Sie auf einem headless Pi außerdem einmalig Lingering, damit der Benutzerdienst die Abmeldung übersteht: sudo loginctl enable-linger "$(whoami)".

Empfohlene Modelleinrichtung

Da der Pi nur den Gateway ausführt, verwenden Sie cloudgehostete API-Modelle:

{  "agents": {    "defaults": {      "model": {        "primary": "anthropic/claude-sonnet-4-6",        "fallbacks": ["openai/gpt-5.4-mini"]      }    }  }}

Führen Sie keine lokalen LLMs auf einem Pi aus — selbst kleine Modelle sind zu langsam, um nützlich zu sein. Lassen Sie Claude oder GPT die Modellarbeit erledigen.

Hinweise zu ARM-Binaries

Die meisten OpenClaw-Funktionen funktionieren unter ARM64 ohne Änderungen (Node.js, Telegram, WhatsApp/Baileys, Chromium). Binaries, für die gelegentlich ARM-Builds fehlen, sind typischerweise optionale Go/Rust-CLI-Tools, die von Skills ausgeliefert werden. Prüfen Sie die Release-Seite eines fehlenden Binaries auf linux-arm64- / aarch64-Artefakte, bevor Sie auf das Bauen aus dem Quellcode zurückfallen.

Persistenz und Backups

Der OpenClaw-Status liegt unter:

• ~/.openclaw/ — openclaw.json, agentenspezifische auth-profiles.json, Kanal-/Provider-Status, Sitzungen.
• ~/.openclaw/workspace/ — Agent-Arbeitsbereich (SOUL.md, Speicher, Artefakte).

Diese Daten überstehen Neustarts. Erstellen Sie einen portablen Snapshot mit:

openclaw backup create

Wenn Sie diese Daten auf einer SSD speichern, verbessern sich sowohl Leistung als auch Lebensdauer gegenüber der SD-Karte.

Problembehandlung

Nicht genügend Arbeitsspeicher -- Prüfen Sie mit free -h, ob Swap aktiv ist. Deaktivieren Sie ungenutzte Dienste (sudo systemctl disable cups bluetooth avahi-daemon). Verwenden Sie ausschließlich 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).

WLAN-Verbindungsabbrüche -- Deaktivieren Sie die WLAN-Energieverwaltung: sudo iwconfig wlan0 power off.

Nächste Schritte

• Kanäle -- Telegram, WhatsApp, Discord und weitere verbinden
• Gateway-Konfiguration -- alle Konfigurationsoptionen
• Aktualisierung -- OpenClaw aktuell halten

Verwandt

• Installationsübersicht
• Linux-Server
• Plattformen