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 -y
sudo 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 nodejs
node --version

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

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

openclaw onboard --install-daemon

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --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 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

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.txt
sudo 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=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=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