Raspberry Pi

Betreiben Sie ein dauerhaftes, ständig verfügbares OpenClaw Gateway auf einem Raspberry Pi. Da der Pi lediglich als Gateway dient (die Modelle werden über eine API in der Cloud ausgeführt), bewältigt selbst ein einfacher Pi die Arbeitslast gut – die typischen Hardwarekosten betragen einmalig 35–80 US-Dollar, 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 (bessere Leistung)
• Offizielles Pi-Netzteil
• Netzwerkverbindung (Ethernet oder WLAN)
• Raspberry Pi OS in der 64-Bit-Version (erforderlich – verwenden Sie nicht die 32-Bit-Version)
• Etwa 30 Minuten Zeit

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 # Swap-Nutzung bei Geräten 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 übersteht mehr Schreibzyklen. Verwenden Sie sie für OPENCLAW_STATE_DIR, wenn das Betriebssystem auf der SD-Karte verbleibt. Weitere Informationen finden Sie in der Anleitung zum Starten des Pi über USB.

Modulkompilierungs-Cache aktivieren – Dies beschleunigt wiederholte CLI-Aufrufe auf leistungsschwächeren Pi-Hosts. OPENCLAW_NO_RESPAWN=1 sorgt dafür, dass routinemäßige Neustarts des Gateway innerhalb desselben Prozesses erfolgen. Dadurch entfallen zusätzliche Prozessübergaben und die PID-Verfolgung bleibt auf kleinen Hosts übersichtlich:

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 und nicht /tmp – einige Distributionen leeren /tmp beim Start, wodurch der aufgewärmte Cache verloren geht.

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

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

systemd-Ergänzung für zuverlässige Neustarts – Wenn auf diesem Pi hauptsächlich OpenClaw ausgeführt wird, fügen Sie eine Dienstergänzung 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 Pi ohne Bildschirm außerdem einmalig das Fortbestehen des Benutzerdienstes, damit dieser nach der Abmeldung weiterläuft: sudo loginctl enable-linger "$(whoami)".

Empfohlene Modellkonfiguration

Da auf dem Pi nur das Gateway ausgeführt wird, sollten Sie in der Cloud gehostete API-Modelle verwenden. Führen Sie keine lokalen LLMs auf einem Pi aus – selbst kleine Modelle sind zu langsam, um sinnvoll eingesetzt werden zu können:

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

Hinweise zu ARM-Binärdateien

Die meisten OpenClaw-Funktionen arbeiten unter ARM64 ohne Änderungen (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-Werkzeuge. Überprüfen Sie die Architektur mit uname -m (die Ausgabe sollte aarch64 lauten) und suchen Sie anschließend auf der Veröffentlichungsseite einer fehlenden Binärdatei nach linux-arm64- bzw. aarch64-Artefakten, bevor Sie als Ausweichlösung aus dem Quellcode kompilieren.

Persistenz und Sicherungen

Der OpenClaw-Zustand befindet sich unter:

• ~/.openclaw/ – openclaw.json, agentenspezifische auth-profiles.json, Kanal-/Provider-Zustand und Sitzungen.
• ~/.openclaw/workspace/ – Arbeitsbereich des Agenten (SOUL.md, Speicher, Artefakte).

Diese Daten bleiben nach Neustarts erhalten. Eine SSD bietet gegenüber einer SD-Karte sowohl hinsichtlich der Leistung als auch der Lebensdauer Vorteile. Erstellen Sie eine übertragbare Momentaufnahme 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 eine USB-SSD anstelle einer SD-Karte. 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 Pi ohne Bildschirm außerdem, ob das Fortbestehen des Benutzerdienstes 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 für die Binärdatei ein ARM64-Build 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 Dienste verbinden
• Gateway-Konfiguration – alle Konfigurationsoptionen
• Aktualisierung – OpenClaw auf dem neuesten Stand halten

Verwandte Themen

• Installationsübersicht
• Linux-Server
• Plattformen