Accueil › OpenClaw › Raspberry Pi

OpenClaw sur Raspberry Pi : un assistant IA 24/7 pour moins de 100 €

Le Raspberry Pi est l’une des façons les plus économiques de faire tourner OpenClaw en continu. Pour un investissement matériel unique de 60 à 100 € et environ 1 €/mois d’électricité, vous obtenez un assistant IA personnel disponible 24/7, silencieux, compact et totalement privé. Le Pi sert uniquement de Gateway : le traitement LLM se fait dans le cloud (Claude, GPT), donc même un Pi 4 avec 4 Go de RAM gère la charge confortablement.

Pourquoi un Raspberry Pi pour OpenClaw

Le Raspberry Pi coche toutes les cases pour un agent IA personnel toujours actif.

Coût quasi nul. Après l’achat initial du matériel (60-100 €), les seuls coûts récurrents sont l’électricité (~1 €/mois) et les tokens API du fournisseur LLM (20-50 $/mois avec Claude Sonnet). Pas de facture cloud mensuelle pour l’hébergement.

Toujours allumé. Le Pi est conçu pour tourner 24/7 sans bruit, sans ventilateur (avec refroidissement passif), dans un coin de votre bureau ou de votre armoire réseau. Pas de laptop à laisser ouvert, pas de desktop à maintenir éveillé.

Confidentialité. Vos clés API, conversations, mémoire et données d’agent restent sur votre réseau local. Seuls les appels API vers le fournisseur LLM quittent votre réseau.

Isolation de sécurité. Comme le recommande la documentation officielle, faire tourner OpenClaw sur un appareil dédié (plutôt que sur votre machine de travail) isole les risques. Si l’agent est compromis, vos fichiers personnels, emails et credentials ne sont pas exposés.

Choix du matériel

Le Pi 5 avec 8 Go est le modèle testé et validé par l’équipe Adafruit et la communauté. Le Pi 4 avec 4 Go fonctionne bien pour un agent unique avec des skills légères. En dessous de 4 Go, vous toucherez le swap régulièrement, ce qui use la carte SD et ralentit les réponses.

Installation pas à pas

Étape 1 : Préparer l’OS

Utilisez Raspberry Pi OS Lite 64-bit. Pas besoin de bureau graphique pour un serveur headless. L’image Lite économise de la RAM et du CPU pour OpenClaw.

# Flashez avec Raspberry Pi Imager
# Choisissez : Raspberry Pi OS Lite (64-bit)
# Configurez SSH, WiFi et hostname dans les options avancées
# Insérez la SD/SSD et démarrez le Pi

Après le premier boot, mettez à jour le système et configurez le fuseau horaire (important pour les cron jobs et les rappels) :

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential
sudo timedatectl set-timezone Europe/Paris

Étape 2 : Installer Node.js 22+

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

# Vérifier
node --version   # Doit afficher v24.x.x
npm --version

Étape 3 : Configurer le swap

Le swap est essentiel sur les Pi avec 2-4 Go de RAM. Il évite les OOM kills pendant les pics d’utilisation.

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Rendre permanent
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Optimiser pour la RAM limitée (réduire le swappiness)
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

Étape 4 : Installer OpenClaw

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

Le script détecte automatiquement l’architecture ARM64 et installe la version appropriée. Le processus prend 1 à 2 minutes sur Pi 5. Si openclaw n’est pas trouvé après l’installation, lancez exec $SHELL -l pour recharger votre session shell.

Suivez ensuite le wizard d’onboarding (voir le guide d’installation pour le détail des étapes).

Étape 5 : Configurer le service système

# Démarrer le Gateway et l'installer comme service
openclaw gateway start
openclaw gateway install

# Vérifier le status
openclaw gateway status

# Le service redémarre automatiquement après chaque reboot

Le flag --install-daemon du wizard configure automatiquement un service systemd. Si vous l’avez sauté, openclaw gateway install le fait manuellement.

Choix du modèle LLM sur Pi

Le Pi est le Gateway, pas le cerveau. Les modèles LLM tournent dans le cloud via API. N’essayez pas de faire tourner des modèles locaux via Ollama sur le Pi : même les petits modèles sont trop lents sur l’architecture ARM du Pi sans GPU dédié.

Pour un usage sur Pi, privilégiez les modèles cloud économiques qui offrent un bon rapport qualité/coût :

Configurez un fallback pour la résilience : Claude Sonnet en primaire, GPT-4o-mini en fallback.

Connecter un canal de messagerie

Telegram est le canal le plus populaire et le plus simple pour OpenClaw sur Pi. Pas de webhook à exposer (long-polling), pas de QR code à scanner sur un écran (le Pi est headless), juste un token de bot à coller.

# Ajouter Telegram
openclaw channels add --channel telegram --token "VOTRE_TOKEN_BOT"

# Vérifier
openclaw channels list

WhatsApp est aussi supporté mais nécessite un scan QR code (depuis un autre appareil connecté au même réseau) et une session persistante plus fragile. Pour un premier setup sur Pi, Telegram est recommandé.

Optimisation des performances

SSD USB plutôt que carte SD

C’est la meilleure amélioration de performance possible. Les cartes SD ont une endurance d’écriture limitée et des I/O aléatoires lents. OpenClaw écrit constamment dans les fichiers de mémoire, les logs et l’historique de conversation. Un SSD NVMe via un M.2 HAT+ (ou un SSD USB 3.0) apporte 3 à 5x plus de performance et élimine le risque de corruption SD.

Désactiver les services inutiles

# Libérer de la RAM en désactivant les services non nécessaires
sudo systemctl disable cups bluetooth avahi-daemon

