---
read_when:
    - OpenClaw auf einem Raspberry Pi einrichten
    - OpenClaw auf ARM-Geräten ausführen
    - Eine günstige, ständig aktive persönliche KI aufbauen
summary: OpenClaw auf einem Raspberry Pi für durchgehend verfügbares Self-Hosting betreiben
title: Raspberry Pi
x-i18n:
    generated_at: "2026-05-06T06:54:16Z"
    model: gpt-5.5
    provider: openai
    source_hash: 96df076c2707b0b27751d452f15fad774356a86e96d10bce998581235776c4bc
    source_path: install/raspberry-pi.md
    workflow: 16
---

Führen Sie einen persistenten, dauerhaft aktiven OpenClaw Gateway auf einem Raspberry Pi aus. Da der Pi nur der Gateway ist (Modelle laufen in der Cloud über API), bewältigt selbst ein einfacher Pi die Arbeitslast gut — die typischen Hardwarekosten betragen **35–80 $ einmalig**, ohne monatliche Gebühren.

## Hardwarekompatibilität

| Pi-Modell   | RAM    | Funktioniert? | Hinweise                            |
| ----------- | ------ | ------------- | ----------------------------------- |
| Pi 5        | 4/8 GB | Am besten     | Am schnellsten, empfohlen.          |
| Pi 4        | 4 GB   | Gut           | Idealer Bereich für die meisten Benutzer. |
| Pi 4        | 2 GB   | OK            | Swap hinzufügen.                    |
| Pi 4        | 1 GB   | Knapp         | Mit Swap möglich, minimale Konfiguration. |
| Pi 3B+      | 1 GB   | Langsam       | Funktioniert, 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:** 2 GB+ RAM, 16 GB+ SD-Karte (oder USB-SSD), Ethernet.

## Voraussetzungen

- Raspberry Pi 4 oder 5 mit 2 GB+ RAM (4 GB empfohlen)
- MicroSD-Karte (16 GB+) oder USB-SSD (bessere Leistung)
- Offizielles Pi-Netzteil
- Netzwerkverbindung (Ethernet oder WLAN)
- 64-Bit-Raspberry Pi OS (erforderlich -- verwenden Sie kein 32-Bit)
- Etwa 30 Minuten

## Einrichtung

