Raspberry Pi

Esegui un Gateway OpenClaw persistente e sempre attivo su un Raspberry Pi. Poiché il Pi è solo il gateway (i modelli vengono eseguiti nel cloud tramite API), anche un Pi modesto gestisce bene il carico di lavoro: il costo hardware tipico è 35–80 $ una tantum, senza costi mensili.

Compatibilità hardware

Minimo: 1 GB di RAM, 1 core, 500 MB di disco libero, sistema operativo a 64 bit. Consigliato: 2 GB+ di RAM, scheda SD da 16 GB+ (o SSD USB), Ethernet.

Prerequisiti

• Raspberry Pi 4 o 5 con 2 GB+ di RAM (4 GB consigliati)
• Scheda MicroSD (16 GB+) o SSD USB (prestazioni migliori)
• Alimentatore ufficiale Pi
• Connessione di rete (Ethernet o WiFi)
• Raspberry Pi OS a 64 bit (obbligatorio -- non usare la versione a 32 bit)
• Circa 30 minuti

Configurazione

ssh user@gateway-host

sudo apt update && sudo apt upgrade -ysudo apt install -y git curl build-essential # Set timezone (important for cron and reminders)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 # Reduce swappiness for low-RAM devicesecho '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

Suggerimenti per le prestazioni

Usa un SSD USB -- Le schede SD sono lente e si usurano. Un SSD USB migliora drasticamente le prestazioni. Consulta la guida all'avvio da USB per Pi.

Abilita la cache di compilazione dei moduli -- Velocizza le invocazioni ripetute della CLI sugli host Pi a bassa potenza:

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

Riduci l'uso di memoria -- Per configurazioni headless, libera memoria GPU e disabilita i servizi inutilizzati:

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

Drop-in systemd per riavvii stabili -- Se questo Pi esegue principalmente OpenClaw, aggiungi un drop-in del servizio:

systemctl --user edit openclaw-gateway.service

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

Poi systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. Su un Pi headless, abilita anche il lingering una volta, così il servizio utente sopravvive al logout: sudo loginctl enable-linger "$(whoami)".

Configurazione modello consigliata

Poiché il Pi esegue solo il Gateway, usa modelli API ospitati nel cloud:

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

Non eseguire LLM locali su un Pi: anche i modelli piccoli sono troppo lenti per essere utili. Lascia che Claude o GPT gestiscano il lavoro del modello.

Note sui binari ARM

La maggior parte delle funzionalità OpenClaw funziona su ARM64 senza modifiche (Node.js, Telegram, WhatsApp/Baileys, Chromium). I binari che occasionalmente non hanno build ARM sono di solito strumenti CLI Go/Rust opzionali distribuiti dagli skills. Verifica nella pagina di rilascio di un binario mancante la presenza di artefatti linux-arm64 / aarch64 prima di ripiegare sulla compilazione dal sorgente.

Persistenza e backup

Lo stato di OpenClaw si trova in:

• ~/.openclaw/ — openclaw.json, auth-profiles.json per agente, stato di canali/provider, sessioni.
• ~/.openclaw/workspace/ — workspace dell'agente (SOUL.md, memoria, artefatti).

Questi dati sopravvivono ai riavvii. Crea uno snapshot portabile con:

openclaw backup create

Se li tieni su un SSD, migliorano sia le prestazioni sia la durata rispetto alla scheda SD.

Risoluzione dei problemi

Memoria esaurita -- Verifica che lo swap sia attivo con free -h. Disabilita i servizi inutilizzati (sudo systemctl disable cups bluetooth avahi-daemon). Usa solo modelli basati su API.

Prestazioni lente -- Usa un SSD USB invece di una scheda SD. Controlla il throttling della CPU con vcgencmd get_throttled (dovrebbe restituire 0x0).

Il servizio non si avvia -- Controlla i log con journalctl --user -u openclaw-gateway.service --no-pager -n 100 ed esegui openclaw doctor --non-interactive. Se è un Pi headless, verifica anche che il lingering sia abilitato: sudo loginctl enable-linger "$(whoami)".

Problemi con i binari ARM -- Se una skill fallisce con "exec format error", controlla se il binario ha una build ARM64. Verifica l'architettura con uname -m (dovrebbe mostrare aarch64).

Interruzioni del WiFi -- Disabilita la gestione energetica del WiFi: sudo iwconfig wlan0 power off.

Passaggi successivi

• Canali -- collega Telegram, WhatsApp, Discord e altro
• Configurazione Gateway -- tutte le opzioni di configurazione
• Aggiornamento -- mantieni OpenClaw aggiornato

Correlati

• Panoramica dell'installazione
• Server Linux
• Piattaforme