OpenClaw auf Raspberry Pi

Ziel

Betreibe ein dauerhaft laufendes OpenClaw Gateway auf einem Raspberry Pi für ~35-80 $ einmalige Kosten (keine monatlichen Gebühren).

Perfekt für:

• 24/7 persönlicher KI-Assistent
• Home Automation Hub
• Stromsparender, immer verfügbarer Telegram/WhatsApp Bot

Hardware-Anforderungen

Mindestanforderungen: 1GB RAM, 1 Core, 500MB Speicher Empfohlen: 2GB+ RAM, 64-Bit OS, 16GB+ SD-Karte (oder USB SSD)

Was du brauchst

• Raspberry Pi 4 oder 5 (2GB+ empfohlen)
• MicroSD-Karte (16GB+) oder USB SSD (bessere Performance)
• Netzteil (offizielles Pi PSU empfohlen)
• Netzwerkverbindung (Ethernet oder WiFi)
• ~30 Minuten Zeit

1) OS flashen

Verwende Raspberry Pi OS Lite (64-Bit) — für einen Headless-Server brauchst du keinen Desktop.

1. Lade den Raspberry Pi Imager herunter
2. Wähle OS: Raspberry Pi OS Lite (64-bit)
3. Klicke auf das Zahnrad-Icon (⚙️) für die Vorkonfiguration:
   • Hostname setzen: gateway-host
   • SSH aktivieren
   • Benutzername/Passwort festlegen
   • WiFi konfigurieren (falls kein Ethernet)
4. Flashe auf deine SD-Karte / USB-Laufwerk
5. Einsetzen und Pi booten

2) Per SSH verbinden

ssh user@gateway-host
# oder nutze die IP-Adresse
ssh [email protected]

3) System einrichten

# System updaten
sudo apt update && sudo apt upgrade -y

# Wichtige Pakete installieren
sudo apt install -y git curl build-essential

# Zeitzone setzen (wichtig für Cron/Erinnerungen)
sudo timedatectl set-timezone Europe/Berlin  # Ändere auf deine Zeitzone

4) Node.js 22 installieren (ARM64)

# Node.js über NodeSource installieren
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Überprüfen
node --version  # Sollte v22.x.x zeigen
npm --version

5) Swap hinzufügen (wichtig bei 2GB oder weniger)

Swap verhindert Out-of-Memory-Abstürze:

# 2GB Swap-Datei erstellen
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Dauerhaft machen
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Für wenig RAM optimieren (Swappiness reduzieren)
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

6) OpenClaw installieren

Option A: Standard-Installation (empfohlen)

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

Option B: Hackbare Installation (zum Basteln)

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build
npm link

Die hackbare Installation gibt dir direkten Zugriff auf Logs und Code — nützlich zum Debuggen von ARM-spezifischen Problemen.

7) Onboarding durchführen

openclaw onboard --install-daemon

Folge dem Wizard:

1. Gateway-Modus: Local
2. Auth: API Keys empfohlen (OAuth kann auf Headless-Pi zickig sein)
3. Channels: Telegram ist am einfachsten zum Starten
4. Daemon: Ja (systemd)

8) Installation überprüfen

# Status checken
openclaw status

# Service checken
sudo systemctl status openclaw

# Logs anschauen
journalctl -u openclaw -f

9) Auf das Dashboard zugreifen

Da der Pi headless ist, nutze einen SSH-Tunnel:

# Von deinem Laptop/Desktop aus
ssh -L 18789:localhost:18789 user@gateway-host

# Dann im Browser öffnen
open http://localhost:18789

Oder nutze Tailscale für dauerhaften Zugriff:

# Auf dem Pi
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

# Config updaten
openclaw config set gateway.bind tailnet
sudo systemctl restart openclaw

Performance-Optimierungen

USB SSD verwenden (riesige Verbesserung)

SD-Karten sind langsam und verschleißen schnell. Eine USB SSD verbessert die Performance dramatisch:

# Prüfen, ob von USB gebootet wird
lsblk

Siehe Pi USB Boot Guide für die Einrichtung.

Speicherverbrauch reduzieren

# GPU-Speicher deaktivieren (headless)
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt

# Bluetooth deaktivieren, falls nicht benötigt
sudo systemctl disable bluetooth

Ressourcen überwachen

# Speicher checken
free -h

# CPU-Temperatur checken
vcgencmd measure_temp

# Live-Monitoring
htop

ARM-spezifische Hinweise

Binary-Kompatibilität

Die meisten OpenClaw-Features funktionieren auf ARM64, aber manche externen Binaries brauchen ARM-Builds:

Falls ein Skill fehlschlägt, prüfe ob das Binary einen ARM-Build hat. Viele Go/Rust-Tools haben einen; manche nicht.

32-Bit vs 64-Bit

Nutze immer ein 64-Bit OS. Node.js und viele moderne Tools brauchen es. Prüfen mit:

uname -m
# Sollte zeigen: aarch64 (64-Bit) nicht armv7l (32-Bit)

Empfohlenes Model-Setup

Da der Pi nur das Gateway ist (Modelle laufen in der Cloud), nutze API-basierte Modelle:

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

Versuche nicht, lokale LLMs auf einem Pi zu betreiben — selbst kleine Modelle sind zu langsam. Lass Claude/GPT die schwere Arbeit machen.

Autostart beim Booten

Der Onboarding-Wizard richtet das ein, aber zur Überprüfung:

# Prüfen, ob Service aktiviert ist
sudo systemctl is-enabled openclaw

# Falls nicht, aktivieren
sudo systemctl enable openclaw

# Beim Booten starten
sudo systemctl start openclaw

Troubleshooting

Out of Memory (OOM)

# Speicher checken
free -h

# Mehr Swap hinzufügen (siehe Schritt 5)
# Oder Services auf dem Pi reduzieren

Langsame Performance

• Nutze USB SSD statt SD-Karte
• Deaktiviere ungenutzte Services: sudo systemctl disable cups bluetooth avahi-daemon
• Prüfe CPU-Throttling: vcgencmd get_throttled (sollte 0x0 zurückgeben)

Service startet nicht

# Logs checken
journalctl -u openclaw --no-pager -n 100

# Häufiger Fix: neu bauen
cd ~/openclaw  # falls hackbare Installation
npm run build
sudo systemctl restart openclaw

ARM Binary-Probleme

Falls ein Skill mit “exec format error” fehlschlägt:

1. Prüfe, ob das Binary einen ARM64-Build hat
2. Versuche, aus dem Quellcode zu bauen
3. Oder nutze einen Docker-Container mit ARM-Support

WiFi-Verbindungsabbrüche

Für Headless-Pis mit WiFi:

# WiFi Power Management deaktivieren
sudo iwconfig wlan0 power off

# Dauerhaft machen
echo 'wireless-power off' | sudo tee -a /etc/network/interfaces

Kostenvergleich

Break-Even: Ein Pi amortisiert sich in ~6-12 Monaten gegenüber Cloud-VPS.

Siehe auch

• Linux-Guide — allgemeine Linux-Einrichtung
• DigitalOcean-Guide — Cloud-Alternative
• Hetzner-Guide — Docker-Setup
• Tailscale — Remote-Zugriff
• Nodes — Laptop/Smartphone mit dem Pi Gateway pairen