Raspberry Pi

Voer een permanente, altijd actieve OpenClaw Gateway uit op een Raspberry Pi. Omdat de Pi alleen de gateway is (modellen worden via een API in de cloud uitgevoerd), kan zelfs een bescheiden Pi de werklast goed aan — de typische hardwarekosten zijn eenmalig $35-80, zonder maandelijkse kosten.

Hardwarecompatibiliteit

Pi-model	RAM	Werkt?	Opmerkingen
Pi 5	4/8 GB	Uitstekend	Snelst, aanbevolen.
Pi 4	4 GB	Goed	Ideale keuze voor de meeste gebruikers.
Pi 4	2 GB	Redelijk	Voeg swap toe.
Pi 4	1 GB	Krap	Mogelijk met swap en minimale configuratie.
Pi 3B+	1 GB	Traag	Werkt, maar is langzaam.
Pi Zero 2 W	512 MB	Nee	Niet aanbevolen.

Minimum: 1 GB RAM, 1 core, 500 MB vrije schijfruimte, 64-bits besturingssysteem. Aanbevolen: 2 GB+ RAM, SD-kaart van 16 GB+ (of USB-SSD), Ethernet.

Vereisten

Raspberry Pi 4 of 5 met 2 GB+ RAM (4 GB aanbevolen)
MicroSD-kaart (16 GB+) of USB-SSD (betere prestaties)
Officiële Pi-voeding
Netwerkverbinding (Ethernet of wifi)
64-bits Raspberry Pi OS (vereist — gebruik geen 32-bits versie)
Ongeveer 30 minuten

Installatie

Het besturingssysteem flashen

Gebruik Raspberry Pi OS Lite (64-bit) — voor een headless server is geen desktop nodig.

Download Raspberry Pi Imager.
Kies als besturingssysteem: Raspberry Pi OS Lite (64-bit).
Configureer vooraf in het instellingendialoogvenster:
- Hostnaam: gateway-host
- Schakel SSH in
- Stel een gebruikersnaam en wachtwoord in
- Configureer wifi (als je geen Ethernet gebruikt)
Flash je SD-kaart of USB-schijf, plaats deze en start de Pi op.

Verbinding maken via SSH

ssh user@gateway-host

Het systeem bijwerken

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

# Stel de tijdzone in (belangrijk voor cron en herinneringen)
sudo timedatectl set-timezone America/Chicago

Node.js 24 installeren

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

Swap toevoegen (belangrijk bij 2 GB of minder)

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

# Verminder swappiness voor apparaten met weinig RAM
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

OpenClaw installeren

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

Onboarding uitvoeren

openclaw onboard --install-daemon

Volg de wizard. Voor headless apparaten worden API-sleutels aanbevolen in plaats van OAuth. Telegram is het eenvoudigste kanaal om mee te beginnen.

Verifiëren

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

Toegang tot de bedieningsinterface

Haal op je computer een dashboard-URL op van de Pi:

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

Maak vervolgens in een andere terminal een SSH-tunnel:

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

Open de weergegeven URL in je lokale browser. Zie Tailscale-integratie voor permanente externe toegang.

Prestatietips

Gebruik een USB-SSD — SD-kaarten zijn traag en slijten. Een USB-SSD verbetert de prestaties aanzienlijk en doorstaat meer schrijfcycli; gebruik deze voor OPENCLAW_STATE_DIR als je het besturingssysteem op de SD-kaart laat staan. Zie de Pi-handleiding voor opstarten via USB. Schakel de compilatiecache voor modules in — Versnelt herhaalde CLI-aanroepen op minder krachtige Pi-hosts. OPENCLAW_NO_RESPAWN=1 houdt routinematige herstarts van de Gateway binnen hetzelfde proces, voorkomt extra procesoverdrachten en houdt PID-tracking eenvoudig op kleine 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

Gebruik /var/tmp, niet /tmp — sommige distributies wissen /tmp tijdens het opstarten, waardoor de opgewarmde cache verloren gaat. Verminder het geheugengebruik — Maak voor headless installaties GPU-geheugen vrij en schakel ongebruikte services uit:

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