# Vérifier la RAM disponible
free -h

Surveiller le throttling

# Vérifier si le CPU est throttlé (doit retourner 0x0)
vcgencmd get_throttled

# Si non-zéro : problème d'alimentation ou de température

Stabilité WiFi

Si le Pi se déconnecte du WiFi de manière intermittente, désactivez la gestion d’énergie WiFi :

sudo iwconfig wlan0 power off

Pour une stabilité maximale, préférez une connexion Ethernet filaire.

Cas d’usage : ce que font les gens avec OpenClaw sur Pi

Le blog officiel Raspberry Pi a documenté un cas concret : un développeur a créé un photo booth de mariage en connectant OpenClaw sur un Pi 5 à un second Pi avec une caméra. Il a conçu l’interface entièrement en langage naturel via des conversations avec OpenClaw, sans écrire une seule ligne de code.

D’autres usages populaires rapportés par la communauté : un assistant de recherche permanent qui surveille des sources web et compile des résumés quotidiens, un agent de monitoring de serveur domestique qui alerte via Telegram en cas de problème, un secrétaire email qui trie, résume et rédige des brouillons de réponses, et un contrôleur domotique qui gère les appareils Home Assistant via des commandes en langage naturel.

Le Pi est particulièrement adapté aux tâches de fond qui tournent sans intervention : cron jobs, monitoring, alertes proactives. La faible consommation électrique et le fonctionnement silencieux en font un serveur domestique idéal pour les automatisations qui doivent être « toujours là ».

Limites à connaître

Pas de modèles locaux. Le Pi n’a pas le GPU nécessaire pour faire tourner des LLM localement. Même un modèle 3B serait trop lent pour être utilisable. Vous dépendez des APIs cloud pour le traitement LLM.

Compatibilité ARM64. La plupart des fonctionnalités OpenClaw fonctionnent sur ARM64, mais certains binaires externes (utilisés par des skills) n’ont pas de build ARM. Si une skill échoue avec « exec format error », vérifiez que le binaire existe en version ARM64. Les outils Go et Rust ont généralement des builds ARM, d’autres non.

Docker limité. Docker fonctionne sur Pi 4/5, mais ajoute un overhead mémoire significatif. Sur un Pi 4 Go, l’installation native (sans Docker) est préférable. Docker devient viable avec 8 Go de RAM. Le build de l’image seul nécessite ~2 Go libres.

Agents multiples. Sur un Pi 5 avec 8 Go, vous pouvez confortablement faire tourner 2-3 agents. Au-delà, vous atteindrez les limites de RAM et de CPU.

Accès distant au Pi

Le Pi tourne chez vous, mais vous voulez contrôler votre agent depuis n’importe où. Trois approches.

Via les canaux de messagerie. C’est le chemin le plus naturel. Une fois Telegram ou WhatsApp connecté, vous contrôlez votre agent depuis votre téléphone partout dans le monde. Le canal de messagerie fait office d’interface distante sans aucune configuration réseau supplémentaire.

Via Tailscale. Tailscale crée un réseau VPN mesh qui connecte vos appareils entre eux de manière transparente. Installez Tailscale sur le Pi et sur votre laptop/téléphone, et vous pouvez accéder au dashboard OpenClaw (http://pi-tailscale-ip:18789) depuis n’importe où, comme si vous étiez sur le même réseau local. OpenClaw s’intègre nativement avec Tailscale Serve/Funnel pour exposer le Gateway de manière sécurisée.

Via SSH tunnel. La méthode classique pour les utilisateurs avancés. Un tunnel SSH (ssh -L 18789:localhost:18789 pi@votre-pi.local) redirige le port du dashboard vers votre machine locale. Fonctionne sans logiciel supplémentaire mais nécessite un accès SSH au Pi.

Ne jamais exposer le port 18789 directement sur internet sans authentification. Le dashboard sans protection est une porte d’entrée vers votre agent et, par extension, vers tout ce à quoi il a accès.

PicoClaw : l’alternative pour les Pi Zero

Si vous avez un Raspberry Pi Zero, Pi Zero 2 W, ou Pi 3 (matériel trop limité pour OpenClaw complet), le projet PicoClaw offre une alternative allégée. PicoClaw est un agent simplifié conçu pour s’exécuter sur du matériel minimal et accomplir des tâches locales. Il ne remplace pas OpenClaw mais couvre les cas d’usage IoT et domotique basiques sur des appareils très contraints en ressources.

Dépannage

Out of memory

Vérifiez que le swap est actif avec free -h. Si le swap n’est pas configuré, suivez l’étape 3 ci-dessus. Désactivez les services inutiles (cups, bluetooth, avahi-daemon). Utilisez uniquement des modèles cloud, pas de modèles locaux.

Performances lentes

Passez sur un SSD USB au lieu de la carte SD. Vérifiez le CPU throttling avec vcgencmd get_throttled (une valeur non-zéro indique un problème d’alimentation ou de température). Utilisez un modèle LLM léger (Haiku, GPT-4o-mini) pour des réponses plus rapides.

Le service ne démarre pas

Vérifiez les logs avec journalctl -u openclaw --no-pager -n 100. Lancez openclaw doctor --non-interactive pour un diagnostic. Les causes les plus fréquentes : clé API invalide, Node.js trop ancien, ou port 18789 déjà utilisé.

Erreur « exec format error » sur une skill

Le binaire requis par la skill n’a pas de build ARM64. Vérifiez l’architecture avec uname -m (doit afficher aarch64). Cherchez une version ARM64 du binaire, ou utilisez une skill alternative compatible ARM.

Questions fréquentes