OpenClaw auf dem Raspberry Pi installieren

Kennst du das? Du hast ein tolles Projekt für einen KI-Assistenten im Kopf, aber die monatlichen Kosten für Cloud-Server summieren sich schnell. Außerdem willst du, dass dein System 24/7 erreichbar ist, ohne dass dein Hauptrechner ständig laufen muss.

Ein Raspberry Pi ist hier die perfekte Lösung. Für eine einmalige Investition zwischen 35 und 80 Euro bekommst du eine Hardware, die kaum Strom verbraucht und ideal als Gateway für OpenClaw funktioniert. So hostest du deinen eigenen Bot oder Hub einfach zu Hause.

Voraussetzungen

• Raspberry Pi 4 oder 5 (2GB+ RAM empfohlen)
• MicroSD-Karte (16GB+) oder USB SSD (für bessere Performance)
• Netzteil (offizielles Pi Netzteil empfohlen)
• Netzwerkverbindung (Ethernet oder WiFi)
• Ungefähr 30 Minuten Zeit

Schnellstart

In dieser Anleitung lernst du den schnellsten Weg kennen, um OpenClaw auf deinem Pi ans Laufen zu bringen.

1. Das OS flashen

Verwende Raspberry Pi OS Lite (64-bit). Da wir einen Headless-Server nutzen, brauchst du keinen Desktop.

1. Lade den Raspberry Pi Imager herunter.
2. Wähle als OS: Raspberry Pi OS Lite (64-bit).
3. Klicke auf das Zahnrad-Icon (⚙️) für die Vorkonfiguration:
   • Hostname setzen: gateway-host
   • SSH aktivieren
   • Benutzername und Passwort festlegen
   • WiFi konfigurieren (falls kein Ethernet genutzt wird)
4. Flashen, Karte einlegen und den Pi starten.

2. Verbindung via SSH

Verbinde dich von deinem Computer aus:

ssh user@gateway-host
# Oder nutze die IP-Adresse
ssh user@192.168.x.x

3. System-Setup

Aktualisiere die Pakete und installiere die Basics:

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

# Zeitzone einstellen (wichtig für Cron-Jobs/Reminder)
sudo timedatectl set-timezone Europe/Berlin

4. Node.js 22 (ARM64) installieren

OpenClaw benötigt Node.js. So installierst du die aktuelle Version:

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

# Check
node --version
npm --version

5. Swap hinzufügen (Wichtig für 2GB RAM oder weniger)

Swap verhindert Abstürze durch Speichermangel:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

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

# Swappiness optimieren
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

6. OpenClaw installieren

Nutze den Standard-Installer für den schnellsten Weg:

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

7. Onboarding starten

Führe den Wizard aus, um die Konfiguration abzuschließen:

openclaw onboard --install-daemon

Wähle im Wizard diese Optionen:

• Gateway mode: Local
• Auth: API keys empfohlen
• Channels: Telegram ist für den Start am einfachsten
• Daemon: Yes (systemd)

8. Installation prüfen

Checke, ob alles läuft:

openclaw status
sudo systemctl status openclaw
journalctl -u openclaw -f

9. Dashboard Zugriff

Da der Pi keinen Monitor hat, nutzt du einen SSH-Tunnel von deinem Laptop aus:

ssh -L 18789:localhost:18789 user@gateway-host

Öffne danach http://localhost:18789 in deinem Browser.

Fehlerbehebung

Hier sind Lösungen für Probleme, die auf dem Raspberry Pi auftreten können:

Out of Memory (OOM) Prüfe deinen Speicher mit free -h. Falls der Platz knapp wird, vergrößere den Swap (siehe Schritt 5) oder beende unnötige Dienste.

Langsame Performance Nutze eine USB SSD anstelle einer SD-Karte. Deaktiviere ungenutzte Dienste wie Bluetooth (sudo systemctl disable bluetooth) oder reduziere den GPU-Speicher in der /boot/config.txt mit gpu_mem=16.

Service startet nicht Prüfe die Logs mit journalctl -u openclaw --no-pager -n 100. Falls du die “Hackable Install” nutzt, führe npm run build erneut aus.

ARM Binary Fehler Wenn ein Tool mit “exec format error” abbricht, fehlt die ARM64-Unterstützung. Prüfe, ob es ein ARM-Build gibt oder versuche, das Tool aus dem Source-Code zu bauen.

WiFi-Abbrüche Deaktiviere das Power Management für WiFi:

sudo iwconfig wlan0 power off

---

Du hast Fragen zum Setup oder brauchst Hilfe bei der Konfiguration? Unser AI Setup Assistant hilft dir direkt weiter.

Nächste Schritte

• Linux Guide
• DigitalOcean Guide
• Tailscale Integration
• Nodes Übersicht