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 gebruikelijke hardwarekosten bedragen eenmalig $35-80, zonder maandelijkse kosten.

Hardwarecompatibiliteit

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

ssh user@gateway-host

sudo apt update && sudo apt upgrade -ysudo apt install -y git curl build-essential # Tijdzone instellen (belangrijk voor cron en herinneringen)sudo timedatectl set-timezone America/Chicago

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

sudo fallocate -l 2G /swapfilesudo chmod 600 /swapfilesudo mkswap /swapfilesudo swapon /swapfileecho '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab # Swappiness verlagen voor apparaten met weinig RAMecho 'vm.swappiness=10' | sudo tee -a /etc/sysctl.confsudo sysctl -p

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

openclaw onboard --install-daemon

openclaw statussystemctl --user status openclaw-gateway.servicejournalctl --user -u openclaw-gateway.service -f

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

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

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 handleiding voor het opstarten van de Pi via USB.

Schakel de compileercache voor modules in — Dit versnelt herhaalde CLI-aanroepen op minder krachtige Pi-hosts. OPENCLAW_NO_RESPAWN=1 zorgt ervoor dat normale herstarts van de Gateway binnen hetzelfde proces plaatsvinden, waardoor extra procesoverdrachten worden vermeden en PID-tracering op kleine hosts eenvoudig blijft:

grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secretexport NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cachemkdir -p /var/tmp/openclaw-compile-cacheexport OPENCLAW_NO_RESPAWN=1EOFsource ~/.bashrc

Gebruik /var/tmp en 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.txtsudo systemctl disable bluetooth

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

systemctl --user edit openclaw-gateway.service

[Service]Environment=OPENCLAW_NO_RESPAWN=1Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cacheRestart=alwaysRestartSec=2TimeoutStartSec=90

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

Aanbevolen modelconfiguratie

Omdat de Pi alleen de Gateway uitvoert, moet je API-modellen uit de cloud gebruiken — 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 functies van OpenClaw werken zonder wijzigingen op ARM64 (Node.js, Telegram, WhatsApp/Baileys, Chromium). De binaire bestanden waarvoor soms geen ARM-build beschikbaar is, zijn doorgaans optionele CLI-hulpprogramma's in Go of Rust die door Skills worden meegeleverd. Controleer de architectuur met uname -m (dit moet aarch64 weergeven) en controleer vervolgens op de releasepagina van een ontbrekend binair bestand of er linux-arm64- of aarch64-artefacten beschikbaar zijn voordat je terugvalt op compileren vanuit de broncode.

Persistentie en back-ups

De statusgegevens van OpenClaw bevinden zich in:

• ~/.openclaw/ — openclaw.json, auth-profiles.json per agent, kanaal- en providerstatus, sessies.
• ~/.openclaw/workspace/ — werkruimte van de agent (SOUL.md, geheugen, artefacten).

Deze gegevens blijven na herstarts behouden en profiteren zowel qua 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-begrenzing (dit moet 0x0 retourneren).

De 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

Gerelateerd

• Installatieoverzicht
• Linux-server
• Platformen