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

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 # Stel de tijdzone in (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 # Verminder swappiness 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 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 secretexport NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cachemkdir -p /var/tmp/openclaw-compile-cacheexport OPENCLAW_NO_RESPAWN=1EOFsource ~/.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.txtsudo 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=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 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

Gerelateerd

• Installatieoverzicht
• Linux-server
• Platformen