Aller au contenu
OpenClaw Docs

Raspberry Pi

Raspberry Pi

Section intitulée « Raspberry Pi »

Exécutez une passerelle OpenClaw persistante et toujours active sur un Gateway. Puisque le Pi n’est que la passerelle (les modèles s’exécutent dans le cloud via Raspberry Pi), même un Pi modeste gère bien la charge de travail.

Prérequis

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

Configuration

Section intitulée « Configuration »

  1. Flasher le système d'exploitation

    Utilisez Raspberry Pi OS Lite (64-bit) — aucun bureau n’est nécessaire pour un serveur sans interface graphique.

    1. Téléchargez Raspberry Pi Imager.
    2. Choisissez le système d’exploitation : Raspberry Pi OS Lite (64-bit).
    3. Dans la boîte de dialogue des paramètres, préconfigurez :
      • Nom d’hôte : gateway-host
      • Activer SSH
      • Définir le nom d’utilisateur et le mot de passe
      • Configurer le WiFi (si vous n’utilisez pas Ethernet)
    4. Flashez sur votre carte SD ou votre clé USB, insérez-la et démarrez le Pi.

  2. Connecter via SSH

    bash ssh user@gateway-host

  3. Mettre à jour le système

    Fenêtre de terminal
    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

  4. Installer Node.js 24

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

  5. Ajouter de la mémoire d'échange (important pour 2 Go ou moins)

    Fenêtre de terminal
    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

  6. Installer OpenClaw

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

  7. Exécuter l'intégration

    Fenêtre de terminal
    openclaw onboard --install-daemon

    Suivez l’assistant. Les clés API sont recommandées plutôt que OAuth pour les appareils sans interface graphique. Telegram est le canal le plus simple pour commencer.

  8. Vérifier

    bash openclaw status sudo systemctl status openclaw journalctl -u openclaw -f

  9. Accéder à l'interface de contrôle

    Sur votre ordinateur, obtenez une URL du tableau de bord depuis le Pi :

    Fenêtre de terminal
    ssh user@gateway-host 'openclaw dashboard --no-open'

    Créez ensuite un tunnel SSH dans un autre terminal :

    Fenêtre de terminal
    ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

    Ouvrez l’URL affichée dans votre navigateur local. Pour un accès distant permanent, consultez l’intégration Tailscale.

Conseils de performance

Section intitulée « Conseils de performance »

Utiliser un SSD USB — Les cartes SD sont lentes et s’usent. Un SSD USB améliore considérablement les performances. Consultez le guide de démarrage USB du Pi.

Activer le cache de compilation des modules — Accélère les appels répétés de la CLI sur les Pi peu puissants :

Fenêtre de terminal
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

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

Fenêtre de terminal
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth

Dépannage

Section intitulée « Dépannage »

Mémoire insuffisante — Vérifiez que le swap est actif 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 le throttling du CPU avec vcgencmd get_throttled (devrait retourner 0x0).

Le service ne démarre pas — Vérifiez les journaux avec journalctl -u openclaw --no-pager -n 100 et exécutez openclaw doctor --non-interactive.

Problèmes de binaire ARM — Si une compétence échoue avec “exec format error”, vérifiez si le binaire possède une version ARM64. Vérifiez l’architecture avec uname -m (devrait afficher aarch64).

Déconnexions WiFi — Désactivez la gestion de l’énergie WiFi : sudo iwconfig wlan0 power off.

Étapes suivantes

Section intitulée « Étapes suivantes »