Raspberry Pi

Exécutez un Gateway OpenClaw persistant et toujours actif sur un Raspberry Pi. Comme le Pi n’est que le Gateway (les modèles s’exécutent dans le cloud via API), même un Pi modeste gère bien la charge de travail — le coût matériel typique est de 35 à 80 $ en une seule fois, sans frais mensuels.

Compatibilité matérielle

Minimum : 1 Go de RAM, 1 cœur, 500 Mo d’espace disque libre, OS 64 bits. Recommandé : 2 Go+ de RAM, carte SD 16 Go+ (ou SSD USB), Ethernet.

Prérequis

• Raspberry Pi 4 ou 5 avec 2 Go+ de RAM (4 Go recommandés)
• Carte microSD (16 Go+) ou SSD USB (meilleures performances)
• Alimentation officielle Pi
• Connexion réseau (Ethernet ou WiFi)
• Raspberry Pi OS 64 bits (requis -- n’utilisez pas la version 32 bits)
• Environ 30 minutes

Configuration

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

Conseils de performance

Utilisez un SSD USB -- Les cartes SD sont lentes et s’usent. Un SSD USB améliore nettement les performances. Consultez le guide de démarrage USB du Pi.

Activez le cache de compilation des modules -- Accélère les invocations répétées de la CLI sur les hôtes Pi moins puissants :

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

OPENCLAW_NO_RESPAWN=1 conserve les redémarrages courants du Gateway dans le même processus, ce qui évite des transferts de processus supplémentaires et simplifie le suivi du PID sur les petits hôtes.

Réduisez l’utilisation de la mémoire -- Pour les configurations sans écran, libérez la mémoire GPU et désactivez les services inutilisés :

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

Drop-in systemd pour des redémarrages stables -- Si ce Pi exécute principalement OpenClaw, ajoutez un drop-in de service :

systemctl --user edit openclaw-gateway.service

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

Exécutez ensuite systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. Sur un Pi sans écran, activez aussi lingering une fois afin que le service utilisateur survive à la déconnexion : sudo loginctl enable-linger "$(whoami)".

Configuration de modèle recommandée

Comme le Pi n’exécute que le Gateway, utilisez des modèles API hébergés dans le cloud :

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

N’exécutez pas de LLM locaux sur un Pi — même les petits modèles sont trop lents pour être utiles. Laissez Claude ou GPT effectuer le travail de modèle.

Notes sur les binaires ARM

La plupart des fonctionnalités OpenClaw fonctionnent sur ARM64 sans modification (Node.js, Telegram, WhatsApp/Baileys, Chromium). Les binaires qui manquent parfois de builds ARM sont généralement des outils CLI Go/Rust facultatifs fournis par les Skills. Vérifiez la page de publication d’un binaire manquant pour des artefacts linux-arm64 / aarch64 avant de vous rabattre sur une compilation depuis la source.

Persistance et sauvegardes

L’état OpenClaw se trouve sous :

• ~/.openclaw/ — openclaw.json, auth-profiles.json par agent, état des canaux/fournisseurs, sessions.
• ~/.openclaw/workspace/ — espace de travail de l’agent (SOUL.md, mémoire, artefacts).

Ces données survivent aux redémarrages. Créez un instantané portable avec :

openclaw backup create

Si vous les conservez sur un SSD, les performances comme la longévité s’améliorent par rapport à une carte SD.

Dépannage

Mémoire insuffisante -- Vérifiez que la swap est active avec free -h. Désactivez les services inutilisés (sudo systemctl disable cups bluetooth avahi-daemon). Utilisez uniquement des modèles basés sur API.

Performances lentes -- Utilisez un SSD USB au lieu d’une carte SD. Vérifiez l’étranglement CPU avec vcgencmd get_throttled (devrait retourner 0x0).

Le service ne démarre pas -- Consultez les journaux avec journalctl --user -u openclaw-gateway.service --no-pager -n 100 et exécutez openclaw doctor --non-interactive. S’il s’agit d’un Pi sans écran, vérifiez aussi que lingering est activé : sudo loginctl enable-linger "$(whoami)".

Problèmes de binaires ARM -- Si un Skill échoue avec « exec format error », vérifiez si le binaire dispose d’un build ARM64. Vérifiez l’architecture avec uname -m (devrait afficher aarch64).

Coupures WiFi -- Désactivez la gestion de l’alimentation WiFi : sudo iwconfig wlan0 power off.

Étapes suivantes

• Canaux -- connectez Telegram, WhatsApp, Discord et plus encore
• Configuration du Gateway -- toutes les options de configuration
• Mise à jour -- gardez OpenClaw à jour

Liens associés

• Vue d’ensemble de l’installation
• Serveur Linux
• Plateformes