OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

Raspberry Pi

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

Compatibilità hardware

Modello Pi RAM Funziona? Note
Pi 5 4/8 GB Ottimo Il più veloce, consigliato.
Pi 4 4 GB Buono La soluzione ideale per la maggior parte degli utenti.
Pi 4 2 GB Adeguato Aggiungere lo spazio di swap.
Pi 4 1 GB Limitato Possibile con swap e configurazione minima.
Pi 3B+ 1 GB Lento Funziona, ma con scarsa reattività.
Pi Zero 2 W 512 MB No Non consigliato.

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

Prerequisiti

  • Raspberry Pi 4 o 5 con almeno 2 GB di RAM (consigliati 4 GB)
  • Scheda microSD (almeno 16 GB) oppure SSD USB (prestazioni migliori)
  • Alimentatore ufficiale per Pi
  • Connessione di rete (Ethernet o WiFi)
  • Raspberry Pi OS a 64 bit (obbligatorio: non utilizzare la versione a 32 bit)
  • Circa 30 minuti

Configurazione

  • Installare il sistema operativo

    Utilizza Raspberry Pi OS Lite (64-bit): per un server senza monitor non è necessario un ambiente desktop.

    1. Scarica Raspberry Pi Imager.
    2. Scegli il sistema operativo: Raspberry Pi OS Lite (64-bit).
    3. Nella finestra delle impostazioni, configura in anticipo:
      • Hostname: gateway-host
      • Enable SSH
      • Set username and password
      • Configure WiFi (se non utilizzi Ethernet)
    4. Scrivi l'immagine sulla scheda SD o sull'unità USB, inseriscila e avvia il Pi.

  • Connettersi tramite SSH

    bash
    ssh user@gateway-host

  • Aggiornare il sistema

    bash
    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

  • Installare Node.js 24

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

  • Aggiungere lo spazio di swap (importante con 2 GB o meno)

    bash
    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

  • Installare OpenClaw

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

  • Eseguire la configurazione iniziale

    bash
    openclaw onboard --install-daemon

    Segui la procedura guidata. Per i dispositivi senza monitor sono consigliate le chiavi API anziché OAuth. Telegram è il canale più semplice con cui iniziare.

  • Verificare

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

  • Accedere all'interfaccia di controllo

    Sul computer, ottieni dal Pi l'URL della dashboard:

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

    Quindi crea un tunnel SSH in un altro terminale:

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

    Apri l'URL visualizzato nel browser locale. Per un accesso remoto sempre disponibile, consulta l'integrazione con Tailscale.

    • Suggerimenti per le prestazioni

    Utilizza un SSD USB: le schede SD sono lente e si usurano. Un SSD USB migliora notevolmente le prestazioni e sopporta più cicli di scrittura; utilizzalo per OPENCLAW_STATE_DIR se mantieni il sistema operativo sulla scheda SD. Consulta la guida all'avvio da USB del Pi.

    Abilita la cache di compilazione dei moduli: velocizza le invocazioni ripetute della CLI sui Pi meno potenti. OPENCLAW_NO_RESPAWN=1 mantiene nello stesso processo i normali riavvii del Gateway, evitando ulteriori passaggi tra processi e semplificando il monitoraggio del PID sui dispositivi meno potenti:

    bash
    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

    Utilizza /var/tmp, non /tmp: alcune distribuzioni svuotano /tmp all'avvio, eliminando la cache già preparata.

    Riduci l'utilizzo della memoria: per le configurazioni senza monitor, libera la memoria della GPU e disabilita i servizi inutilizzati:

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

    Configurazione aggiuntiva di systemd per riavvii affidabili: se questo Pi viene utilizzato principalmente per eseguire OpenClaw, aggiungi una configurazione aggiuntiva al servizio:

    bash
    systemctl --user edit openclaw-gateway.service
    ini
    [Service]Environment=OPENCLAW_NO_RESPAWN=1Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cacheRestart=alwaysRestartSec=2TimeoutStartSec=90

    Quindi esegui systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. Su un Pi senza monitor, abilita inoltre una volta la persistenza della sessione utente affinché il servizio continui a funzionare dopo la disconnessione: sudo loginctl enable-linger "$(whoami)".

    Configurazione consigliata dei modelli

    Poiché il Pi esegue solo il Gateway, utilizza modelli API ospitati nel cloud; non eseguire LLM locali su un Pi, perché anche i modelli più piccoli sono troppo lenti per risultare utili:

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

    Note sui file binari ARM

    La maggior parte delle funzionalità di OpenClaw opera su ARM64 senza modifiche (Node.js, Telegram, WhatsApp/Baileys, Chromium). I file binari per cui talvolta non sono disponibili build ARM sono in genere strumenti CLI Go/Rust facoltativi distribuiti tramite Skills. Verifica l'architettura con uname -m (dovrebbe mostrare aarch64), quindi controlla nella pagina delle versioni del file binario mancante la presenza di artefatti linux-arm64 / aarch64 prima di ricorrere alla compilazione dal codice sorgente.

    Persistenza e backup

    Lo stato di OpenClaw si trova in:

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

    Questi dati persistono dopo i riavvii e traggono vantaggio dall'uso di un SSD anziché di una scheda SD, sia in termini di prestazioni sia di durata. Crea un'istantanea portabile con:

    bash
    openclaw backup create

    Risoluzione dei problemi

    Memoria insufficiente: verifica che lo swap sia attivo con free -h. Disabilita i servizi inutilizzati (sudo systemctl disable cups bluetooth avahi-daemon). Utilizza esclusivamente modelli basati su API.

    Prestazioni lente: utilizza un SSD USB anziché una scheda SD. Controlla la limitazione della frequenza della CPU con vcgencmd get_throttled (dovrebbe restituire 0x0).

    Il servizio non si avvia: controlla i registri con journalctl --user -u openclaw-gateway.service --no-pager -n 100 ed esegui openclaw doctor --non-interactive. Se si tratta di un Pi senza monitor, verifica inoltre che la persistenza della sessione utente sia abilitata: sudo loginctl enable-linger "$(whoami)".

    Problemi con i file binari ARM: se una Skill non riesce a essere eseguita e restituisce "exec format error", controlla se è disponibile una build ARM64 del file binario. Verifica l'architettura con uname -m (dovrebbe mostrare aarch64).

    Disconnessioni WiFi: disabilita la gestione energetica del WiFi: sudo iwconfig wlan0 power off.

    Passaggi successivi

    Contenuti correlati

    Was this useful?
    On this page

    On this page