<Steps>
  <Step title="Betriebssystem flashen">
    Verwenden Sie **Raspberry Pi OS Lite (64-bit)** -- für einen Headless-Server wird kein Desktop benötigt.

    1. Laden Sie den [Raspberry Pi Imager](https://www.raspberrypi.com/software/) herunter.
    2. Wählen Sie das Betriebssystem: **Raspberry Pi OS Lite (64-bit)**.
    3. Konfigurieren Sie im Einstellungsdialog vorab:
       - Hostname: `gateway-host`
       - SSH aktivieren
       - Benutzername und Passwort festlegen
       - WLAN konfigurieren (wenn Sie kein Ethernet verwenden)
    4. Flashen Sie auf Ihre SD-Karte oder Ihr USB-Laufwerk, setzen Sie es ein und starten Sie den Pi.

  </Step>

  <Step title="Per SSH verbinden">
    ```bash
    ssh user@gateway-host
    ```
  </Step>

  <Step title="System aktualisieren">
    ```bash
    sudo apt update && sudo apt upgrade -y
    sudo apt install -y git curl build-essential

    # Set timezone (important for cron and reminders)
    sudo timedatectl set-timezone America/Chicago
    ```

  </Step>

  <Step title="Node.js 24 installieren">
    ```bash
    curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
    sudo apt install -y nodejs
    node --version
    ```
  </Step>

  <Step title="Swap hinzufügen (wichtig bei 2 GB oder weniger)">
    ```bash
    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

    # Reduce swappiness for low-RAM devices
    echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
    sudo sysctl -p
    ```

  </Step>

  <Step title="OpenClaw installieren">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Step>

  <Step title="Onboarding ausführen">
    ```bash
    openclaw onboard --install-daemon
    ```

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

  </Step>

  <Step title="Überprüfen">
    ```bash
    openclaw status
    systemctl --user status openclaw-gateway.service
    journalctl --user -u openclaw-gateway.service -f
    ```
  </Step>

  <Step title="Auf die Control UI zugreifen">
    Rufen Sie auf Ihrem Computer eine Dashboard-URL vom Pi ab:

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

    Erstellen Sie dann in einem anderen Terminal einen SSH-Tunnel:

    ```bash
    ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
    ```

    Öffnen Sie die ausgegebene URL in Ihrem lokalen Browser. Für dauerhaft aktiven Remote-Zugriff siehe [Tailscale-Integration](/de/gateway/tailscale).

  </Step>
</Steps>

## Leistungstipps

**Verwenden Sie eine USB-SSD** -- SD-Karten sind langsam und verschleißen. Eine USB-SSD verbessert die Leistung deutlich. Siehe den [Pi-USB-Boot-Leitfaden](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#usb-mass-storage-boot).

**Modul-Compile-Cache aktivieren** -- Beschleunigt wiederholte CLI-Aufrufe auf leistungsschwächeren Pi-Hosts:

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

**Speichernutzung reduzieren** -- Geben Sie bei Headless-Setups GPU-Speicher frei und deaktivieren Sie ungenutzte Dienste:

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

**systemd-Drop-in für stabile Neustarts** -- Wenn dieser Pi hauptsächlich OpenClaw ausführt, fügen Sie ein Service-Drop-in hinzu:

```bash
systemctl --user edit openclaw-gateway.service
```

```ini
[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 Lingering, damit der Benutzerdienst eine Abmeldung übersteht: `sudo loginctl enable-linger "$(whoami)"`.

## Empfohlene Modelleinrichtung

Da der Pi nur den Gateway ausführt, verwenden Sie cloudgehostete API-Modelle:

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

Führen Sie keine lokalen LLMs auf einem Pi aus — selbst kleine Modelle sind zu langsam, um nützlich zu sein. Lassen Sie Claude oder GPT die Modellarbeit übernehmen.

## Hinweise zu ARM-Binärdateien

Die meisten OpenClaw-Funktionen funktionieren auf ARM64 ohne Änderungen (Node.js, Telegram, WhatsApp/Baileys, Chromium). Die Binärdateien, für die gelegentlich ARM-Builds fehlen, sind typischerweise optionale Go/Rust-CLI-Tools, die von Skills ausgeliefert werden. Prüfen Sie die Release-Seite einer fehlenden Binärdatei auf `linux-arm64`- / `aarch64`-Artefakte, bevor Sie auf das Erstellen aus dem Quellcode zurückgreifen.

## Persistenz und Backups

Der OpenClaw-Zustand liegt unter:

- `~/.openclaw/` — `openclaw.json`, agentenspezifische `auth-profiles.json`, Kanal-/Provider-Zustand, Sitzungen.
- `~/.openclaw/workspace/` — Agenten-Workspace (SOUL.md, Speicher, Artefakte).

Diese überstehen Neustarts. Erstellen Sie einen portablen Snapshot mit:

```bash
openclaw backup create
```

Wenn Sie diese auf einer SSD speichern, verbessern sich sowohl Leistung als auch Lebensdauer im Vergleich zur SD-Karte.

## Fehlerbehebung

**Nicht genügend Arbeitsspeicher** -- Überprüfen Sie mit `free -h`, ob Swap aktiv ist. Deaktivieren Sie ungenutzte 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 CPU-Drosselung mit `vcgencmd get_throttled` (sollte `0x0` zurückgeben).

**Service startet nicht** -- Prüfen Sie die Logs mit `journalctl --user -u openclaw-gateway.service --no-pager -n 100` und führen Sie `openclaw doctor --non-interactive` aus. Wenn dies ein Headless-Pi ist, prüfen Sie außerdem, ob Lingering aktiviert ist: `sudo loginctl enable-linger "$(whoami)"`.

**ARM-Binärprobleme** -- Wenn ein Skill mit "exec format error" fehlschlägt, prüfen Sie, ob die Binärdatei einen ARM64-Build hat. Überprüfen Sie die Architektur mit `uname -m` (sollte `aarch64` anzeigen).

**WLAN-Verbindungsabbrüche** -- Deaktivieren Sie WLAN-Energieverwaltung: `sudo iwconfig wlan0 power off`.

## Nächste Schritte

- [Kanäle](/de/channels) -- Telegram, WhatsApp, Discord und weitere verbinden
- [Gateway-Konfiguration](/de/gateway/configuration) -- alle Konfigurationsoptionen
- [Aktualisieren](/de/install/updating) -- OpenClaw aktuell halten

## Verwandte Themen

- [Installationsübersicht](/de/install)
- [Linux-Server](/de/vps)
- [Plattformen](/de/platforms)