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

Pi-Modell	RAM	Geeignet?	Hinweise
Pi 5	4/8 GB	Optimal	Am schnellsten, empfohlen.
Pi 4	4 GB	Gut	Ideale Wahl für die meisten Benutzer.
Pi 4	2 GB	Ausreichend	Swap hinzufügen.
Pi 4	1 GB	Knapp	Mit Swap und minimaler Konfiguration möglich.
Pi 3B+	1 GB	Langsam	Funktioniert, reagiert aber träge.
Pi Zero 2 W	512 MB	Nein	Nicht empfohlen.

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

Betriebssystem aufspielen

Verwenden Sie Raspberry Pi OS Lite (64-bit) – für einen Headless-Server ist keine Desktop-Umgebung erforderlich.

Laden Sie Raspberry Pi Imager herunter.
Wählen Sie als Betriebssystem Raspberry Pi OS Lite (64-bit) aus.
Konfigurieren Sie im Einstellungsdialog vorab:
- Hostname: gateway-host
- SSH aktivieren
- Benutzernamen und Passwort festlegen
- WLAN konfigurieren (falls Sie kein Ethernet verwenden)
Spielen Sie das Image auf Ihre SD-Karte oder Ihr USB-Laufwerk, setzen Sie das Speichermedium ein und starten Sie den Pi.

Über SSH verbinden

ssh user@gateway-host

System aktualisieren

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

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

Node.js 24 installieren

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

Swap hinzufügen (wichtig bei höchstens 2 GB)

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

OpenClaw installieren

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

Onboarding ausführen

openclaw onboard --install-daemon

Folgen Sie dem Assistenten. Für Headless-Geräte werden API-Schlüssel anstelle von OAuth empfohlen. Telegram ist der einfachste Kanal für den Einstieg.

Überprüfen

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

Auf die Steuerungsoberfläche zugreifen

Rufen Sie auf Ihrem Computer eine Dashboard-URL vom Pi ab:

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

Erstellen Sie anschließend in einem weiteren 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. Informationen zum dauerhaften Fernzugriff finden Sie unter Tailscale-Integration.

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 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

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.txt
sudo 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=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 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

Install overview

Maintenance

Containers

Hosting

Advanced setup

Hardwarekompatibilität

Voraussetzungen

Einrichtung

Tipps zur Leistungsoptimierung

Empfohlene Modellkonfiguration

Hinweise zu ARM-Binärdateien

Persistenz und Sicherungen

Fehlerbehebung

Nächste Schritte

Verwandte Themen

​Hardwarekompatibilität

​Voraussetzungen

​Einrichtung

​Tipps zur Leistungsoptimierung

​Empfohlene Modellkonfiguration

​Hinweise zu ARM-Binärdateien

​Persistenz und Sicherungen

​Fehlerbehebung

​Nächste Schritte

​Verwandte Themen

Hardwarekompatibilität

Voraussetzungen

Einrichtung

Tipps zur Leistungsoptimierung

Empfohlene Modellkonfiguration

Hinweise zu ARM-Binärdateien

Persistenz und Sicherungen

Fehlerbehebung

Nächste Schritte

Verwandte Themen