Raspberry Pi

Führen Sie einen persistenten, dauerhaft aktiven OpenClaw Gateway auf einem Raspberry Pi aus. Da der Pi nur der Gateway ist (Modelle laufen in der Cloud über API), bewältigt selbst ein einfacher Pi die Arbeitslast gut — die typischen Hardwarekosten betragen 35–80 $ einmalig, ohne monatliche Gebühren.

# Hardwarekompatibilität

Minimum: 1 GB RAM, 1 Kern, 500 MB freier Speicherplatz, 64-Bit-Betriebssystem. 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 -y
sudo 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 nodejs
node --version

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

# Reduce swappiness for low-RAM devices
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

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

openclaw onboard --install-daemon

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --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 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 -- Geben Sie bei Headless-Setups GPU-Speicher frei und deaktivieren Sie ungenutzte Dienste:

echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo 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=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90

Führen Sie anschließend systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service aus. Aktivieren Sie auf einem Headless-Pi außerdem einmalig Lingering, damit der Benutzerdienst eine 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 übernehmen.

# Hinweise zu ARM-Binärdateien

Die meisten OpenClaw-Funktionen funktionieren auf ARM64 ohne Änderungen (Node.js, Telegram, WhatsApp/Baileys, Chromium). Die Binärdateien, 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 einer fehlenden Binärdatei auf linux-arm64- / aarch64-Artefakte, bevor Sie auf das Erstellen aus dem Quellcode zurückgreifen.

# Persistenz und Backups

Der OpenClaw-Zustand liegt unter:

• ~/.openclaw/ — openclaw.json, agentenspezifische auth-profiles.json, Kanal-/Provider-Zustand, Sitzungen.
• ~/.openclaw/workspace/ — Agenten-Workspace (SOUL.md, Speicher, Artefakte).

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

openclaw backup create

Wenn Sie diese auf einer SSD speichern, verbessern sich sowohl Leistung als auch Lebensdauer im Vergleich zur SD-Karte.

# Fehlerbehebung

Nicht genügend Arbeitsspeicher -- Überprü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 statt einer SD-Karte eine USB-SSD. Prüfen Sie CPU-Drosselung mit vcgencmd get_throttled (sollte 0x0 zurückgeben).

Service 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-Binärprobleme -- Wenn ein Skill mit "exec format error" fehlschlägt, prüfen Sie, ob die Binärdatei einen ARM64-Build hat. Überprüfen Sie die Architektur mit uname -m (sollte aarch64 anzeigen).

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

# Nächste Schritte

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

# Verwandte Themen

• Installationsübersicht
• Linux-Server
• Plattformen