systemd-drop-in voor stabiele herstarts — Als deze Pi voornamelijk OpenClaw uitvoert, voeg je een service-drop-in toe:

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

Voer vervolgens systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service uit. Schakel op een headless Pi ook eenmaal lingering in, zodat de gebruikersservice na het afmelden actief blijft: sudo loginctl enable-linger "$(whoami)".

Aanbevolen modelconfiguratie

Omdat de Pi alleen de gateway uitvoert, gebruik je via de cloud gehoste API-modellen — voer geen lokale LLM’s uit op een Pi; zelfs kleine modellen zijn te traag om bruikbaar te zijn:

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

Opmerkingen over ARM-binaire bestanden

De meeste OpenClaw-functies werken zonder wijzigingen op ARM64 (Node.js, Telegram, WhatsApp/Baileys, Chromium). De binaire bestanden waarvoor soms geen ARM-build beschikbaar is, zijn doorgaans optionele Go/Rust-CLI-tools die door skills worden meegeleverd. Controleer de architectuur met uname -m (dit moet aarch64 weergeven) en controleer vervolgens de releasepagina van een ontbrekend binair bestand op linux-arm64- / aarch64-artefacten voordat je terugvalt op compileren vanuit de broncode.

Persistentie en back-ups

De OpenClaw-status bevindt zich onder:

~/.openclaw/ — openclaw.json, auth-profiles.json per agent, kanaal-/providerstatus, sessies.
~/.openclaw/workspace/ — agentwerkruimte (SOUL.md, geheugen, artefacten).

Deze blijven na herstarts behouden en profiteren voor zowel prestaties als levensduur van een SSD in plaats van een SD-kaart. Maak een overdraagbare momentopname met:

openclaw backup create

Problemen oplossen

Onvoldoende geheugen — Controleer met free -h of swap actief is. Schakel ongebruikte services uit (sudo systemctl disable cups bluetooth avahi-daemon). Gebruik uitsluitend API-gebaseerde modellen. Trage prestaties — Gebruik een USB-SSD in plaats van een SD-kaart. Controleer met vcgencmd get_throttled op CPU-throttling (dit moet 0x0 retourneren). Service start niet — Controleer de logboeken met journalctl --user -u openclaw-gateway.service --no-pager -n 100 en voer openclaw doctor --non-interactive uit. Controleer bij een headless Pi ook of lingering is ingeschakeld: sudo loginctl enable-linger "$(whoami)". Problemen met ARM-binaire bestanden — Als een skill mislukt met “exec format error”, controleer dan of er een ARM64-build van het binaire bestand bestaat. Controleer de architectuur met uname -m (dit moet aarch64 weergeven). Wifi-verbinding valt weg — Schakel energiebeheer voor wifi uit: sudo iwconfig wlan0 power off.

Volgende stappen

Kanalen — verbind Telegram, WhatsApp, Discord en meer
Gateway-configuratie — alle configuratieopties
Bijwerken — houd OpenClaw up-to-date

Install overview

Maintenance

Containers

Hosting

Advanced setup

Hardwarecompatibiliteit

Vereisten

Installatie

Prestatietips

Aanbevolen modelconfiguratie

Opmerkingen over ARM-binaire bestanden

Persistentie en back-ups

Problemen oplossen

Volgende stappen

Gerelateerd

​Hardwarecompatibiliteit

​Vereisten

​Installatie

​Prestatietips

​Aanbevolen modelconfiguratie

​Opmerkingen over ARM-binaire bestanden

​Persistentie en back-ups

​Problemen oplossen

​Volgende stappen

​Gerelateerd

Hardwarecompatibiliteit

Vereisten

Installatie

Prestatietips

Aanbevolen modelconfiguratie

Opmerkingen over ARM-binaire bestanden

Persistentie en back-ups

Problemen oplossen

Volgende stappen

Gerelateerd