Raspberry Pi

Führen Sie einen persistenten, stets aktiven OpenClaw Gateway auf einem Raspberry Pi aus. Da der Pi lediglich als Gateway dient (die Modelle werden über eine API in der Cloud ausgeführt), bewältigt selbst ein leistungsschwächerer Pi die Arbeitslast problemlos – die typischen Hardwarekosten betragen einmalig $35-80, ohne monatliche Gebühren.

Hardwarekompatibilität

Minimum: 1 GB RAM, 1 Kern, 500 MB freier Speicherplatz, 64-Bit-Betriebssystem. Empfohlen: mindestens 2 GB RAM, mindestens 16 GB große SD-Karte (oder USB-SSD), Ethernet.

Voraussetzungen

• Raspberry Pi 4 oder 5 mit mindestens 2 GB RAM (4 GB empfohlen)
• MicroSD-Karte (mindestens 16 GB) oder USB-SSD (höhere Leistung)
• Offizielles Pi-Netzteil
• Netzwerkverbindung (Ethernet oder WLAN)
• 64-Bit-Version von Raspberry Pi OS (erforderlich – verwenden Sie nicht die 32-Bit-Version)
• Etwa 30 Minuten

Einrichtung

ssh user@gateway-host

sudo apt update && sudo apt upgrade -ysudo apt install -y git curl build-essential # Zeitzone festlegen (wichtig für Cron und Erinnerungen)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 # Swappiness für Geräte mit wenig RAM reduzierenecho '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

Tipps zur Leistungsoptimierung

Verwenden Sie eine USB-SSD – SD-Karten sind langsam und verschleißen. Eine USB-SSD verbessert die Leistung erheblich und hält mehr Schreibzyklen stand; verwenden Sie sie für OPENCLAW_STATE_DIR, wenn das Betriebssystem auf der SD-Karte verbleibt. Weitere Informationen finden Sie im Pi-Leitfaden zum Booten über USB.

Modul-Compile-Cache aktivieren – Beschleunigt wiederholte CLI-Aufrufe auf leistungsschwächeren Pi-Hosts. OPENCLAW_NO_RESPAWN=1 hält routinemäßige Neustarts des Gateway innerhalb desselben Prozesses, vermeidet zusätzliche Prozessübergaben und vereinfacht die PID-Verfolgung auf kleinen 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

Verwenden Sie /var/tmp statt /tmp – einige Distributionen leeren /tmp beim Start, wodurch der aufgewärmte Cache verloren geht.

Speichernutzung reduzieren – Geben Sie bei Headless-Installationen GPU-Speicher frei und deaktivieren Sie nicht verwendete Dienste:

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

systemd-Drop-in für stabile Neustarts – Wenn auf diesem Pi hauptsächlich OpenClaw ausgeführt wird, 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 anschließend systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service aus. Aktivieren Sie auf einem Headless-Pi außerdem einmalig Linger, damit der Benutzerdienst nach der Abmeldung weiterläuft: sudo loginctl enable-linger "$(whoami)".

Empfohlene Modellkonfiguration

Da auf dem Pi nur das Gateway ausgeführt wird, sollten Sie über die Cloud bereitgestellte API-Modelle verwenden – führen Sie keine lokalen LLMs auf einem Pi aus; selbst kleine Modelle sind zu langsam, um sinnvoll nutzbar zu sein:

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

Hinweise zu ARM-Binärdateien

Die meisten OpenClaw-Funktionen sind ohne Änderungen unter ARM64 verfügbar (Node.js, Telegram, WhatsApp/Baileys, Chromium). Bei den Binärdateien, für die gelegentlich keine ARM-Builds verfügbar sind, handelt es sich üblicherweise um optionale, von Skills bereitgestellte Go-/Rust-CLI-Tools. Überprüfen Sie die Architektur mit uname -m (die Ausgabe sollte aarch64 lauten) und suchen Sie anschließend auf der Release-Seite einer fehlenden Binärdatei nach linux-arm64- bzw. aarch64-Artefakten, bevor Sie auf das Erstellen aus dem Quellcode zurückgreifen.

Persistenz und Sicherungen

Der OpenClaw-Status befindet sich unter:

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

Diese Daten bleiben bei Neustarts erhalten. Eine SSD bietet gegenüber einer SD-Karte sowohl bei der Leistung als auch bei der Lebensdauer Vorteile. Erstellen Sie einen portablen Snapshot mit:

openclaw backup create

Fehlerbehebung

Nicht genügend Arbeitsspeicher – Überprüfen Sie mit free -h, ob Swap aktiv ist. Deaktivieren Sie nicht verwendete 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 mit vcgencmd get_throttled, ob die CPU gedrosselt wird (die Ausgabe sollte 0x0 lauten).

Dienst startet nicht – Prüfen Sie die Protokolle mit journalctl --user -u openclaw-gateway.service --no-pager -n 100 und führen Sie openclaw doctor --non-interactive aus. Überprüfen Sie bei einem Headless-Pi außerdem, ob Linger aktiviert ist: sudo loginctl enable-linger "$(whoami)".

Probleme mit ARM-Binärdateien – Wenn ein Skill mit „exec format error“ fehlschlägt, prüfen Sie, ob ein ARM64-Build der Binärdatei verfügbar ist. Überprüfen Sie die Architektur mit uname -m (die Ausgabe sollte aarch64 lauten).

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 auf dem neuesten Stand halten

Verwandte Themen

• Installationsübersicht
• Linux-Server
• Plattformen